Registration Procedures for SOIF Template Types
RFC 2656

Document Type RFC - Experimental (August 1999; Errata)
Author Ted Hardie 
Last updated 2020-01-21
Stream IETF
Formats plain text html pdf htmlized with errata bibtex
Stream WG state (None)
Document shepherd No shepherd assigned
IESG IESG state RFC 2656 (Experimental)
Consensus Boilerplate Unknown
Telechat date
Responsible AD (None)
Send notices to (None)
Network Working Group                                           T. Hardie
Request For Comments: 2656                                        Equinix
Category: Experimental                                        August 1999

            Registration Procedures for SOIF Template Types

Status of this Memo

   This memo defines an Experimental Protocol for the Internet
   community.  It does not specify an Internet standard of any kind.
   Discussion and suggestions for improvement are requested.
   Distribution of this memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (1999).  All Rights Reserved.


   The Summary Object Interchange Format [Ref. 1] was first defined by
   the Harvest Project [Ref 2.] in January 1994.  SOIF was derived from
   a combination of the Internet Anonymous FTP Archives IETF Working
   Group (IAFA) templates [Ref 3.] and the BibTeX bibliography format
   [Ref 4.].  The combination was originally noted for its advantages of
   providing a convenient and intuitive way for delimiting objects
   within a stream, and setting apart the URL for easy object access or
   invocation, while still preserving compatibility with IAFA templates.

   SOIF uses named template types to indicate the attributes which may
   be contained within a particular summary object.  Within the context
   of a single application, private agreement on the definition of
   template types has been adequate.  As SOIF objects are moved among
   applications, however, the need for standard, well-specified, and
   easily identifiable template types increases.  This need is
   particularly intense in the context of query referral, where
   knowledge of an attribute's definition and the allowed data types for
   specific values is crucial.  For a discussion of this in the context
   of the Common Indexing Protocol, see [Ref. 1].

   The registration procedure described in this document is specific to
   SOIF template types.  There is ongoing work within the IETF to
   specify a more generic schema registration facility[Ref. 5].  It is
   not yet clear whether the results of that work will encompass the
   ability to register entities like SOIF template types.  If it does
   so, the registration of SOIF template types may be shifted to that
   method and registry.  Should that occur, appropriate pointers will be
   created in cooperation with the Registrar to ensure that no
   registrations are lost.

Hardie                        Experimental                      [Page 1]
RFC 2656            Registration Procedures for SOIF         August 1999

1.  Registrar

   The initial registrar of SOIF template types will be the Internet
   Assigned Numbers Authority (IANA).

2.  Defining Template Types

   Each SOIF object is composed of 3 fundamental components: a template
   type IDENTIFIER, a URL, and zero or more ATTRIBUTE-VALUE pairs.  See
   [Ref 1.] for the formal grammar of SOIF and a description of how
   these components interrelate.  As part of the registration process,
   registrants must: propose a template type IDENTIFER; list the
   ATTRIBUTEs which the template may contain; identify whether each
   ATTRIBUTE is mandatory or optional; and specifiy the data type and
   encoding appropriate for the VALUEs associated with each ATTRIBUTE.

2.1 The template type IDENTIFIER

   The IDENTIFIER for the template type is assigned at registration
   based on a proposal from the registrant.  It is, however, at the sole
   discretion of the registrars to assign specific IDENTIFIERS.  While
   they will normally assign the IDENTIFIERs proposed by registrants,
   they may choose to modify a proposed IDENTIFIER to avoid conflict
   with other existing or proposed template types.

   Because of the pre-installed base of servers using privately agreed
   upon template types, applications using SOIF need to be able to
   ascertain whether a referenced template type has been registered.  In
   order to accomplish this, all template type IDENTIFIERS for template
   types registered with the IANA will begin with the ASCII string
   "IANA-".  An IANA-registered template type based on the GILS
   specification, for example, might be registered as "IANA-GILS".
   Should other registrars emerge over time, similar strings must be
   established and used to compose template type IDENTIFIERS which they

2.2 The URL

   The URL associated with a particular summary object is determined by
   the application generating the object.  Applications must generate
   valid URLs according to the rules of [Ref 6.], but there is no
   restriction on what sorts of URLs may be associated with particular
   template types.  The use of a particular template type indicates the
   type of information contained in the summary object, not how the
   inital resource being summarized was accessed.  This aspect of SOIF
   summary objects is therefor not subject to registration.

Hardie                        Experimental                      [Page 2]
Show full document text