Internet DRAFT - draft-murchison-imap-esearch-return-opt-registry
draft-murchison-imap-esearch-return-opt-registry
EXTRA K. Murchison
Internet-Draft Fastmail
Intended status: Informational 6 December 2022
Expires: 9 June 2023
IANA Registry for IMAP Extended SEARCH Return Options and Data Tags
draft-murchison-imap-esearch-return-opt-registry-00
Abstract
This document creates a registry of IMAP Extended Search Return
Options and Data Tags (RFC 4466) in order to help developers and IMAP
extension writers track interactions between different extensions.
Open Issues
* Is Expert Review the correct registration policy?
* Should we also add a registry of SEARCH criteria?
Status of This Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/.
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."
This Internet-Draft will expire on 9 June 2023.
Copyright Notice
Copyright (c) 2022 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents (https://trustee.ietf.org/
license-info) in effect on the date of publication of this document.
Please review these documents carefully, as they describe your rights
and restrictions with respect to this document. Code Components
Murchison Expires 9 June 2023 [Page 1]
Internet-Draft ESEARCH Return Opt & Data Tag Registry December 2022
extracted from this document must include Revised BSD License text as
described in Section 4.e of the Trust Legal Provisions and are
provided without warranty as described in the Revised BSD License.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
2. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 2
2.1. IMAP ESEARCH Return Option and Data Tag Registration
Template and Procedure . . . . . . . . . . . . . . . . . 2
2.2. Initial IMAP ESEARCH Return Option and Data Tag
Registry . . . . . . . . . . . . . . . . . . . . . . . . 3
3. Security Considerations . . . . . . . . . . . . . . . . . . . 5
4. References . . . . . . . . . . . . . . . . . . . . . . . . . 5
4.1. Normative References . . . . . . . . . . . . . . . . . . 5
4.2. Informative References . . . . . . . . . . . . . . . . . 6
Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 7
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 7
1. Introduction
The Internet Message Access Protocol (IMAP) [RFC3501], [RFC9051] is
used for accessing and manipulating email messages on a server. Over
the years, the syntax of the IMAP SEARCH command has been extended to
include return options and corresponding return data in the response
[RFC4466]. There is currently no easy way to find out all of the
return options and data tags defined by IMAP extensions published in
RFCs, which makes it quite difficult for IMAP extension writers and
IMAP implementation developers to forsee interactions between such
extensions.
This document creates a registry of IMAP Extended Search Return
Options and Data Tags in order to help developers and IMAP extension
writers track interactions between different extensions.
2. IANA Considerations
2.1. IMAP ESEARCH Return Option and Data Tag Registration Template and
Procedure
IANA is requested to create a new registry for IMAP ESEARCH Return
Options and Data Tags. Registration of both options/tags specified
in IETF Stream RFCs and vendor specific actions is allowed and
encouraged. The registration template contains:
1. name of the return option;
2. any implied return data tags;
Murchison Expires 9 June 2023 [Page 2]
Internet-Draft ESEARCH Return Opt & Data Tag Registry December 2022
3. short description;
4. references: one or more documents describing the option/tag and
any significant updates to its definition (this field is required
for option/tag described in RFCs and is optional otherwise);
The registration procedure for this registry is Expert Review, per
[RFC8126], Section 4.5. The Designated Expert only checks that the
name of the return option or return data tag being registered matches
the documentation, that the description field is accurate, that the
correct documents are referenced and that the list of relevant
documents is as complete as possible. The Designated Expert can't
reject a registration based on personal dislike of the document
defining a return option or return data tag and should always err on
the side of registering, even if documentation is not complete.
Addition of a new reference to an existing registration or change to
the description field goes through the same registration procedure as
a new registration.
2.2. Initial IMAP ESEARCH Return Option and Data Tag Registry
The following table is used to initialize the return option and data
tag registry.
+=========+==========+=============+===============================+
|Return |Implied |Description | References |
|Option |Return | | |
|Name |Data Tags | | |
+=========+==========+=============+===============================+
|ALL |ALL |Return all | [RFC4731] (Section 3.1), |
| | |message | [RFC9051] (Section 6.4.4) |
| | |numbers/UIDs | |
| | |that satisfy | |
| | |the SEARCH | |
| | |criteria. | |
+---------+----------+-------------+-------------------------------+
|CONTEXT | |Indicate that| [RFC5267] (Section 4.2) |
| | |subsequent | |
| | |use of the | |
| | |SEARCH | |
| | |criteria are | |
| | |likely. | |
+---------+----------+-------------+-------------------------------+
|COUNT |COUNT |Return number| [RFC4731] (Section 3.1), |
| | |of the | [RFC9051] (Section 6.4.4) |
| | |messages that| |
| | |satisfy the | |
Murchison Expires 9 June 2023 [Page 3]
Internet-Draft ESEARCH Return Opt & Data Tag Registry December 2022
| | |SEARCH | |
| | |criteria. | |
+---------+----------+-------------+-------------------------------+
|MAX |MAX |Return the | [RFC4731] (Section 3.1), |
| | |highest | [RFC9051] (Section 6.4.4) |
| | |message | |
| | |number/UID | |
| | |that | |
| | |satisfies the| |
| | |SEARCH | |
| | |criteria | |
+---------+----------+-------------+-------------------------------+
|MIN |MIN |Return the | [RFC4731] (Section 3.1), |
| | |lowest | [RFC9051] (Section 6.4.4) |
| | |message | |
| | |number/UID | |
| | |that | |
| | |satisfies the| |
| | |SEARCH | |
| | |criteria. | |
+---------+----------+-------------+-------------------------------+
|* |MODSEQ |The highest | [RFC4731] (Section 3.2), |
| | |mod-sequence | [RFC7162] (Section 3.1.5) |
| | |of all | |
| | |messages in | |
| | |the set that | |
| | |satisfy the | |
| | |SEARCH | |
| | |criteria and | |
| | |result | |
| | |options. | |
+---------+----------+-------------+-------------------------------+
|PARTIAL |PARTIAL |Return a | [RFC5267] (Section 4.4), |
| | |subset of the| [I-D.ietf-extra-imap-partial] |
| | |message | (Section 3.1) |
| | |numbers/UIDs | |
| | |that satisfy | |
| | |the SEARCH | |
| | |criteria. | |
+---------+----------+-------------+-------------------------------+
|RELEVANCY|RELEVANCY |Return a | [RFC6203] (Section 4) |
| | |relevancy | |
| | |score for | |
| | |each message | |
| | |that | |
| | |satisfies the| |
| | |SEARCH | |
| | |criteria. | |
Murchison Expires 9 June 2023 [Page 4]
Internet-Draft ESEARCH Return Opt & Data Tag Registry December 2022
+---------+----------+-------------+-------------------------------+
|SAVE | |Set the value| [RFC5182] (Section 2), |
| | |of the search| [RFC9051] (Section 6.4.4) |
| | |result | |
| | |variable to | |
| | |the set of | |
| | |message | |
| | |numbers/UIDs | |
| | |that satisfy | |
| | |the SEARCH | |
| | |criteria. | |
+---------+----------+-------------+-------------------------------+
|UPDATE |ADDTO, |Request | [RFC5267] (Section 4.3) |
| |REMOVEFROM|unsolicited | |
| | |notifications| |
| | |of updates to| |
| | |the set of | |
| | |messages that| |
| | |satisfy the | |
| | |SEARCH | |
| | |criteria. | |
+---------+----------+-------------+-------------------------------+
|* Any set of return options (including the empty set) plus the |
|MODSEQ SEARCH criteria. |
+------------------------------------------------------------------+
Table 1
3. Security Considerations
The sole purpose of this document is to create a new IANA registry,
so it doesn't create new security considerations for IMAP
implementations.
The new registry should help IMAP extension writers and IMAP
implementors track interactions between different IMAP extensions, so
it might improve quality of specifications and implementations,
including security aspects.
4. References
4.1. Normative References
[RFC8126] Cotton, M., Leiba, B., and T. Narten, "Guidelines for
Writing an IANA Considerations Section in RFCs", BCP 26,
RFC 8126, DOI 10.17487/RFC8126, June 2017,
<https://www.rfc-editor.org/info/rfc8126>.
Murchison Expires 9 June 2023 [Page 5]
Internet-Draft ESEARCH Return Opt & Data Tag Registry December 2022
4.2. Informative References
[RFC3501] Crispin, M., "INTERNET MESSAGE ACCESS PROTOCOL - VERSION
4rev1", RFC 3501, DOI 10.17487/RFC3501, March 2003,
<https://www.rfc-editor.org/info/rfc3501>.
[RFC4466] Melnikov, A. and C. Daboo, "Collected Extensions to IMAP4
ABNF", RFC 4466, DOI 10.17487/RFC4466, April 2006,
<https://www.rfc-editor.org/info/rfc4466>.
[RFC4731] Melnikov, A. and D. Cridland, "IMAP4 Extension to SEARCH
Command for Controlling What Kind of Information Is
Returned", RFC 4731, DOI 10.17487/RFC4731, November 2006,
<https://www.rfc-editor.org/info/rfc4731>.
[RFC5182] Melnikov, A., "IMAP Extension for Referencing the Last
SEARCH Result", RFC 5182, DOI 10.17487/RFC5182, March
2008, <https://www.rfc-editor.org/info/rfc5182>.
[RFC5267] Cridland, D. and C. King, "Contexts for IMAP4", RFC 5267,
DOI 10.17487/RFC5267, July 2008,
<https://www.rfc-editor.org/info/rfc5267>.
[RFC6203] Sirainen, T., "IMAP4 Extension for Fuzzy Search",
RFC 6203, DOI 10.17487/RFC6203, March 2011,
<https://www.rfc-editor.org/info/rfc6203>.
[RFC7162] Melnikov, A. and D. Cridland, "IMAP Extensions: Quick Flag
Changes Resynchronization (CONDSTORE) and Quick Mailbox
Resynchronization (QRESYNC)", RFC 7162,
DOI 10.17487/RFC7162, May 2014,
<https://www.rfc-editor.org/info/rfc7162>.
[RFC9051] Melnikov, A., Ed. and B. Leiba, Ed., "Internet Message
Access Protocol (IMAP) - Version 4rev2", RFC 9051,
DOI 10.17487/RFC9051, August 2021,
<https://www.rfc-editor.org/info/rfc9051>.
[I-D.ietf-extra-imap-partial]
Melnikov, A., Achuthan, A., Nagulakonda, V., and L. Alves,
"IMAP Paged SEARCH & FETCH Extension", Work in Progress,
Internet-Draft, draft-ietf-extra-imap-partial-03, 5
December 2022, <https://www.ietf.org/archive/id/draft-
ietf-extra-imap-partial-03.txt>.
[I-D.ietf-extra-sieve-action-registry]
Melnikov, A. and K. Murchison, "IANA registry for Sieve
actions", Work in Progress, Internet-Draft, draft-ietf-
Murchison Expires 9 June 2023 [Page 6]
Internet-Draft ESEARCH Return Opt & Data Tag Registry December 2022
extra-sieve-action-registry-04, 15 August 2022,
<https://www.ietf.org/archive/id/draft-ietf-extra-sieve-
action-registry-04.txt>.
Appendix A. Acknowledgements
Portions of the text in the document have been borrowed from
[I-D.ietf-extra-sieve-action-registry].
Author's Address
Kenneth Murchison
Fastmail US LLC
1429 Walnut Street - Suite 1201
Philadelphia, PA 19102
United States of America
Email: murch@fastmailteam.com
Murchison Expires 9 June 2023 [Page 7]
