> The IANA section needs to be very clear.  The IANA people 
> really only look
> there for their instructions.

I have re-worked the IANA Considerations a little. Some information is
now a duplicate of the HEADER description, but in the light of Chris'
comment, this makes sense to me. The text also contains a change related
to Chris issue with x- PARAM-NAMES - see below. 

The new text is as follows:

###
9.  IANA Considerations

9.1  VERSION

   IANA must maintain a registry of VERSION values as described in
   Section 6.2.1.  Version numbers MUST be incremented for any new
   syslog protocol specification that changes any part of the HEADER.
   Changes include addition or removal of fields or a change of syntax
   or semantics of existing fields.

   VERSION numbers must be registered via the Standards Action method as
   described in RFC 2434 [9].  IANA must register the VERSIONs shown in
   table 4 below.

       VERSION     FORMAT
       1           according to this document

        Table 4. IANA-registered VERSIONs.


9.2  SD-IDs

   IANA must maintain a registry of Structured Data ID (SD-ID) values
   together with their associated PARAM-NAME values as described in
   Section 7.

   New SD-ID and new PARAM-NAME values must be registered through the
   Standards Action method as described in RFC 2434 [9].

   Once SD-IDs and SD-PARAMs are defined, syntax and semantics of these
   objects MUST NOT be altered.  Should a change to an existing object
   be desired, a new SD-ID or SD-PARAM MUST be created and the old one
   remain unchanged.

   SD-IDs and PARAM-NAMEs with the prefatory string "x-" (without the
   quotes) are reserved for experimental use.  IANA must not register
   any SD-ID or PARAM-NAME with the prefatory string "x-" for any other
   use.

   IANA must register the SD-IDs and PARAM-NAMEs shown in table 5 below.

       SD-ID              PARAM-NAME
       timeQuality                           OPTIONAL
                          tzKnown            OPTIONAL
                          isSynced           OPTIONAL
                          syncAccuracy       OPTIONAL

       origin                                OPTIONAL
                          ip                 OPTIONAL
                          enterpriseId       OPTIONAL
                          software           OPTIONAL
                          swVersion          OPTIONAL

       meta                                  OPTIONAL
                          sequenceId         OPTIONAL
                          sysUpTime          OPTIONAL

       x- (prefatory      RESERVED for experimental SD-IDs
           string)

       (any)              x- (prefatory      reserved for experimental
                              string)        PARAM-NAMEs

          Table 5. IANA-registered SD-IDs and their PARAM-NAMEs.
###

> 
> 
> >
> > However, this raises a question: should we allow 
> experimental SD-PARAMs
> > in standardized SD-IDs? Or should these only be allowed in 
> experimental
> > SD-IDs (x-)?
> 
> That's a question for the WG.
> 
> WG Chair hat OFF:
> I'd suggest putting in a quick statement about allowing 
> "x-<SD-PARAMs>" in
> any SD-IDs.
> Eveyone:  Get your thoughts in quickly on this.

I agree to Chris suggestion. I have modified the text as follows:

###
6.3.3  SD-PARAM

   Each SD-PARAM consist of a name, referred to as PARAM-NAME, and a
   value, referred to as PARAM-VALUE.

   PARAM-NAME is case-sensitive.  IANA controls all PARAM-NAMEs, with
   the exception of those in experimental SD-IDs or those with the
   prefatory string "x-" (without the quotes).  PARAM-NAMEs with the
   prefatory string x- are set aside for experimental purposes.  They
   can be specified in any SD-ID.  The PARAM-NAME scope is within a
   specific SD-ID.  Thus, an equally-named PARAM-NAME contained in two
   different SD-IDs is not the same.
###

I will publish this version tomorrow if I do not receive any more
comments requesting change.

Rainer
_______________________________________________
Syslog-sec mailing list
[email protected]
http://www.employees.org/mailman/listinfo/syslog-sec

Reply via email to