WDIFF

draft-daboo-imap-annotatemore-08.txt --> draft-daboo-imap-annotatemore-09.txt

Network Working Group C. Daboo
Internet-Draft November 21, 2005 March 29, 2006
Expires: May 25, September 30, 2006

IMAP ANNOTATEMORE METADATA Extension
draft-daboo-imap-annotatemore-08
draft-daboo-imap-annotatemore-09

Status of this Memo

By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79.

Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.

Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."

The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt.

The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.

This Internet-Draft will expire on May 25, September 30, 2006.

Abstract

The ANNOTATEMORE METADATA extension to the Internet Message Access Protocol
permits clients and servers to maintain annotations ("metadata") "annotations" or "meta data"
on IMAP servers. It is possible to have annotations on a per-mailbox
basis or on the server as a whole. For example, this would allow
comments about the purpose of a particular mailbox to be "attached"
to that mailbox, or a "message of the day" containing server status
information to be made available to anyone logging in to the server.

Change History (to be removed prior to publication as an RFC)

Changes from -07 to -08:

Daboo Expires May 25, September 30, 2006 [Page 1]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

Changes from -08 to -09:
1. Remove content-language attribute and reference.
2. Changed capability and command names.
3. Revised abstract.

Changes from -07 to -08:
1. Changed 'string' formal syntax to 'list-mailbox' and 'astring'
for entry/attribute names.
2. Updated examples to match new astring syntax.
3. Changed CAPABILITY name due to incompatible syntax change.
4. Removed content-type attribute.
5. Added Content-type to IANA registration for entries.
6. Removed vendor attributes.
7. Fixed examples in section 3.3 for multi-mailbox and multi-entry
cases.
8. Removed wildcards for attributes.
9. Entry/attributes can now only be ASCII.
10. Tied up text wrt storing/fetching.
11. Added Conventions section
12. Entry/attributes MUST NOT contain consecutive or trailing '/' or
'.'.
13. Changed to use IMAP ABNF extensions document for some formal
syntax items.

Changes from -06 to -07:
1. Reworded /checkperiod item.
2. Clarified unsolicited response behaviour.

Changes from -05 to -06:
1. Removed 'modifiedsince' attribute as there is currently no use
for it.
2. Added content-language attribute.
3. Changed access to allow .priv and .shared on any mailbox returned
by LIST/LSUB.
4. Added IANA registrations for items defined in this document.
5. Added latest IPR statement.
6. Updated references.

Changes from -04 to -05:
1. Fix for valid IMAP state of commands.
2. Fix formatting, ID nits etc.

Changes from -03 to -04:
1. Allow retrieval of shared annotations for READ-ONLY mailbox.
2. Clarification of annotation loss on implicit removal of \Noselect
mailboxes.

Daboo Expires September 30, 2006 [Page 2]

Internet-Draft IMAP METADATA Extension March 2006

3. Now requires roll-back of all changes to matching mailboxes if
there is a partial failure in SETANNOTATION.

Changes from -02 to -03:
1. Reworked entry naming scheme to split out mailbox name and use
empty string for server items.

Changes from -01 to -02:

Daboo Expires May 25, 2006 [Page 2]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005
1. SETANNOTATION lists use (..).
2. Explicitly state behaviour of unsolicited responses.
3. Adding SHOULD behaviour for rename/delete of mailboxes.
4. Added statement about supporting annotations on \Noselect
mailboxes.
5. Cleaned up formal syntax to use IMAP string type for entry and
attributes, with requirements on how the string is formatted.
6. Use of ACAP vendor subtree registry for vendor tokens.

Changes from -00 to -01:
1. Multiple entry-att responses are now simply delimited by spaces
in line with ANNOTATE spec. Adjusted examples to match.
2. Fixed entry-list formal syntax item to account for unsolicited
parenthesised list of entries.
3. Removed setentries formal syntax item for simplicity since its
only used once.
4. Removed reference to 'message annotation' in section 5.1.
5. Changed formal syntax to restrict top level entries to /server
and /mailbox/{...} only. Re-arranged entry names section to
account for this change.
6. Added comment and example for ANNOTATION response to allow
servers to return separate responses for each entry if desired.

Daboo Expires May 25, September 30, 2006 [Page 3]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

Table of Contents

1. Introduction and Overview . . . . . . . . . . . . . . . . . . 5
2. Conventions Used in This Document . . . . . . . . . . . . . . 5
3. Data Model . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . 5 6
3.2. Namespace of entries and attributes . . . . . . . . . . . 6
3.2.1. Entry Names . . . . . . . . . . . . . . . . . . . . . 7
3.2.2. Attribute Names . . . . . . . . . . . . . . . . . . . 8
3.3. Private versus Shared and Access Control . . . . . . . . . 9
4. IMAP Protocol Changes . . . . . . . . . . . . . . . . . . . . 9
4.1. General Considerations . . . . . . . . . . . . . . . . . . 9
4.2. GETANNOTATION GETMETADATA Command . . . . . . . . . . . . . . . . . . . 10
4.3. SETANNOTATION Extended LIST Command Extensions . . . . . . . . . . . . . 12
4.3.1. Unsolicited LIST repsonse . . . . . . . 12 . . . . . . . 16
4.4. ANNOTATION SETMETADATA Command . . . . . . . . . . . . . . . . . . . 16
4.5. METADATA Response . . . . . . . . . . . . . . . . . . . 14
4.4.1. ANNOTATION . 19
4.5.1. METADATA response with attributes and values . . . . 15
4.4.2. . 19
4.5.2. Unsolicited ANNOTATION METADATA response without attributes
and values . . . . . . . . . . . . . . . . . . . . . . 16 20
5. Formal Syntax . . . . . . . . . . . . . . . . . . . . . . . . 17 21
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 18 22
6.1. Entry and Attribute Registration Template . . . . . . . . 19 23
6.2. Server Entry Registrations . . . . . . . . . . . . . . . . 19 23
6.2.1. /comment . . . . . . . . . . . . . . . . . . . . . . . 20 24
6.2.2. /motd . . . . . . . . . . . . . . . . . . . . . . . . 20 24
6.2.3. /admin . . . . . . . . . . . . . . . . . . . . . . . . 21 25
6.3. Mailbox Entry Registrations . . . . . . . . . . . . . . . 21 25
6.3.1. /comment . . . . . . . . . . . . . . . . . . . . . . . 21 25
6.3.2. /sort . . . . . . . . . . . . . . . . . . . . . . . . 22 26
6.3.3. /thread . . . . . . . . . . . . . . . . . . . . . . . 22 26
6.3.4. /check . . . . . . . . . . . . . . . . . . . . . . . . 23 27
6.3.5. /checkperiod . . . . . . . . . . . . . . . . . . . . . 23 27
6.4. Attribute Registrations . . . . . . . . . . . . . . . . . 23 27
6.4.1. value . . . . . . . . . . . . . . . . . . . . . . . . 24 28
6.4.2. size . . . . . . . . . . . . . . . . . . . . . . . . . 24
6.4.3. content-language . . . . . . . . . . . . . . . . . . . 25 28
7. Security Considerations . . . . . . . . . . . . . . . . . . . 25 28
8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 25 29
8.1. Normative References . . . . . . . . . . . . . . . . . . . 25 29
8.2. Informative References . . . . . . . . . . . . . . . . . . 26 29
Appendix A. Acknowledgments . . . . . . . . . . . . . . . . . . . 26 30
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 27 31
Intellectual Property and Copyright Statements . . . . . . . . . . 28 32

Daboo Expires May 25, September 30, 2006 [Page 4]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

1. Introduction and Overview

The ANNOTATEMORE METADATA extension is present in any IMAP [RFC3501]
implementation which returns "ANNOTATEMORE2" "METADATA" as one of the supported
capabilities in the CAPABILITY command response. The "LISTEXT"
[I-D.ietf-imapext-list-extensions] extension MUST also be present.

The goal of ANNOTATEMORE METADATA is to provide a means for clients to set and
retrieve "metadata" "annotations" or "meta data" on an IMAP server. The metadata
annotations can be associated with specific mailboxes or the server
as a whole.

The ANNOTATEMORE METADATA extension adds two new commands and one new untagged
response to the IMAP base protocol. It adds one new LISTEXT
"selection" [I-D.ietf-imapext-list-extensions] option type and one
new LISTEXT "return" [I-D.ietf-imapext-list-extensions] option type.

This extension makes the following changes to the IMAP protocol:

adds a new SETANNOTATION SETMETADATA command
adds a new GETANNOTATION GETMETADATA command
adds a new ANNOTATION METADATA untagged response
adds a new ANNOTATEMORE METADATA response code
adds a new METADATA LISTEXT selection option type
adds a new METADATA LISTEXT return option typer

The data model used in ANNOTATEMORE METADATA is exactly the same as that used in
the ANNOTATE [I-D.ietf-imapext-annotate] extension to IMAP. This is
modeled after that of the Application Configuration Access Protocol
[RFC2244] with the exception of inheritance which is not deemed
necessary here.

The rest of this document describes the data model and protocol
changes more rigorously.

2. Conventions Used in This Document

In examples, "C:" and "S:" indicate lines sent by the client and
server respectively.

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in [RFC2119].

3. Data Model

Daboo Expires September 30, 2006 [Page 5]

Internet-Draft IMAP METADATA Extension March 2006

3.1. Overview

The data model used in ANNOTATEMORE METADATA is one of a uniquely named entry with
a set of uniquely named attributes, each of which has a value.
Annotations can be added to mailboxes when a mailbox name is provided
as the first argument to the new commands, or to the server as a

Daboo Expires May 25, 2006 [Page 5]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005
whole when the empty string is provided as the first argument to the
new commands.

An annotation can contain multiple named entries. For example, a
general comment being added to a mailbox may have an entry name of
"/comment". This entry could include named attributes such as
"value", "size", "content-language"
"value" and "size" etc to represent properties and data associated
with the entry.

The protocol changes to IMAP described below allow a client to access
or change the values of any attributes in any entries in an
annotation, assuming it has sufficient access rights to do so.

3.2. Namespace of entries and attributes

Each annotation is made up of a set of entries. Each entry has a
hierarchical name, with each component of the name separated by a
slash ("/"). An entry name MUST NOT contain two consecutive "/"
characters and MUST NOT end with a "/" character.

Each entry is made up of a set of attributes. Each attribute has a
hierarchical name, with each component of the name separated by a
period ("."). An attribute name MUST NOT contain two consecutive "."
characters and MUST NOT end with a "." character.

The value of an attribute is NIL (has no value), or a string of zero
or more octets.

Entry and attribute names MUST NOT contain asterisk ("*") or percent
("%") characters and MUST NOT contain non-ASCII characters or the
NULL octet. Invalid entry or attribute names result in a BAD
response in any IMAP commands where they are used.

Attribute names MUST NOT contain any hierarchical components with the
names "priv" or "shared" as those have special meaning (see
Section 3.3).

Entry and attribute names are case-sensitive.

Use of control or punctuation characters in entry and attribute names
is strongly discouraged.

This specification defines an

Daboo Expires September 30, 2006 [Page 6]

Internet-Draft IMAP METADATA Extension March 2006

This specification defines an initial set of entry and attribute
names available for use with mailbox and server annotations. In
addition an extension mechanism is described to allow additional
names to be added for extensibility.

Daboo Expires May 25, 2006 [Page 6]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005

3.2.1. Entry Names

Entry names MUST be specified in a standards track or IESG approved
experimental RFC, or fall under the vendor namespace. See
Section 6.1 for the registration template.

3.2.1.1. Server Entries

These entries are used when the mailbox name argument to the new
commands
SETMATADATA command is the empty string. string or with the new GETMETADATA
command.

/comment
Defines a comment or note associated with the server.

/motd
Defines a "message of the day" for the server. This entry is
always read-only - clients cannot change it.

/admin
Indicates a method for contacting the server administrator. This
may be a URI (e.g. a mailto URL) or other contact information,
such as a telephone number. This entry is always read-only -
clients cannot change it.

/vendor/<vendor-token>
Defines the top-level of entries associated with the server as
created by a particular product of some vendor. This entry can be
used by vendors to provide server or client specific annotations.
The vendor-token MUST be registered with IANA, using the ACAP
[RFC2244] vendor subtree registry.

3.2.1.2. Mailbox Entries

These entries are used when the mailbox name argument to the new
commands
SETMETADATA command is not the empty string. string, or with the new LISTEXT
selection option type.

/comment
Defines a comment or note associated with a mailbox.

/sort

Daboo Expires September 30, 2006 [Page 7]

Internet-Draft IMAP METADATA Extension March 2006

Defines the default sort criteria [I-D.ietf-imapext-sort] to use
when first displaying the mailbox contents to the user, or NIL if
sorting is not required.

/thread
Defines the default thread criteria [I-D.ietf-imapext-sort] to use
when first displaying the mailbox contents to the user, or NIL if
threading is not required. If both sort and thread are not NIL,

Daboo Expires May 25, 2006 [Page 7]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005
then threading should take precedence over sorting.

/check
Boolean value "true" or "false" that indicates whether this
mailbox should be checked at regular intervals by the client. The
interval in minutes is specified by the /checkperiod entry.

/checkperiod
Numeric value indicating a period of minutes that the client uses
to determine the interval of regular 'new mail' checks for the
corresponding mailbox.

/vendor/<vendor-token>
Defines the top-level of entries associated with a specific
mailbox as created by a particular product of some vendor. This
entry can be used by vendors to provide client specific
annotations. The vendor-token MUST be registered with IANA, using
the ACAP [RFC2244] vendor subtree registry.

3.2.2. Attribute Names

Attribute names MUST be specified in a standards track or IESG
approved experimental RFC. See Section 6.1 for the registration
template.

All attribute names implicitly have a ".priv" and a ".shared" suffix
which maps to private and shared versions of the entry. Retrieving
an annotation without using either suffix includes both. The client
MUST specify either a ".priv" or ".shared" suffix when setting an
annotation.

value
A string or binary data representing the value of the annotation.
To delete an annotation, the client can store "NIL" into the
value. The content represented by the string is determined by the
Content-type
Content-Type used to register the entry (see Section 6.1 for entry
registration templates). Where applicable, the registered
content-type
Content-Type MUST include a charset parameter. Text values SHOULD
use the utf-8 [RFC3629] character set.

Daboo Expires September 30, 2006 [Page 8]

Internet-Draft IMAP METADATA Extension March 2006

Note that binary data (data which may contain the NULL octet) is
allowed (e.g. for storing images etc), and this extension uses the
"literal8" syntax element [I-D.melnikov-imap-ext-abnf] to allow
such data to be written to or read from the server.

size
The size of the value, in octets. Set automatically by the
server, read-only to clients.

Daboo Expires May 25, 2006 [Page 8]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005

content-language
Indicates the language used for the value. This follows the
format described in [RFC3282]. Clients SHOULD specify this
attribute when setting an annotation that uses text that can be
presented to the user. It is not required for enumerated or
numeric values such as flags etc. If a value is being set,
clients MUST ensure that it accurately reflects the content stored
in the value attribute.
Servers MUST ensure that the "content-language" attribute value is
kept in synchronization with the "value" attribute. To ensure
that, the server MUST remove any "content-language" attribute
value when the client changes a "value" attribute without also
including a matching "content-language" attribute in the same
SETANNOTATION command.

3.3. Private versus Shared and Access Control

As discussed in the ANNOTATE [I-D.ietf-imapext-annotate] extension
there is a need to support both private and shared annotations. This
document adopts the scheme used in [I-D.ietf-imapext-annotate] that
adds two standard suffixes for all attributes: ".shared" and ".priv".
A GETANNOTATION GETMETADATA or extended LIST command which specifies neither uses
both.
SETANNOTATION SETMETADATA commands MUST explicitly use .priv or .shared
suffixes.

A user can only set and retrieve private or shared annotations on a
mailbox which is returned to them via a LIST or LSUB command. command,
irrespective of whether they have read or write access to the actual
message content of the mailbox. If the client attempts to set or
retrieve annotations on other mailboxes, the server MUST respond with
a NO response.

If the METADATA extension is present, support for shared annotations
is REQUIRED, whilst support for private annotations is OPTIONAL.
This recognises the fact that support for private annotations may
introduce significantly more complexity to a server in terms of
tracking ownership of the annotations, how quota is determined for
users based on their own annotations etc. Clients that support the
METADATA extension MUST handle both shared and private annotations.

4. IMAP Protocol Changes

4.1. General Considerations

The new commands SETMETADATA command and the METADATA response each have a
mailbox name argument, indicating that the annotations being referred
to are attached to the specified mailbox. An empty string can be
used for the mailbox name to signify server annotations.

Both "*" and "%" list wildcard characters MAY be used in the mailbox
name argument to commands in the SETMETADATA command to match all possible
occurrences of a mailbox name pattern. However, "*" or "%" by
themselves MUST NOT match the empty string (server) entries. Server entries

Daboo Expires September 30, 2006 [Page 9]

Internet-Draft IMAP METADATA Extension March 2006

entries can only be accessed by explicitly using the empty string as
the mailbox name.

Servers SHOULD ensure that mailbox annotations are automatically
moved when the mailbox they refer to is renamed, i.e. the annotations
follow the mailbox. Servers SHOULD delete annotations for a mailbox

Daboo Expires May 25, 2006 [Page 9]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005
when the mailbox is deleted, so that a mailbox created with the same
name as a previously existing mailbox does not inherit the old
mailbox annotations. Servers SHOULD allow annotations on all 'types'
of mailbox, including ones reporting \Noselect for their LIST
response. Servers can implicitly remove \Noselect mailboxes when all
child mailboxes are removed, and as such any annotations associated
with the \Noselect mailbox SHOULD be removed.

The server is allowed to impose limitations on the size of any one
annotation or the total number of annotations for a single mailbox or
for the server as a whole. However, the server MUST accept a minimum
annotation data size of at least 1024 bytes, and a minimum annotation
count per server or mailbox of at least 10.

4.2. GETANNOTATION GETMETADATA Command

This extension adds the GETANNOTATION GETMETADATA command. This allows clients to
retrieve server annotations. Mailbox annotations are retrieved via
the extended LIST command described in the next section.

This command is only available in authenticated or selected state
[RFC3501].

Arguments: mailbox-name entry-specifier
attribute-specifier

Responses: required ANNOTATION METADATA response

Result: OK - command completed
NO - command failure: can't access annotations on
that mailbox
the server
BAD - command unknown or arguments invalid

The mailbox-name argument MUST be a valid mailbox name or the empty
string. In the later case, the annotations being referred to are the
ones for the server as a whole.

Example:

C: a GETANNOTATION "" GETMETADATA /comment value.priv
S: * ANNOTATION "" METADATA /comment (value.priv "My comment")
S: a OK GETANNOTATION GETMETADATA complete

In the above example, the contents of the "value" "value.priv" attribute
for the "/comment" server entry is requested by the client and
returned by the server.

Daboo Expires September 30, 2006 [Page 10]

Internet-Draft IMAP METADATA Extension March 2006

"*" and "%" wildcard characters can be used in the entry specifier to

Daboo Expires May 25, 2006 [Page 10]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005
match one or more characters at that position, with the exception
that "%" does not match the "/" hierarchy delimiter. Thus an entry
specifier of "/%" would match entries such as "/comment" and
"/version", but not "/comment/note".

Example:

C: a GETANNOTATION "" GETMETADATA /* value.priv
S: * ANNOTATION "" METADATA /comment (value.priv "My comment")
/version (value.priv "1.1")
/motd/today (value.priv "Closed at 1 pm")
S: a OK GETANNOTATION GETMETADATA complete

In the above example, the contents of the "value" "value.priv" attributes
for any server entries are requested by the client and returned by
the server.

Example:

C: a GETANNOTATION "" GETMETADATA /% value
S: * ANNOTATION METADATA /comment (value.priv "My comment")
(value.shared "Your comment")
/motd (value.priv "Its sunny outside!"
(value.shared "Today is a Holiday")
S: a OK GETANNOTATION GETMETADATA complete

In the above example, the contents of the "value" attributes for
server entries at the top level of the entry hierarchy only, are
requested by the client and returned by the server. Both the
.priv and .shared values are returned, as neither were explicitly
requested.

Entry and attribute specifiers can be lists of atomic specifiers, so
that multiple items of each type may be returned in a single
GETANNOTATION
GETMETADATA command.

Example:

C: a GETANNOTATION "" GETMETADATA (/comment /motd) value.priv
S: * ANNOTATION "" METADATA /comment (value.priv "My comment")
/motd (value.priv "Its sunny outside!")
S: a OK GETANNOTATION GETMETADATA complete

In the above example, the contents of the "value" "value.priv" attributes
for the two server entries "/comment" and "/motd" are requested by
the client and returned by the server.

Example:

Daboo Expires May 25, September 30, 2006 [Page 11]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

Example:

C: a GETANNOTATION "" GETMETADATA /comment (value.priv
content-language.priv)
size.priv)
S: * ANNOTATION "" METADATA /comment (value.priv "My comment"
content-language.priv "en_GB")
size.priv "1234")
S: a OK GETANNOTATION GETMETADATA complete

In the above example, the contents of the "value" "value.priv" and "content-
language"
"size.priv" attributes for the "/comment" server entry are
requested by the client and returned by the server.

4.3. SETANNOTATION Extended LIST Command Extensions

This extension adds the SETANNOTATION command. METADATA LIST command selection and return
option types, extending the LISTEXT extension. This allows clients
to set retrieve mailbox annotations.

This command

The LISTEXT "METADATA" selection option type is only available in authenticated or selected state
[RFC3501].

Arguments: mailbox-name
entry
attribute-value
list of entry, attribute-values

Responses: no specific responses for this command

Result: OK - command completed
NO - used to request that
the extended LIST command failure: can't set annotations,
or match mailboxes which have an annotation too big or too many
BAD - command unknown or arguments invalid

Sets the specified list of entries by adding or replacing the
specified attributes
with the values provided. Clients a specific entry and value. It can use NIL also be used to test for values the
existence of attributes it wants a particular annotation entry on a mailbox. This
selection option takes one or more entry/attribute/value triples to remove from entries. The server
MAY return
use as tests. A mailbox matches this criteria if it has an ANNOTATION response containing the updated entry,
attribute and value matching the ones specified. In the case of
multiple criteria being specified, mailbox MUST only match when all
criteria match ("and" operation). To test for the existence of an
entry, a test for the attribute "value" with the empty string "" as
the value argument can be used. To test for the absence of an entry,
a test for the attribute "value" with NIL as the value argument can
be used. If the COMPARATOR [I-D.ietf-imapext-i18n] extension is
present, then the active comparator MUST be used when doing text
comparisons of the value. Clients SHOULD only use entries defined
with a "text" Content-Type in the selection option arguments.

The LISTEXT "METADATA" return option type is used to request that the
extended LIST command return specific annotation entries for each
mailbox returned in the LIST responses. A list of entries and
attributes to return can be specified in a manner similar to the
GETMETADATA command.

Example:

C: a LIST "" "INBOX" RETURN (METADATA /comment value.priv)
S: * LIST (\metadata /comment (value.priv "My comment"))
"/" "INBOX"
S: a OK LIST complete

Daboo Expires September 30, 2006 [Page 12]

Internet-Draft IMAP METADATA Extension March 2006

In the above example, the contents of the "value.priv" attribute
for the "/comment" entry for the mailbox INBOX is requested by the
client and returned by the server.

"*" and "%" wildcard characters can be used in the entry specifier to
match one or more characters at that position, with the exception
that "%" does not match the "/" hierarchy delimiter. Thus an entry
specifier of "/%" would match entries such as "/comment" and
"/version", but not "/comment/note".

Example:

C: a LIST "" "INBOX" RETURN (METADATA /* value.priv)
S: * LIST (\metadata /comment (value.priv "My comment")
/version (value.priv "1.1")
/motd/today (value.priv "Closed at 1 pm"))
"/" "INBOX"
S: a OK LIST complete

In the above example, the contents of the "value.priv" attributes
for any entries for the mailbox INBOX are requested by the client
and returned by the server.

Example:

C: a LIST "" "INBOX" RETURN (METADATA /% value)
S: * LIST (\metadata /comment (value.priv "My comment")
(value.shared "Your comment")
/motd (value.priv "Its sunny outside!"
(value.shared "Today is a Holiday"))
"/" "INBOX"
S: a OK LIST complete

In the above example, the contents of the "value" attributes for
entries for the mailbox INBOX at the top level of the entry
hierarchy only, are requested by the client and returned by the
server. Both the .priv and .shared values are returned, as
neither were explicitly requested.

Entry and attribute specifiers can be lists of atomic specifiers, so
that multiple items of each type may be returned in a single LIST
command.

Example:

Daboo Expires September 30, 2006 [Page 13]

Internet-Draft IMAP METADATA Extension March 2006

C: a LIST "" "INBOX" RETURN (METADATA (/comment /motd)
value.priv)
S: * LIST (\metadata /comment (value.priv "My comment")
/motd (value.priv "Its sunny outside!"))
"/" "INBOX"
S: a OK LIST complete

In the above example, the contents of the "value.priv" attributes
for the two entries "/comment" and "/motd" for the mailbox INBOX
are requested by the client and returned by the server.

Example:

C: a LIST "" "INBOX" RETURN (METADATA /comment
(value.priv size.priv))
S: * LIST (\metadata /comment (value.priv "My comment"
size.priv "1234"))
"/" "INBOX"
S: a OK LIST complete

In the above example, the contents of the "value.priv" and
"size.priv" attributes for the "/comment" entry for the mailbox
INBOX are requested by the client and returned by the server.

Example:

C: a LIST "" ("INBOX" "FOOBOX" "BARBOX") RETURN
(METADATA /comment value.priv)
S: * LIST (\metadata /comment (value.priv "My comment"))
"/" "INBOX"
S: * LIST (\metadata /comment (value.priv "Another comment"))
"/" "FOOBOX"
S: * LIST (\metadata /comment (value.priv NIL))
"/" "BARBOX"
S: a OK LIST complete

In the above example, the contents of the "value.priv" attribute
for the "/comment" entry for the mailboxes INBOX, FOOBOX and
BARBOX are requested by the client and returned by the server.
Note that the mailbox BARBOX does not contain the entry, hence NIL
is returned for the attribute value.

Example:

C: a LIST (METADATA ("/comment" "value" "comm")
"" "*"
S: * LIST () "/" "INBOX"
S: * LIST (\NoInferiors) "/" "FOOBOX"

Daboo Expires September 30, 2006 [Page 14]

Internet-Draft IMAP METADATA Extension March 2006

S: a OK LIST complete

In the above example, the client requests that any mailbox in the
entire hierarchy containing the text "comm" in any "value"
attribute of the "/comment" entry be returned. Two mailboxes are
returned in separate responses. Note that the client did not ask
for annotations to be returned in the responses.

Example:

C: a LIST (METADATA ("/comment" "value" "")
"" "*"
S: * LIST () "/" "INBOX"
S: * LIST (\NoInferiors) "/" "FOOBOX"
S: a OK LIST complete

In the above example, the client requests that any mailbox in the
entire hierarchy containing the "/comment" entry be returned. Two
mailboxes are returned in separate responses. Note that the
client did not ask for annotations to be returned in the
responses.

Example:

C: a LIST (METADATA ("/comment" "value" NIL)
"" "*"
S: * LIST (\NoInferiors) "/" "BARBOX"
S: a OK LIST complete

In the above example, the client requests that any mailbox in the
entire hierarchy that does not have a "/comment" entry be
returned. One mailbox is returned in a response. Note that the
client did not ask for annotations to be returned in the
responses.

Example:

C: a LIST (METADATA ("/comment" "value" "comm")
"" "*" RETURN (METADATA /comment size.priv)
S: * LIST (\metadata /comment (size.priv "10"))
"/" "INBOX"
S: * LIST (\metadata /comment (size.priv "15"))
"/" "FOOBOX"
S: a OK LIST complete

In the above example, the client requests that any mailbox in the
entire hierarchy containing the text "comm" in any "value"
attribute of the "/comment" entry be returned. Two mailboxes are

Daboo Expires September 30, 2006 [Page 15]

Internet-Draft IMAP METADATA Extension March 2006

returned in separate responses. The client also asked for
annotations to be returned in the responses.

4.3.1. Unsolicited LIST repsonse

Servers SHOULD send unsolicited LIST responses if mailbox annotations
are changed by a third-party, allowing servers to keep clients
updated with changes. Unsolicited mailbox annotations MUST only be
returned for the currently selected mailbox.

Unsolicited LIST responses MUST only contain entry names, not the
attributes and values. If the client wants to update any cached
values it must explicitly retrieve those using a LIST command.

The LIST response can contain multiple entries in a single response,
but the server is free to return multiple responses for each entry or
group of entries if it desires.

Example:

C: a NOOP
S: * LIST (\metadata /comment) "/" "INBOX"
S: a OK NOOP complete

In the above example, the server sends an unsolicited LIST
response indicating that the "/comment" entry of the mailbox
"INBOX" has been changed.

4.4. SETMETADATA Command

This extension adds the SETMETADATA command. This allows clients to
set annotations.

This command is only available in authenticated or selected state
[RFC3501].

Arguments: mailbox-name
entry
attribute-value
list of entry, attribute-values

Responses: no specific responses for this command

Result: OK - command completed
NO - command failure: can't set annotations,
or annotation too big or too many
BAD - command unknown or arguments invalid

Daboo Expires September 30, 2006 [Page 16]

Internet-Draft IMAP METADATA Extension March 2006

This command sets the specified list of entries by adding or
replacing the specified attributes with the values provided. Clients
can use NIL for values of attributes it wants to remove from entries.
The server MAY return a METADATA response containing the updated
annotation data. Clients MUST NOT assume that an ANNOTATION a METADATA response
will be sent, and MUST assume that if the command succeeds then the
annotation has been changed.

If the server is unable to set an annotation because the size of its
value is too large, the server MUST return a tagged NO response with
a "[ANNOTATEMORE "[METADATA TOOBIG]" response code.

If the server is unable to set a new annotation because the maximum
number of allowed annotations has already been reached, the server
MUST return a tagged NO response with a "[ANNOTATEMORE "[METADATA TOOMANY]" response
code.

If the server is unable to set a new annotation because it does not
support private annotations on one of the specified mailboxes, the
server MUST return a tagged NO response with a "[METADATA NOPRIVATE]"
response code.

If the server is unable to set the annotations for one or more

Daboo Expires May 25, 2006 [Page 12]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005
mailboxes matching the mailbox-name pattern, then the SETANNOTATION SETMETADATA
command MUST fail and there MUST NOT be any changes to any of the
matching mailboxes, even those for which annotations could have been
changed successfully.

Example:

C: a SETANNOTATION SETMETADATA INBOX /comment
(value.priv "My new comment")
S: a OK SETANNOTATION SETMETADATA complete

In the above example, the entry "/comment" for the mailbox "INBOX"
is created (if not already present) and the private attribute
"value" with data set to "My new comment" is created if not
already present, or replaced if it previously exists.

Example:

C: a SETANNOTATION SETMETADATA INBOX /comment (value.priv NIL)
S: a OK SETANNOTATION SETMETADATA complete

In the above example, the private "value" attribute of the entry
"/comment" is removed from the mailbox "INBOX".

Annotations on multiple mailboxes can be set in a single
SETANNOTATION SETMETADATA

Daboo Expires September 30, 2006 [Page 17]

Internet-Draft IMAP METADATA Extension March 2006

command by using a wildcard specification for the mailbox name.

Example:

C: a SETANNOTATION SETMETADATA INBOX.% /comment
(value.priv "My new comment")
S: a OK SETANNOTATION SETMETADATA complete

In the above example, the entry "/comment" for all mailboxes at
the top-level of the "INBOX" hierarchy are created (if not already
present) and the private attribute "value" are created
respectively for each entry if not already present, or replaced if
they previously existed.

Multiple entries can be set in a single SETANNOTATION SETMETADATA command by
listing entry-attribute-value pairs in the list.

Example:

Daboo Expires May 25, 2006 [Page 13]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005 by
listing entry-attribute-value pairs in the list.

Example:

C: a SETANNOTATION SETMETADATA INBOX (/comment
(value.priv "My new comment")
/thread
(value.prov
(value.priv "REFERENCES ALL"))
S: a OK SETANNOTATION SETMETADATA complete

In the above example, the entry entries "/comment" and "/thread" for all mailboxes at
the top-level of the
mailbox "INBOX" hierarchy are created (if not already present) and the private and shared
"value.priv" attributes "value" are created respectively for each entry if
not already present, or replaced if they previously existed.

Multiple attributes can be set in a single SETANNOTATION SETMETADATA command by
listing multiple attribute-value pairs in the entry list.

Example:

C: a SETANNOTATION SETMETADATA INBOX /comment
(value.priv "My new comment"
value.shared "foo's bar")
S: a OK SETANNOTATION SETMETADATA complete

In the above example, the entry "/comment" for the mailbox "INBOX"
is created (if not already present) and the attributes
"value.priv" and "value.shared" are created if not already
present, or replaced if they previously existed.

Example:

Daboo Expires September 30, 2006 [Page 18]

Internet-Draft IMAP METADATA Extension March 2006

C: a SETANNOTATION SETMETADATA INBOX /comment
(value.priv "My new comment")
S: a NO [ANNOTATEMORE [METADATA TOOMANY] SETANNOTATION SETMETADATA failed

In the above example, the server is unable to set the requested
(new) annotation as it has reached the limit on the number of
annotations it can support on the specified mailbox.

4.4. ANNOTATION

4.5. METADATA Response

The ANNOTATION METADATA response displays results of a GETANNOTATION GETMETADATA command, or
can be returned as an unsolicited response at anytime by the server
in response to a change in an a server annotation.

Servers SHOULD send unsolicited ANNOTATION METADATA responses if mailbox or server
annotations are changed by a third-party, allowing servers to keep
clients updated with changes.

Unsolicited mailbox annotations
MUST only be returned for the currently selected mailbox.

Daboo Expires May 25, 2006 [Page 14]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005

Unsolicited ANNOTATION METADATA responses MUST only contain entry names, not the
attributes and values. If the client wants to update any cached
values it must explicitly retrieve those using a GETANNOTATION
command.

Separate ANNOTATION responses MUST be used when more than one mailbox
matches the mailbox name argument pattern to the GETMETADATA command.

The ANNOTATION METADATA response can contain multiple entries in a single
response, but the server is free to return multiple responses for
each entry or group of entries if it desires.

This response is only available in authenticated or selected state
[RFC3501].

4.4.1. ANNOTATION

4.5.1. METADATA response with attributes and values

The response consists of a list of entries each of which has a list
of attribute-value pairs.

Example:

C: a GETANNOTATION "" GETMETADATA /comment value.priv
S: * ANNOTATION "" METADATA /comment (value.priv "My comment")
S: a OK GETANNOTATION GETMETADATA complete

In the above example, a single entry with a single attribute-value
pair is returned by the server.

Example:

C: a GETANNOTATION "" GETMETADATA (/comment /motd) value.priv
S: * ANNOTATION "" METADATA /comment (value.priv "My comment")
/motd (value.priv "Its sunny outside!")

Daboo Expires September 30, 2006 [Page 19]

Internet-Draft IMAP METADATA Extension March 2006

S: a OK GETANNOTATION GETMETADATA complete

In the above example, two entries each with a single attribute-
value pair is returned by the server.

Example:

C: a GETANNOTATION "" GETMETADATA (/comment /motd) value.priv
S: * ANNOTATION "" METADATA /comment (value.priv "My comment")
S: * ANNOTATION "" METADATA /motd (value.priv "Its sunny outside!")
S: a OK GETANNOTATION GETMETADATA complete

In the above example, the server returns two separate responses
for each of the two entries requested.

Daboo Expires May 25, 2006 [Page 15]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005

Example:

C: a GETANNOTATION "" GETMETADATA /comment (value.priv size.priv)
S: * ANNOTATION "" METADATA /comment (value.priv "My comment"
size.priv "10")
S: a OK GETANNOTATION GETMETADATA complete

In the above example, a single entry with two attribute-value
pairs is returned by the server.

Example:

C: a GETANNOTATION INBOX.% /comment value.priv
S: * ANNOTATION INBOX.1 /comment
(value.priv "My comment for 1")
S: * ANNOTATION INBOX.2 /comment
(value.priv "My comment for 2")
S: * ANNOTATION INBOX.3 /comment
(value.priv "My comment for 3")
S: a OK GETANNOTATION complete

In the above example, separate responses are returned for each
matching mailbox, each containing a single entry with a single
attribute-value pair.

4.4.2.

4.5.2. Unsolicited ANNOTATION METADATA response without attributes and values

The response consists of a parenthesised list of entries, each of
which have changed on the server.

Example:

C: a NOOP
S: * ANNOTATION "" METADATA (/comment)
S: a OK NOOP complete

In the above example, the server indicates that the "/comment"
server entry has been changed.

Example:

C: a NOOP
S: * ANNOTATION "" METADATA (/comment /motd)
S: a OK NOOP complete

In the above example, the server indicates a change to two server
entries.

Daboo Expires May 25, September 30, 2006 [Page 16] 20]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005

Example:

C: a NOOP
S: * ANNOTATION "" (/motd)
S: * ANNOTATION INBOX (/comment)
S: a OK NOOP complete

In the above example, the server indicates a change to a server
entry, and to the an entry for the currently selected mailbox. March 2006

5. Formal Syntax

The following syntax specification uses the Augmented Backus-Naur
Form (ABNF) notation as specified in [RFC2234].

Non-terminals referenced but not defined below are as defined by
[RFC3501] with the new definitions in [I-D.melnikov-imap-ext-abnf]
superseding those in [RFC3501].

Except as noted otherwise, all alphabetic characters are case-
insensitive. The use of upper or lower case characters to define
token strings is for editorial clarity only. Implementations MUST
accept these strings in a case-insensitive fashion.

annotate-data = "ANNOTATION" SP mailbox "METADATA" SP entry-list

att-select = "value" / "value.priv" / "value.shared"
; empty string for mailbox implies
; server annotation. the only attributes that can be selected

att-value = attrib SP value

attrib = astring
; dot-separated attribute name
; MUST NOT contain "*" or "%"

attribs = attrib / "(" attrib *(SP attrib) ")"
; one or more attribute specifiers

capability =/ "ANNOTATEMORE2" "METADATA"
; defines the capability for this extension

command-auth =/ setannotation setmetadata / getannotation getmetadata
; adds to original IMAP command

entries = entry-match /
"(" entry-match *(SP entry-match) ")"
; entry specifiers that can include wildcards

Daboo Expires May 25, 2006 [Page 17]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005

entry = astring
; slash-separated path to entry
; MUST NOT contain "*" or "%"

entry-att = entry SP "(" att-value *(SP att-value) ")"

entry-list = entry-att *(SP entry-att) /
"(" entry *(SP entry) ")"
; entry attribute-value pairs list for
; GETANNOTATION GETMETADATA response, or

Daboo Expires September 30, 2006 [Page 21]

Internet-Draft IMAP METADATA Extension March 2006

; parenthesised entry list for unsolicited
; notification of annotation changes

entry-match = list-mailbox
; slash-separated path to entry
; MAY contain "*" or "%" for use as wildcards

getannotation

getmetadata = "GETANNOTATION" SP list-mailbox "GETMETADATA" SP entries SP attribs

list-select-base-opt =/ "METADATA" SP
"(" list-select-metadata
*(SP list-select-metadata) ")"
; adds a new selection option type to
; LISTEXT. When evaluating multiple entry,
; attribute, value combinations, a match to
; a mailbox must occur when all items match.

list-select-metadata = entry-match SP att-select SP value
; value set to the empty string for list-mailbox implies means match
; server annotation. if that entry and attribute exist.
; value set to NIL means match if that entry
; and attribute do not exist.

response-payload =/ annotate-data
; adds to original IMAP data responses

resp-text-code =/ "ANNOTATEMORE" "METADATA" SP "TOOBIG" ("TOOBIG" /
"ANNOTATEMORE" SP "TOOMANY" /
"NOPRIVATE")
; new response codes for SETANNOTATION SETMETADATA
; failures

setannotation

setmetadata = "SETANNOTATION" "SETMETADATA" SP list-mailbox
SP setentryatt
; empty string for list-mailbox implies
; server annotation.

setentryatt = entry-att / "(" entry-att *(SP entry-att) ")"

value = nstring / literal8

6. IANA Considerations

Entry names MUST be specified in a standards track or IESG approved
experimental RFC, or fall under the vendor namespace. Attribute
names MUST be specified in a standards track or IESG approved
experimental RFC.

Daboo Expires September 30, 2006 [Page 22]

Internet-Draft IMAP METADATA Extension March 2006

Each entry registration MUST include a content-type that is used to

Daboo Expires May 25, 2006 [Page 18]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005
indicate the nature of the annotation value. Where applicable a
charset parameter MUST be included with the content-type.

6.1. Entry and Attribute Registration Template

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[ ] Entry [ ] Attribute

[ ] Mailbox [ ] Server

Name: ______________________________

Description: _______________________

____________________________________

Content-type: ____________________

Contact person: ____________________

email: ____________________

6.2. Server Entry Registrations

The following templates specify the IANA registrations of annotation
entries specified in this document.

Daboo Expires May 25, September 30, 2006 [Page 19] 23]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

6.2.1. /comment

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[x] Entry [ ] Attribute

[ ] Mailbox [x] Server

Name: /comment

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: text/plain; charset=utf-8

Contact person: Cyrus Daboo

email: cyrus@daboo.name

6.2.2. /motd

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[x] Entry [ ] Attribute

[ ] Mailbox [x] Server

Name: /motd

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: text/plain; charset=utf-8

Contact person: Cyrus Daboo

email: cyrus@daboo.name

Daboo Expires May 25, September 30, 2006 [Page 20] 24]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

6.2.3. /admin

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[x] Entry [ ] Attribute

[ ] Mailbox [x] Server

Name: /admin

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: text/plain; charset=utf-8

Contact person: Cyrus Daboo

email: cyrus@daboo.name

6.3. Mailbox Entry Registrations

The following templates specify the IANA registrations of annotation
entries specified in this document.

6.3.1. /comment

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[x] Entry [ ] Attribute

[x] Mailbox [ ] Server

Name: /comment

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: text/plain; charset=utf-8

Contact person: Cyrus Daboo

email: cyrus@daboo.name

Daboo Expires May 25, September 30, 2006 [Page 21] 25]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

6.3.2. /sort

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[x] Entry [ ] Attribute

[x] Mailbox [ ] Server

Name: /sort

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: text/plain; charset=utf-8

Contact person: Cyrus Daboo

email: cyrus@daboo.name

6.3.3. /thread

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[x] Entry [ ] Attribute

[x] Mailbox [ ] Server

Name: /thread

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: text/plain; charset=utf-8

Contact person: Cyrus Daboo

email: cyrus@daboo.name

Daboo Expires May 25, September 30, 2006 [Page 22] 26]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

6.3.4. /check

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[x] Entry [ ] Attribute

[x] Mailbox [ ] Server

Name: /check

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: text/plain; charset=utf-8

Contact person: Cyrus Daboo

email: cyrus@daboo.name

6.3.5. /checkperiod

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[x] Entry [ ] Attribute

[x] Mailbox [ ] Server

Name: /checkperiod

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: text/plain; charset=utf-8

Contact person: Cyrus Daboo

email: cyrus@daboo.name

6.4. Attribute Registrations

The following templates specify the IANA registrations of annotation
attributes specified in this document.

Daboo Expires May 25, September 30, 2006 [Page 23] 27]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

6.4.1. value

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[ ] Entry [x] Attribute

[ ] Mailbox [ ] Server

Name: value

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: -

Contact person: Cyrus Daboo

email: cyrus@daboo.name

6.4.2. size

To: iana@iana.org
Subject: IMAP ANNOTATEMORE METADATA Registration

Please register the following IMAP ANNOTATEMORE METADATA item:

[ ] Entry [x] Attribute

[ ] Mailbox [ ] Server

Name: size

Description: Defined in IMAP ANNOTATEMORE extension document.

Content-type: -

Contact person: Cyrus Daboo

email: cyrus@daboo.name

Daboo Expires May 25, 2006 [Page 24]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005

6.4.3. content-language

To: iana@iana.org
Subject: IMAP ANNOTATEMORE Registration

Please register the following IMAP ANNOTATEMORE item:

[ ] Entry [x] Attribute

[ ] Mailbox [ ] Server

Name: content-language

Description: Defined in IMAP ANNOTATEMORE METADATA extension document.

Content-type: -

Contact person: Cyrus Daboo

email: cyrus@daboo.name

7. Security Considerations

Annotations whose values are intended to remain private MUST use
.priv values, and not .shared values which may be accessible to other
users.

>Excluding

Daboo Expires September 30, 2006 [Page 28]

Internet-Draft IMAP METADATA Extension March 2006

Excluding the above issues the ANNOTATEMORE METADATA extension does not raise any
security considerations that are not present in the base IMAP
protocol, and these issues are discussed in [RFC3501].

8. References

8.1. Normative References

[I-D.ietf-imapext-i18n]
Newman, C., "Internet Message Access Protocol
Internationalization", draft-ietf-imapext-i18n-06 (work in
progress), March 2006.

[I-D.ietf-imapext-list-extensions]
Leiba, B. and A. Melnikov, "IMAP4 LIST Command
Extensions", draft-ietf-imapext-list-extensions-16 (work
in progress), March 2006.

[I-D.ietf-imapext-sort]
Crispin, M. and K. Murchison, "INTERNET MESSAGE ACCESS
PROTOCOL - SORT AND THREAD EXTENSION",
draft-ietf-imapext-sort-17 (work in progress), May 2004.

[I-D.melnikov-imap-ext-abnf]
Daboo, C. and A. Melnikov, "Collected extensions to IMAP4
ABNF", draft-melnikov-imap-ext-abnf-05 draft-melnikov-imap-ext-abnf-08 (work in progress),
October 2005.
January 2006.

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate

Daboo Expires May 25, 2006 [Page 25]

Internet-Draft IMAP ANNOTATEMORE Extension November 2005
Requirement Levels", BCP 14, RFC 2119, March 1997.

[RFC2234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax
Specifications: ABNF", RFC 2234, November 1997.

[RFC2244] Newman, C. and J. Myers, "ACAP -- Application
Configuration Access Protocol", RFC 2244, November 1997.

[RFC3282] Alvestrand, H., "Content Language Headers", RFC 3282,
May 2002.

[RFC3501] Crispin, M., "INTERNET MESSAGE ACCESS PROTOCOL - VERSION
4rev1", RFC 3501, March 2003.

[RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO
10646", STD 63, RFC 3629, November 2003.

8.2. Informative References

[I-D.ietf-imapext-annotate]
Gellens, R. and C. Daboo, "IMAP ANNOTATE Extension",
draft-ietf-imapext-annotate-13

Daboo Expires September 30, 2006 [Page 29]

Internet-Draft IMAP METADATA Extension March 2006

draft-ietf-imapext-annotate-15 (work in progress),
April 2005.
March 2006.

Appendix A. Acknowledgments

The ideas expressed in this document are based on the message
annotation document that was co-authored by Randall Gellens. The
participants of the IMAPext working group made significant
contributions to this work.

Daboo Expires May 25, September 30, 2006 [Page 26] 30]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

Author's Address

Cyrus Daboo

Email: cyrus@daboo.name

Daboo Expires May 25, September 30, 2006 [Page 27] 31]

Internet-Draft IMAP ANNOTATEMORE METADATA Extension November 2005 March 2006

Intellectual Property Statement

The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.

Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.

The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.

Disclaimer of Validity

This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Copyright (C) The Internet Society (2005). (2006). This document is subject
to the rights, licenses and restrictions contained in BCP 78, and
except as set forth therein, the authors retain all their rights.

Acknowledgment

Funding for the RFC Editor function is currently provided by the
Internet Society.

Daboo Expires May 25, September 30, 2006 [Page 28] 32]

----