draft-ietf-extra-sieve-action-registry-00.txt | draft-ietf-extra-sieve-action-registry-01.txt | |||
---|---|---|---|---|
Network Working Group A. Melnikov | Network Working Group A. Melnikov | |||
Internet-Draft Isode Ltd | Internet-Draft Isode Ltd | |||
Updates: 5228 (if approved) 19 August 2021 | Updates: 5228 (if approved) 3 March 2022 | |||
Intended status: Standards Track | Intended status: Standards Track | |||
Expires: 20 February 2022 | Expires: 4 September 2022 | |||
IANA registry for Sieve actions | IANA registry for Sieve actions | |||
draft-ietf-extra-sieve-action-registry-00 | draft-ietf-extra-sieve-action-registry-01 | |||
Abstract | Abstract | |||
This document creates a registry of Sieve (RFC 5228) actions in order | This document creates a registry of Sieve (RFC 5228) actions in order | |||
to help developers and Sieve extension writers track interactions | to help developers and Sieve extension writers track interactions | |||
between different extensions. | between different extensions. | |||
Status of This Memo | Status of This Memo | |||
This Internet-Draft is submitted in full conformance with the | This Internet-Draft is submitted in full conformance with the | |||
skipping to change at page 1, line 33 ¶ | skipping to change at page 1, line 33 ¶ | |||
Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
Task Force (IETF). Note that other groups may also distribute | Task Force (IETF). Note that other groups may also distribute | |||
working documents as Internet-Drafts. The list of current Internet- | working documents as Internet-Drafts. The list of current Internet- | |||
Drafts is at https://datatracker.ietf.org/drafts/current/. | Drafts is at https://datatracker.ietf.org/drafts/current/. | |||
Internet-Drafts are draft documents valid for a maximum of six months | Internet-Drafts are draft documents valid for a maximum of six months | |||
and may be updated, replaced, or obsoleted by other documents at any | and may be updated, replaced, or obsoleted by other documents at any | |||
time. It is inappropriate to use Internet-Drafts as reference | time. It is inappropriate to use Internet-Drafts as reference | |||
material or to cite them other than as "work in progress." | material or to cite them other than as "work in progress." | |||
This Internet-Draft will expire on 20 February 2022. | This Internet-Draft will expire on 4 September 2022. | |||
Copyright Notice | Copyright Notice | |||
Copyright (c) 2021 IETF Trust and the persons identified as the | Copyright (c) 2022 IETF Trust and the persons identified as the | |||
document authors. All rights reserved. | document authors. All rights reserved. | |||
This document is subject to BCP 78 and the IETF Trust's Legal | This document is subject to BCP 78 and the IETF Trust's Legal | |||
Provisions Relating to IETF Documents (https://trustee.ietf.org/ | Provisions Relating to IETF Documents (https://trustee.ietf.org/ | |||
license-info) in effect on the date of publication of this document. | license-info) in effect on the date of publication of this document. | |||
Please review these documents carefully, as they describe your rights | Please review these documents carefully, as they describe your rights | |||
and restrictions with respect to this document. Code Components | and restrictions with respect to this document. Code Components | |||
extracted from this document must include Simplified BSD License text | extracted from this document must include Revised BSD License text as | |||
as described in Section 4.e of the Trust Legal Provisions and are | described in Section 4.e of the Trust Legal Provisions and are | |||
provided without warranty as described in the Simplified BSD License. | provided without warranty as described in the Revised BSD License. | |||
Table of Contents | Table of Contents | |||
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 | |||
2. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 2 | 2. Conventions Used in This Document . . . . . . . . . . . . . . 2 | |||
3. Security Considerations . . . . . . . . . . . . . . . . . . . 3 | 3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 2 | |||
4. Normative References . . . . . . . . . . . . . . . . . . . . 3 | 4. Security Considerations . . . . . . . . . . . . . . . . . . . 3 | |||
5. Normative References . . . . . . . . . . . . . . . . . . . . 3 | ||||
Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 3 | Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 3 | |||
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 3 | Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 4 | |||
1. Introduction | 1. Introduction | |||
Sieve Email Filtering Language [RFC5228] is a popular email filtering | Sieve Email Filtering Language [RFC5228] is a popular email filtering | |||
language used upon final mail delivery. Popularity of Sieve resulted | language used upon final mail delivery. Popularity of Sieve resulted | |||
in a myriad of Sieve extensions that can interact with each other in | in a myriad of Sieve extensions that can interact with each other in | |||
wonderful and complex ways. There is currently no easy way to find | wonderful and complex ways. There is currently no easy way to find | |||
out all actions defined by Sieve extensions published in RFCs, which | out all actions defined by Sieve extensions published in RFCs, which | |||
make it quite difficult for Sieve extension writers and Sieve | make it quite difficult for Sieve extension writers and Sieve | |||
implementation developers to forsee interactions between Sieve | implementation developers to forsee interactions between Sieve | |||
actions. | actions. | |||
This document creates a registry of Sieve [RFC5228] actions in order | This document creates a registry of Sieve [RFC5228] actions in order | |||
to help developers and Sieve extension writers track interactions | to help developers and Sieve extension writers track interactions | |||
between different extensions. | between different extensions. | |||
2. IANA Considerations | 2. Conventions Used in This Document | |||
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | ||||
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and | ||||
"OPTIONAL" in this document are to be interpreted as described in BCP | ||||
14 [RFC2119] [RFC8174] when, and only when, they appear in all | ||||
capitals, as shown here. | ||||
3. IANA Considerations | ||||
IANA is requested to create a new registry for Sieve actions (see | IANA is requested to create a new registry for Sieve actions (see | |||
Section 2.9 of [RFC5228] for details on Sieve actions). Registration | Section 2.9 of [RFC5228] for details on Sieve actions). Registration | |||
of both actions specified in IETF Stream RFCs and vendor specific | of both actions specified in IETF Stream RFCs and vendor specific | |||
actions is allowed and encouraged. The registration template | actions is allowed and encouraged. The registration template | |||
contains 1) name of the action; 2) short description; 3) references: | contains 1) name of the action; 2) short description; 3) references: | |||
one or more documents describing the action and any significant | one or more documents describing the action and any significant | |||
updates to its definition (this field is REQUIRED for actions | updates to its definition (this field is REQUIRED for actions | |||
described in RFCs and optional otherwise); 4) name(s) of Sieve | described in RFCs and OPTIONAL otherwise); 4) name(s) of Sieve | |||
capabilit(ies) associated with the Sieve action being registered; 5) | capabilit(ies) associated with the Sieve action being registered; 5) | |||
interactions with other Sieve actions, if any; 6) flag specifying | interactions with other Sieve actions, if any; 6) flag specifying | |||
whether the action cancels implicit keep (see Section 2.10.2 of | whether the action cancels the implicit keep (see Section 2.10.2 of | |||
[RFC5228]); 7) whether or not this action can be used with IMAP | [RFC5228]); 7) whether or not this action can be used with IMAP | |||
events in Sieve ([RFC6785]), and 8) optional comment. | events in Sieve ([RFC6785]), and 8) optional comment. | |||
Registration procedure for this registry is Expert Review. The | Registration procedure for this registry is Expert Review. The | |||
Designated Expert only checks that the name of the action being | Designated Expert only checks that the name of the action being | |||
registered matches documentation, that the description field is | registered matches documentation, that the description field is | |||
accurate, that the correct documents are referenced and that the list | accurate, that the correct documents are referenced and that the list | |||
of relevant documents is as complete as possible. The Designated | of relevant documents is as complete as possible. The Designated | |||
Expert can't reject a registration based on personal dislike of the | Expert can't reject a registration based on personal dislike of the | |||
document defining an action and should always err on the side of | document defining an action and should always err on the side of | |||
registering, even if documentation is not complete. | registering, even if documentation is not complete. | |||
Addition of a new reference or change to the description field goes | Addition of a new reference to an existing registration or change to | |||
through the same registration procedure as a new registration. | the description field goes through the same registration procedure as | |||
a new registration. | ||||
3. Security Considerations | 4. Security Considerations | |||
The sole purpose of this document is to create a new IANA registry, | The sole purpose of this document is to create a new IANA registry, | |||
so it doesn't create new security considerations for Sieve | so it doesn't create new security considerations for Sieve | |||
implementations. | implementations. | |||
The new registry should help Sieve extension writers and Sieve | The new registry should help Sieve extension writers and Sieve | |||
implementors track interactions between different Sieve actions, so | implementors track interactions between different Sieve actions, so | |||
it might improve quality of specifications and implementations, | it might improve quality of specifications and implementations, | |||
including security aspects. | including security aspects. | |||
4. Normative References | 5. Normative References | |||
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | |||
Requirement Levels", BCP 14, RFC 2119, | Requirement Levels", BCP 14, RFC 2119, | |||
DOI 10.17487/RFC2119, March 1997, | DOI 10.17487/RFC2119, March 1997, | |||
<https://www.rfc-editor.org/info/rfc2119>. | <https://www.rfc-editor.org/info/rfc2119>. | |||
[RFC5228] Guenther, P., Ed. and T. Showalter, Ed., "Sieve: An Email | [RFC5228] Guenther, P., Ed. and T. Showalter, Ed., "Sieve: An Email | |||
Filtering Language", RFC 5228, DOI 10.17487/RFC5228, | Filtering Language", RFC 5228, DOI 10.17487/RFC5228, | |||
January 2008, <https://www.rfc-editor.org/info/rfc5228>. | January 2008, <https://www.rfc-editor.org/info/rfc5228>. | |||
[RFC6785] Leiba, B., "Support for Internet Message Access Protocol | [RFC6785] Leiba, B., "Support for Internet Message Access Protocol | |||
(IMAP) Events in Sieve", RFC 6785, DOI 10.17487/RFC6785, | (IMAP) Events in Sieve", RFC 6785, DOI 10.17487/RFC6785, | |||
November 2012, <https://www.rfc-editor.org/info/rfc6785>. | November 2012, <https://www.rfc-editor.org/info/rfc6785>. | |||
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC | ||||
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, | ||||
May 2017, <https://www.rfc-editor.org/info/rfc8174>. | ||||
Appendix A. Acknowledgements | Appendix A. Acknowledgements | |||
TBD. | TBD. | |||
Author's Address | Author's Address | |||
Alexey Melnikov | Alexey Melnikov | |||
Isode Ltd | Isode Ltd | |||
14 Castle Mews | 14 Castle Mews | |||
Hampton | Hampton | |||
End of changes. 15 change blocks. | ||||
19 lines changed or deleted | 33 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ |