Network Working Group S. Hole Internet Draft: IMAP4 Channel Transport Mechanism L. Nerenberg Document: draft-nerenberg-imap-channel-00.txt ACI/Messagingdirect B. Leiba IBM Research February 2001 IMAP4 Channel Transport Mechanism Status of this memo This document is an Internet Draft and is in full conformance with all provisions of Section 10 of RFC 2026. 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.rq 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. A revised version of this draft document will be submitted to the RFC editor as a Proposed Standard for the Internet Community. Discussion and suggestions for improvement are requested. Distribution of this draft is unlimited. 0. Administrivia Lines prefixed with ">>>" are meta-comments. 1. Abstract IMAP4 is being used to serve rich media content in environments that extend beyond traditional text-based e-mail. One example is a cellular telephone that can retrieve and send MIME-encoded audio data through IMAP4. While this type of content can be exchanged natively using IMAP4, some applications will work better if the message content can be manipulated using schemes external to the IMAP4 connection. In our cellular telephone example, it might be preferable for the telephone client to retrieve the audio data using RTSP. This specifications defines a mechanism for an IMAP4 Nerenberg draft-nerenberg-imap-channel-00.txt [Page 1] Internet Draft IMAP4 Channel Transport Mechanism February 2001 client to request message content from a server through an external scheme. 2. Conventions Used in this Document The key words "MUST," "MUST NOT," "SHOULD," "SHOULD NOT," and "MAY" in this document are to be interpreted as described in [KEYWORD]. In examples, "C:" and "S:" preface lines sent by the client and the server respectively. 3. Overview 4. Protocol Framework This memo defines the following extensions to [IMAP4]. 4.1. CAPABILITY Identification IMAP4 servers that support this extension MUST include a CHANNEL capability response in the response list to the CAPABILITY command. This entry indicates the server supports the extension, and lists the external schemes available to the CHANNEL command. The capabil- ity response consists of the string "CHANNEL=" followed by a comma- seperated list of CHANNEL services. >>> e.g. CHANNEL=rtsp,imap >>> >>> Is this comma-list syntax going to mess things up for >>> parsers? We prefer it because it's more compact than >>> CHANNEL=rtsp CHANNEL=imap (AUTH-style lists). 4.2. CHANNEL Command The CHANNEL command requests that message data be retrieved through an external scheme. The scheme is specified using a URI [URI]. Clients may issue a partially-qualified URI, in which case the server will determine the final connection end-point. What consti- tutes a partially-qualified URI is implementation defined, however every URI MUST contain at least a scheme. The syntax of the CHANNEL command is: tag CHANNEL uri_list msg_set uri_list is a list of URIs specifying the locations where the client is willing to retrieve the message data. If the list con- tains more than one element the server must enumerate the list in order and SHOULD return the message data via the first URI it is capable of using. >>> the intent is that the client can indicate a list of >>> services in descending order of usefulness/quality. Nerenberg draft-nerenberg-imap-channel-00.txt [Page 2] Internet Draft IMAP4 Channel Transport Mechanism February 2001 >>> Also, there is no guarantee that a server can express >>> a particular body section through all of its advertised >>> schemes, thus the list provides fallback for the server >>> as well as the client. msg_set is a list of messages and body sections to be retrieved through the specified URI. >>> example syntax: >>> >>> 0 CHANNEL ("rtsp:" "imap:") (1 (body[2])) (3 (body[1] body[9])) >>> >>> asks for section 2 of message 1 and section 1 of message >>> 3 via RTSP. If RTSP isn't available/usable, try IMAP. In >>> either case, the server will fill in the connection end-point >>> information. 4.3. CHANNEL Response The CHANNEL response returns connection status and location infor- mation to the client. One untagged response is returned for each body section requested. >>> example response to above command: >>> >>> S: * 1 CHANNEL ((body[2]) "rtsp://example.com/1441243") >>> S: * 3 CHANNEL ((body[1]) >>> S: "imap://user@imap.example.com:/inbox;uidvalidity=2/;uid=33") >>> S: * 3 CHANNEL ((body[9]) NIL) >>> S: 0 OK done >>> >>> The NIL response to the body[9] indicates that the part could not >>> be retrieved via either of the requested schemes. This could >>> be caused by the inability to convert or represent the content >>> through the schemes, or because some resource was unavailable. 5. Formal Protocol Syntax The following syntax specification uses the augmented Backus-Naur Form (BNF) notation as used in [IMAP4]. Except as noted otherwise, all alphabetic characters are case- insensitive. The use of upper or lower case characters to define token strings is for editorial clarity only. Implementations MUST accept these strings in a case-insensitive fashion. This syntax extends the grammar specified in [IMAP4]. >>> TO BE DONE 6. References [IMAP4] Crispin, M., "Internet Message Access Protocol Version 4rev1," RFC2060, University of Washington, December 1996 Nerenberg draft-nerenberg-imap-channel-00.txt [Page 3] Internet Draft IMAP4 Channel Transport Mechanism February 2001 [URI] Berners-Lee, T., et al, "Uniform Resource Identifiers (URI): Generic Syntax," RFC2396, August 1998 [KEYWORD] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels," BCP 9, RFC2119, March 1997 7. Security Considerations 8. Authors' Addresses Lyndon Nerenberg Steve Hole ACI/MessagingDirect ACI/MessagingDirect Suite 900 Suite 900 10117 - Jasper Avenue 10117 - Jasper Avenue Edmonton, Alberta Edmonton, Alberta Canada T5J 1W8 Canada T5J 1W8 Barry Leiba IBM T.J. Watson Research Center 30 Saw Mill River Road Hawthorne, NY 10532 Phone: +1 914 784 7941 Nerenberg draft-nerenberg-imap-channel-00.txt [Page 4]