IMAP Extensions: Quick Flag Changes Resynchronization (CONDSTORE) and Quick Mailbox Resynchronization (QRESYNC)
RFC 7162
| Document | Type |
RFC - Proposed Standard
(May 2014; Errata)
Updates RFC 2683
|
|
|---|---|---|---|
| Last updated | 2018-12-20 | ||
| Replaces | draft-ietf-qresync-rfc4551bis, draft-melnikov-5162bis | ||
| Stream | IETF | ||
| Formats | plain text html pdf htmlized with errata bibtex | ||
| Reviews | |||
| Stream | WG state | Submitted to IESG for Publication | |
| Document shepherd | Eliot Lear | ||
| Shepherd write-up | Show (last changed 2014-01-09) | ||
| IESG | IESG state | RFC 7162 (Proposed Standard) | |
| Consensus Boilerplate | Yes | ||
| Telechat date | |||
| Responsible AD | Barry Leiba | ||
| Send notices to | (None) | ||
| IANA | IANA review state | IANA OK - Actions Needed | |
| IANA action state | RFC-Ed-Ack | ||
Internet Engineering Task Force (IETF) A. Melnikov
Request for Comments: 7162 Isode Ltd
Obsoletes: 4551, 5162 D. Cridland
Updates: 2683 Surevine Ltd
Category: Standards Track May 2014
ISSN: 2070-1721
IMAP Extensions: Quick Flag Changes Resynchronization (CONDSTORE)
and Quick Mailbox Resynchronization (QRESYNC)
Abstract
Often, multiple IMAP (RFC 3501) clients need to coordinate changes to
a common IMAP mailbox. Examples include different clients working on
behalf of the same user and multiple users accessing shared
mailboxes. These clients need a mechanism to efficiently synchronize
state changes for messages within the mailbox.
Initially defined in RFC 4551, the Conditional Store facility
provides a protected update mechanism for message state information
and a mechanism for requesting only changes to the message state.
This memo updates that mechanism and obsoletes RFC 4551, based on
operational experience.
This document additionally updates another IMAP extension, Quick
Resynchronization, which builds on the Conditional STORE extension to
provide an IMAP client the ability to fully resynchronize a mailbox
as part of the SELECT/EXAMINE command, without the need for
additional server-side state or client round trips. Hence, this memo
obsoletes RFC 5162.
Finally, this document also updates the line-length recommendation in
Section 3.2.1.5 of RFC 2683.
Status of This Memo
This is an Internet Standards Track document.
This document is a product of the Internet Engineering Task Force
(IETF). It represents the consensus of the IETF community. It has
received public review and has been approved for publication by the
Internet Engineering Steering Group (IESG). Further information on
Internet Standards is available in Section 2 of RFC 5741.
Information about the current status of this document, any errata,
and how to provide feedback on it may be obtained at
http://www.rfc-editor.org/info/rfc7162.
Melnikov & Cridland Standards Track [Page 1]
RFC 7162 IMAP CONDSTORE & QRESYNC May 2014
Copyright Notice
Copyright (c) 2014 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
(http://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 extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
This document may contain material from IETF Documents or IETF
Contributions published or made publicly available before November
10, 2008. The person(s) controlling the copyright in some of this
material may not have granted the IETF Trust the right to allow
modifications of such material outside the IETF Standards Process.
Without obtaining an adequate license from the person(s) controlling
the copyright in such materials, this document may not be modified
outside the IETF Standards Process, and derivative works of it may
not be created outside the IETF Standards Process, except to format
it for publication as an RFC or to translate it into languages other
than English.
Melnikov & Cridland Standards Track [Page 2]
RFC 7162 IMAP CONDSTORE & QRESYNC May 2014
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 4
2. Requirements Notation . . . . . . . . . . . . . . . . . . . . 5
3. IMAP Protocol Changes . . . . . . . . . . . . . . . . . . . . 5
3.1. CONDSTORE Extension . . . . . . . . . . . . . . . . . . . 5
3.1.1. Advertising Support for CONDSTORE . . . . . . . . . . 8
3.1.2. New OK Untagged Responses for SELECT and EXAMINE . . 8
3.1.3. STORE and UID STORE Commands . . . . . . . . . . . . 10
3.1.4. FETCH and UID FETCH Commands . . . . . . . . . . . . 16
3.1.5. MODSEQ Search Criterion in SEARCH . . . . . . . . . . 19
3.1.6. Modified SEARCH Untagged Response . . . . . . . . . . 20
3.1.7. HIGHESTMODSEQ Status Data Items . . . . . . . . . . . 21
3.1.8. CONDSTORE Parameter to SELECT and EXAMINE . . . . . . 21
3.1.9. Interaction with IMAP SORT and THREAD Extensions . . 22
3.1.10. Interaction with IMAP ESORT and ESEARCH Extensions . 22
Show full document text