The IMAP Move Extension
draft-ietf-imapmove-command-01

The information below is for an old version of the document
Document Type Active Internet-Draft (imapmove WG)
Last updated 2012-07-30
Replaces draft-gulbrandsen-imap-move
Stream IETF
Intended RFC status (None)
Formats plain text pdf html
Stream WG state WG Document
Document shepherd None
IESG IESG state I-D Exists
Telechat date
Responsible AD (None)
Send notices to (None)
Network Working Group                                   Arnt Gulbrandsen
Internet-Draft                                                 July 2012
Intended Status: Standards Track

                        The IMAP Move Extension
                   draft-ietf-imapmove-command-01.txt

Status of this Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Copyright (c) 2012 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.

   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 expires in January 2013.

Gulbrandsen               Expires December 2012                 [Page 1]
Internet-draft                                                 July 2012

Abstract

   The MOVE extension provides commands to move one or more messages
   from the selected mailbox to a named mailbox.

1. Conventions Used in This Document

   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].

   Formal syntax is defined by [RFC5234].

   Example lines prefaced by "C:" are sent by the client and ones
   prefaced by "S:" by the server.

2. Overview

   This document defines an IMAP extension to move messages from one
   mailbox to another. This function (very common in MUA UIs) is not
   provided by stock IMAP, and clients have to use a combination of UID
   STORE, UID COPY and EXPUNGE, and cope with partial failures and side
   effects.

3. MOVE and UID MOVE

   The UID MOVE command takes two arguments: a set of UIDs and a named
   mailbox. The MOVE command takes a set of MSNs and a named mailbox.
   Both commands move each message included in the set to the named
   mailbox.

   The UID MOVE command has the same effect as a sequence of UID COPY,
   UID STORE +FLAGS.SILENT \DELETED and UID EXPUNGE, with the added
   requirement that each message SHOULD either be moved or unaffected.
   The server SHOULD NOT leave a message in neither or both mailboxes
   afterwards (even if the server returns a tagged NO response).

   UID MOVE is the same as the three-command sequence in all other
   respects, which implies that extensions which affect the three-
   command sequence also affect UID MOVE, and that response codes such
   as COPYUID, TRYCREATE and so on should be sent as appropriate.

Gulbrandsen               Expires December 2012                 [Page 2]
Internet-draft                                                 July 2012

   An example:
        C: a UID MOVE 42:69 forble
        S: * OK [COPYUID 432432 42:69 1202:1229]
        S: * 22 EXPUNGE
        S: (more expunges)
        S: a OK Done

   Note that the server may send EXPUNGEs for other messages as well, if
   any happen to have been expunged at the same time.

   Implementers will need to read [RFC4315] to understand what UID
   EXPUNGE does. Implementing [RFC4315] is not necessary.

   Note that moving messages to the current mailbox is well-defined, so
   that MOVE is defined for all the cases where the COPY/STORE/EXPUNGE
   sequence is.

   The MOVE command performs the same actions UID MOVE. Notably, the
   server may send EXPUNGE (or VANISHED) messages before the tagged
   response, so the client cannot safely send more commands with MSN
   arguments while the server is processing MOVE.
Show full document text