Subject: [nfsv4] [FedFS] format for an annotation attribute

From: James Lentini <[email-masked]>
Date: Mon, 11 May 2009 15:44:41 -0400 (EDT)

I propose updating section 6.2.11 of the NSDB draft with the text 
below to define the format of a FedFS LDAP "annotation" attribute.

---

An annotation of an NSDB object.

This attribute is multi-valued; an object type that permits 
annotations may have any number of annotations per instance.

 attributetype (
        1.3.6.1.4.1.31103.1.11 NAME 'annotation'
        DESC 'annotation of an NSDB object'
        SUP name )

An annotation attribute MUST be a UTF-8 string formatted as follows:

 "KEY" = "VAL"

White space, defined as space, form-feed ('\f'), newline ('\n'), 
carriage return ('\r'), horizontal tab ('\t'), and vertical 
tab ('\v') characters, is ignored.

KEY and VAL MAY may contain any UTF-8 characters. The following 
escape sequences are allowed:

 escape sequence | replacement
 -----------------------------
         \\      |     \
         \"      |     "

An annotation attribute that does not adhere to this format SHOULD 
be ignored.

The following are examples of valid annotation attributes:

 "key1" = "foo"
 "another key" = "x=3"
 "key-2" = "A string with \" and \\ characters."

which correspond to the following key/value pairs:

 key             | value
 ---------------------------------
 key1            | foo
 another key     | x=3
 key-2           | A string with " and \ characters.