draft-ietf-extra-imap-list-myrights-00.txt | draft-ietf-extra-imap-list-myrights-01.txt | |||
---|---|---|---|---|
EXTRA K. Murchison | EXTRA K. Murchison | |||
Internet-Draft B. Gondwana | Internet-Draft B. Gondwana | |||
Intended status: Standards Track FastMail | Intended status: Standards Track FastMail | |||
Expires: March 25, 2018 September 21, 2017 | Expires: July 6, 2018 January 2, 2018 | |||
IMAP4 Extension for Returning MYRIGHTS Information in Extended LIST | IMAP4 Extension for Returning MYRIGHTS Information in Extended LIST | |||
draft-ietf-extra-imap-list-myrights-00 | draft-ietf-extra-imap-list-myrights-01 | |||
Abstract | Abstract | |||
This document defines an extension to the to IMAP LIST command that | This document defines an extension to the to IMAP LIST command that | |||
allows the client to request the set of rights that the logged-in | allows the client to request the set of rights that the logged-in | |||
user has been granted on mailboxes, along with other information | user has been granted on mailboxes, along with other information | |||
typically returned by the LIST command. | typically returned by the LIST command. | |||
Status of This Memo | Status of This Memo | |||
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 March 25, 2018. | This Internet-Draft will expire on July 6, 2018. | |||
Copyright Notice | Copyright Notice | |||
Copyright (c) 2017 IETF Trust and the persons identified as the | Copyright (c) 2018 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 | Provisions Relating to IETF Documents | |||
(https://trustee.ietf.org/license-info) in effect on the date of | (https://trustee.ietf.org/license-info) in effect on the date of | |||
publication of this document. Please review these documents | publication of this document. Please review these documents | |||
carefully, as they describe your rights and restrictions with respect | carefully, as they describe your rights and restrictions with respect | |||
to this document. Code Components extracted from this document must | to this document. Code Components extracted from this document must | |||
include Simplified BSD License text as described in Section 4.e of | include Simplified BSD License text as described in Section 4.e of | |||
the Trust Legal Provisions and are provided without warranty as | the Trust Legal Provisions and are provided without warranty as | |||
skipping to change at page 3, line 26 ¶ | skipping to change at page 3, line 26 ¶ | |||
If the server is unable to look up the set of rights for a given | If the server is unable to look up the set of rights for a given | |||
mailbox, it MAY drop the corresponding MYRIGHTS reply. In such a | mailbox, it MAY drop the corresponding MYRIGHTS reply. In such a | |||
situation, the LIST command would still return a tagged OK reply. | situation, the LIST command would still return a tagged OK reply. | |||
4. Examples | 4. Examples | |||
In this example the "bar" mailbox doesn't exist, so it has no | In this example the "bar" mailbox doesn't exist, so it has no | |||
MYRIGHTS reply. | MYRIGHTS reply. | |||
C: A01 LIST "" % RETURN (MYRIGHTS) | C: A01 LIST "" % RETURN (MYRIGHTS) | |||
S: * LIST () "." "INBOX" | S: * LIST () "." "INBOX" | |||
S: * MYRIGHTS "INBOX" lrswipkxtecdan | S: * MYRIGHTS "INBOX" lrswipkxtecdan | |||
S: * LIST () "." "foo" | S: * LIST () "." "foo" | |||
S: * MYRIGHTS "foo" lrs | S: * MYRIGHTS "foo" lrs | |||
S: * LIST (\NonExistent) "." "bar" | S: * LIST (\NonExistent) "." "bar" | |||
S: A01 OK List completed. | S: A01 OK List completed. | |||
In this example the LIST reply for the "foo" mailbox is returned | In this example the LIST reply for the "foo" mailbox is returned | |||
because it has matching children, but no MYRIGHTS reply is returned | because it has matching children, but no MYRIGHTS reply is returned | |||
because "foo" itself doesn't match the selection criteria. | because "foo" itself doesn't match the selection criteria. | |||
C: A02 LIST (SUBSCRIBED RECURSIVEMATCH) "" % RETURN (MYRIGHTS) | C: A02 LIST (SUBSCRIBED RECURSIVEMATCH) "" % RETURN (MYRIGHTS) | |||
S: * LIST (\Subscribed) "." "INBOX" | S: * LIST (\Subscribed) "." "INBOX" | |||
S: * MYRIGHTS "INBOX" lrswipkxtecdan | S: * MYRIGHTS "INBOX" lrswipkxtecdan | |||
S: * LIST () "." "foo" (CHILDINFO ("SUBSCRIBED")) | S: * LIST () "." "foo" (CHILDINFO ("SUBSCRIBED")) | |||
S: A02 OK List completed. | S: A02 OK List completed. | |||
5. Formal Syntax | 5. Formal Syntax | |||
The following syntax specification uses the augmented Backus-Naur | The following syntax specification uses the augmented Backus-Naur | |||
Form (BNF) as described in [RFC5234]. Terms not defined here are | Form (BNF) as described in [RFC5234]. Terms not defined here are | |||
taken from [RFC5258]. | taken from [RFC5258]. | |||
skipping to change at page 4, line 42 ¶ | skipping to change at page 4, line 42 ¶ | |||
MYRIGHTS responses in addition to LIST responses. | MYRIGHTS responses in addition to LIST responses. | |||
Published specification: RFC XXXX, Section 3 | Published specification: RFC XXXX, Section 3 | |||
Security considerations: RFC XXXX, Section 6 | Security considerations: RFC XXXX, Section 6 | |||
Intended usage: COMMON | Intended usage: COMMON | |||
Person and email address to contact for further | Person and email address to contact for further | |||
information: | information: | |||
Kenneth Murchison <murch@andrew.cmu.edu> | Kenneth Murchison <murch@fastmail.com> | |||
Owner/Change controller: IESG <iesg@ietf.org> | Owner/Change controller: IESG <iesg@ietf.org> | |||
9. Acknowledgments | 9. Acknowledgments | |||
This document is based largely on [RFC5819]. The author would like | This document is based largely on [RFC5819]. The author would like | |||
to thank the authors of that document for providing both inspiration | to thank the authors of that document for providing both inspiration | |||
and some borrowed text for this document. | and some borrowed text for this document. | |||
10. References | 10. References | |||
skipping to change at page 5, line 42 ¶ | skipping to change at page 5, line 42 ¶ | |||
10.2. Informative References | 10.2. Informative References | |||
[RFC5819] Melnikov, A. and T. Sirainen, "IMAP4 Extension for | [RFC5819] Melnikov, A. and T. Sirainen, "IMAP4 Extension for | |||
Returning STATUS Information in Extended LIST", RFC 5819, | Returning STATUS Information in Extended LIST", RFC 5819, | |||
DOI 10.17487/RFC5819, March 2010, | DOI 10.17487/RFC5819, March 2010, | |||
<https://www.rfc-editor.org/info/rfc5819>. | <https://www.rfc-editor.org/info/rfc5819>. | |||
Appendix A. Change History (To be removed by RFC Editor before | Appendix A. Change History (To be removed by RFC Editor before | |||
publication) | publication) | |||
Changes from draft-ietf-extra-imap-list-myrights-00: | ||||
o Corrected contact email address in IANA registration. | ||||
o Fixed typos (extra SP) in examples. | ||||
Changes from draft-murchison-imap-list-myrights-01: | Changes from draft-murchison-imap-list-myrights-01: | |||
o Renamed document to be a work product of the EXTRA WG. | o Renamed document to be a work product of the EXTRA WG. | |||
o Updated authors' addresses. | o Updated authors' addresses. | |||
Changes from draft-murchison-imap-list-myrights-00: | Changes from draft-murchison-imap-list-myrights-00: | |||
o Augmented Introduction with mention of "LIST-MYRIGHTS" capability | o Augmented Introduction with mention of "LIST-MYRIGHTS" capability | |||
string. | string. | |||
End of changes. 8 change blocks. | ||||
7 lines changed or deleted | 13 lines changed or added | |||
This html diff was produced by rfcdiff 1.46. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ |