Network Working Group E. Burger Request for Comments: 3458 SnowShore Networks Category: Standards Track E. Candell Comverse C. Eliot Microsoft Corporation G. Klyne Nine by Nine January 2003 Message Context for Internet Mail Status of this Memo This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited. Copyright Notice Copyright (C) The Internet Society (2003). All Rights Reserved. Abstract This memo describes a new RFC 2822 message header, "Message-Context". This header provides information about the context and presentation characteristics of a message. A receiving user agent (UA) may use this information as a hint to optimally present the message. Burger, et al. Standards Track [Page 1] RFC 3458 Message Context for Internet Mail January 2003 Table of Contents 1. Introduction....................................................2 2. Conventions used in this document...............................3 3. Motivation......................................................3 4. Functional Requirements.........................................5 5. Determining the Message Context.................................6 6. Message-Context Reference Field.................................7 6.1. Message-Context Syntax......................................7 6.2. message-context-class Syntax................................7 6.2.1. voice-message...........................................8 6.2.2. fax-message.............................................8 6.2.3. pager-message...........................................8 6.2.4. multimedia-message......................................8 6.2.5. text-message............................................8 6.2.6. none....................................................8 7. Security Considerations.........................................9 8. IANA Considerations.............................................9 8.1. Message Content Type Registrations..........................9 8.2. Registration Template......................................10 8.3. Message-Context Registration...............................11 9. APPENDIX: Some messaging scenarios.............................12 9.1. Internet e-mail............................................12 9.2. Pager service..............................................12 9.3. Facsimile..................................................13 9.4. Voice mail.................................................14 9.5. Multimedia message.........................................14 10. References....................................................15 10.1 Normative References.......................................15 10.2 Informative References.....................................15 11. Acknowledgments...............................................15 12. Authors' Addresses............................................16 13. Full Copyright Statement......................................17 1. Introduction This document describes a mechanism to allow senders of an Internet mail message to convey the message's contextual information. Taking account of this information, the receiving user agent (UA) can make decisions that improve message presentation for the user in the context the sender and receiver expects. In this document, the "message context" conveys information about the way the user expects to interact with the message. For example, a message may be e-mail, voice mail, fax mail, etc. A smart UA may have specialized behavior based on the context of the message. This document specifies a RFC 2822 header called "Message-Context". Burger, et al. Standards Track [Page 2] RFC 3458 Message Context for Internet Mail January 2003 The mechanism is in some ways similar to the use of the Content- Disposition MIME entity described in [6]. Content-Disposition gives clues to the receiving User Agent (UA) for how to display a given body part. Message-Context can give clues to the receiving UA for the presentation of the message. This allows the receiving UA to present the message to the recipient, in a meaningful and helpful way. Typical uses for this mechanism include: o Selecting a special viewer for a given message. o Selecting an icon indicating the kind of message in a displayed list of messages. o Arranging messages in an inbox display. o Filtering messages the UA presents when the user has limited access. 2. Conventions used in this document This document refers generically to the sender of a message in the masculine (he/him/his) and the recipient of the message in the feminine (she/her/hers). This convention is purely for convenience and makes no assumption about the gender of a message sender or recipient. 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 BCP 14, RFC 2119 [2]. FORMATTING NOTE: Notes, such at this one, provide additional nonessential information that the reader may skip without missing anything essential. The primary purpose of these non-essential notes is to convey information about the rationale of this document, or to place this document in the proper historical or evolutionary context. Readers whose sole purpose is to construct a conformant implementation may skip such information. However, it may be of use to those who wish to understand why we made certain design choices. 3. Motivation Multimedia messaging systems receive messages that a UA may present in variety of ways. For example, traditional e-mail uses simple text messages that the recipient displays and edits. One UA may automatically print Fax images. Another UA may play voice messages through a telephone handset. Likewise, a receiving desktop computer Burger, et al. Standards Track [Page 3] RFC 3458 Message Context for Internet Mail January 2003 may process or present documents transferred over e-mail using a local application. Emerging and future developments may deliver other forms of information that have their own characteristics for user presentation, such as video messages and pager messages. An often-requested characteristic for multimedia messaging systems is to collect received messages in a "universal inbox", and to offer them to the user as a combined list. In the context of "unified messaging", different message contexts may have different implied semantics. For example, some users may perceive voicemail to have an implicit assumption of urgency. Thus they may wish to gather them together and process them before other messages. This results in the end-user receiving agent needing to be able to identify voicemail and distinguish it from other messages. The uses of this kind of presentation characteristic for each message are multi-fold: o Display an indication to the user (e.g., by a suitably evocative icon along with other summary fields), o Auto-forward a given message type into another messaging environment (e.g., a page to a mobile short message service), o Prioritize and group messages in an inbox display list, o Suggest appropriate default handling for presentation, o Suggest appropriate default handling for reply, forward, etc. A problem faced by multimedia messaging systems is that it is not always easy to decide the context of a received message. For example, consider the following scenarios. o A message that contains audio and image data: Is this a fax message that happens to have some voice commentary? Is it a voice message that is accompanied by some supplementary diagrams? Is it a fully multimedia message, in which all parts are expected to carry equal significance? o A message containing text and audio data: Is this e-mail with an MP3 music attachment? Is it a voice message that happens to have been generated with an initial text header for the benefit of non-voice-enabled e-mail receivers? Burger, et al. Standards Track [Page 4] RFC 3458 Message Context for Internet Mail January 2003 The message context does relate to the message media content. However, it is not the same thing. As shown above, the media type used in a message is not sufficient to indicate the message context. One cannot determine a priori which media types to use in alternative (gateway) messages. Also, what if the user cares about distinguishing traditional e-mail text from SMS messages? They are both the same media type, text, but they have different user contexts. 4. Functional Requirements The goals stated above lead to the following functional requirements. For receivers: o Identify a message as belonging to a message class. o Incorrect or invalid message classification must not result in failure to transfer or inability to present a message. For senders: o Specify message classes by the originating user's choice of authoring tool or simple user interaction. For both: o Specify a well-defined set of message classes to make interoperability between mail user agents (UAs) possible. o Message classification information has to be interpretable in reasonable fashion by many different user agent systems. o The mechanism should be extensible to allow for the introduction of new kinds of messages. NOTE: We specifically do not specify user agent behavior when the user agent forwards a message. Clearly, the user agent, being message-context-aware, should provide a meaningful message-context. It is obvious what to do for the easy cases. Messages that the user simply forwards will most likely keep the context unchanged. However, it is beyond the scope of this document to specify the user agent behavior for any other scenario. Burger, et al. Standards Track [Page 5] RFC 3458 Message Context for Internet Mail January 2003 5. Determining the Message Context One method of indicating the interpretation context of a message is to examine the media types in the message. However, this requires the UA to scan the entire message before it can make this determination. This approach is particularly burdensome for the multi-media mail situation, as voice and especially video mail objects are quite large. We considered indicating the message context by registering a multipart/* MIME subtype (Content-Type). For example, the VPIM Work Group has registered multipart/voice-message to indicate that a message is primarily voice mail [7]. However, multipart/voice- message is identical in syntax to multipart/mixed. The only difference is that VPIM mail transfer agents and user agents recognize that they can perform special handling of the message based on it being a voice mail message. Moreover, Content-Type refers to a given MIME body part, not to the message as a whole. We wish to avoid scanning the entire message. In addition, we wish to avoid having to create multiple aliases for multipart/mixed every time someone identifies a new primary content type. Multiple aliases for multipart/mixed are not desirable as they remove the possibility for specifying a message as multipart/alternate, multipart/parallel, or multipart/encrypted, for example. Since the message context is an attribute of the entire message, it is logical to define a new top-level (RFC 2822 [3]) message attribute. To this end, this document introduces the message attribute "Message-Context". Message-Context only serves to identify the message context. It does not provide any indication of content that the UA must be capable of delivering. It does not imply any message disposition or delivery notification. There is a related effort to define Critical Content of Internet Mail [8] that one might use to perform these tasks. Message-Context is only an indicator. We do not intend for it to convey information that is critical for presentation of the message. One can conceive of goofy situations, such as a message marked "voice-message" but without an audio body part. In this case, the fact that the contents of a message don't match its context does not mean the receiving system should generate an error report or fail to deliver or process the message. Burger, et al. Standards Track [Page 6] RFC 3458 Message Context for Internet Mail January 2003 6. Message-Context Reference Field The Message-Context reference field is a top-level header inserted by the sending UA to indicate the context of the message. A receiving user agent MUST NOT depend on the indicated message- context value in a way that prevents proper presentation of the message. If the value is incorrect or does not match the message content, the receiving user agent MUST still be capable of displaying the message content at least as meaningfully as it would if no Message-Context value were present. One can envision situations where a well-formed message ends up not including a media type one would expect from the message-context. For example, consider a voice messaging system that records a voice message and also performs speech-to-text processing on the message. The message then passes through a content gateway, such as a firewall, that removes non-critical body parts over a certain length. The receiving user agent will receive a message in the voice-message context that has only a text part and no audio. Even though the message does not have audio, it is still in the voice message context. Said differently, the receiving UA can use the message-context to determine whether, when, and possibly where to display a message. However, the message-context should not affect the actual rendering or presentation. For example, if the message is in the voice-message context, then don't try to send it to a fax terminal. Conversely, consider the case of a message in the voice-message context that gets delivered to a multimedia voice terminal with a printer. However, this message only has fax content. In this situation, the "voice- message" context should not stop the terminal from properly rendering the message. 6.1. Message-Context Syntax The syntax of the Message-Context field, described using the ABNF [4] is as follows. Note that the Message-Context header field name and message-context-class values are not case sensitive. "Message-Context" ":" message-context-class CRLF 6.2. message-context-class Syntax The message-context-class indicates the context of the message. This is an IANA registered value. Current values for message-context- class are as follows. Burger, et al. Standards Track [Page 7] RFC 3458 Message Context for Internet Mail January 2003 message-context-class = ( "voice-message" / "fax-message" / "pager-message" / "multimedia-message" / "text-message" / "none" ) Note: The values for Message-Context MUST be IANA registered values following the directions in the IANA Considerations section below. 6.2.1. voice-message The voice-message class states the message is a voice mail message. 6.2.2. fax-message The fax-message class states the message is a facsimile mail message. 6.2.3. pager-message The pager-message class states the message is a page, such as a text or numeric pager message or a traditional short text message service (SMS) message. 6.2.4. multimedia-message The multimedia-message class states the message is an aggregate multimedia message, such as a message specified by [9]. This helps identify a message in a multimedia context. For example, a MIME multipart/related [10] data part and resource part looks the same as a multimedia MHTML multipart/related. However, the semantics are quite different. 6.2.5. text-message The text-message class states the message is a traditional internet mail message. Such a message consists of text, possibly richly formatted, with or without attachments. 6.2.6. none The none class states there is no context information for this message. If a message has no Message-Context reference field, a receiving user agent MUST treat it the same as it would if the message has a "none" value. Burger, et al. Standards Track [Page 8] RFC 3458 Message Context for Internet Mail January 2003 7. Security Considerations The intention for this header is to be an indicator of message context only. One can imagine someone creating an "Application" Message-Context. A poorly designed user agent could blindly execute a mailed program based on the Message-Context. Don't do that! One can envision a denial of service attack by bombing a receiver with a message that has a Message-Context that doesn't fit the profile of the actual body parts. This is why the receiver considers the Message-Context to be a hint only. 8. IANA Considerations Section 8.3 is a registration for a new top-level RFC 2822 [3] message header, "Message-Context". This document creates an extensible set of context types. To promote interoperability and coherent interpretations of different types, a central repository has been established for well-known context types. The IANA has created a repository for context types called "Internet Message Context Types". Following the policies outlined in [5], this repository is "Specification Required" by RFC. Section 8.1 describes the initial values for this registry. To create a new message context type, you MUST publish an RFC to document the type. In the RFC, include a copy of the registration template found in Section 8.2 of this document. Put the template in your IANA Considerations section, filling-in the appropriate fields. You MUST describe any interoperability and security issues in your document. 8.1. Message Content Type Registrations Internet Message Content Types ============================== Value Description Reference ----- ----------- --------- voice-message Indicates a message whose primary This RFC content is a voice mail message. The primary content is audio data. The context is usually a message recorded from a voice telephone call. Burger, et al. Standards Track [Page 9] RFC 3458 Message Context for Internet Mail January 2003 fax-message Indicates a message whose primary This RFC content is a fax mail message. The primary content is image data. The context is usually a message recorded from a facsimile telephone call. pager-message Indicates a message whose primary This RFC content is a page. The primary content is text data. The context is an urgent message usually of a limited length. multimedia-message Indicates a message whose primary This RFC content is a multimedia message. The primary content is multimedia, most likely MHTML. The context is often spam or newsletters. text-message Indicates a classic, text-based, This RFC Internet message. None Indicates an unknown message context. This RFC 8.2. Registration Template In the following template, a pipe symbol, "|", precedes instructions or other helpful material. Be sure to replace "" with the class name you are defining. Message-Context class name: Summary of the message class: | Include a short (no longer than 4 lines) description or summary | Examples: | "Palmtop devices have a 320x160 pixel display, so we can..." | "Color fax is so different than black & white that..." Person & email address to contact for further information: | Name & e-mail Burger, et al. Standards Track [Page 10] RFC 3458 Message Context for Internet Mail January 2003 8.3. Message-Context Registration To: iana@iana.org Subject: Registration of New RFC 2822 Header RFC 2822 Header Name: Message-Context Allowable values for this parameter: Please create a new registry for Primary Context Class registrations. See section 8.1 of this document for the initial values. RFC 2822 Section 3.6 Repeat Value: Field Min Number Max Number Notes Message-Context 0 1 Person & email address to contact for further information: Eric Burger e.burger@ieee.org Burger, et al. Standards Track [Page 11] RFC 3458 Message Context for Internet Mail January 2003 9. APPENDIX: Some messaging scenarios This section is not a normative part of this document. We include it here as a historical perspective on the issue of multimedia message types. These scenarios are neither comprehensive nor fixed. For example, e-mails being typically text-based do not mean that they cannot convey a voice-message. This very mutability serves to underline the desirability of providing some explicit message context hint. 9.1. Internet e-mail Internet e-mail carries textual information. Sometimes it conveys computer application data of arbitrary size. Typically, one uses e-mail for non-urgent messages, which the recipient will retrieve and process at a time convenient to her. The normal device for receiving and processing e-mail messages is some kind of personal computer. Modern personal computers usually come with a reasonably large display and an alphanumeric keyboard. Audio, video, and printing capabilities are not necessarily available. One can use E-mail for communication between two parties (one-to- one), a small number of known parties (one-to-few) or, via an e-mail distribution list, between larger numbers of unknown parties (one- to-many). One of the endearing characteristics of e-mail is the way that it allows the recipient to forward all or part of the message to another party, with or without additional comments. It is quite common for an e-mail to contain snippets of content from several previous messages. Similar features apply when replying to e-mail. 9.2. Pager service One uses a pager message to convey notifications and alerts. For the most part, these notifications are textual information of limited size. The typical limit is 160 characters. People use pages for relatively urgent messages, which the sender wishes the receiver to see and possibly respond to within a short time period. Pager messages are often used as a way of alerting users to something needing their attention. For example, a system can use a page to notify a subscriber there is a voicemail message requiring her attention. Burger, et al. Standards Track [Page 12] RFC 3458 Message Context for Internet Mail January 2003 Example devices for sending and receiving a pager message are a mobile telephone with a small character display or a text pager. Personal computers and personal digital assistants (PDAs) can also participate in pager messaging. Currently, the most common use of pager messages are between just two parties (one-to-one). One delivery method for pager messages is the short text messaging service (SMS). SMS is a facility that has evolved for use with mobile telephones, and has an associated per-message transmission charge. Note that the focus here is on the notification aspect of SMS. From the beginning, SMS was envisioned to be more than a simple pager service. Operators can use SMS to provision the phone, for example. From the subscriber point of view, SMS has evolved considerably from its origins as a pure pager replacement service. For example, with mobile originate service, people can have two-way text chat sessions using SMS and a mobile phone. In addition, there are SMS-enabled handsets that can display pictures. However, for the purposes of this document, there is still a need to capture the essence of a "highly urgent, short-text, notification or alert" service. Users often send pager messages in isolation, rather than as part of a longer exchange. One use for them is as a prompt or invitation to communicate by some more convenient and content-rich method, such as a telephone call. 9.3. Facsimile People use facsimile to convey image information of moderate size, typically a small number of pages. Sometimes people use facsimile for larger documents. Facsimile is a facility that usually uses circuit-switched telephone circuits, with connection-time charges. Message transfer takes place in real-time. Thus, people often use facsimile for urgent communication. The normal device for sending and receiving a facsimile is a self- contained scanning and printing device connected to a telephone line or a desktop computer. Most facsimiles are between just two parties (one-to-one). However, a significant portion of facsimile service is broadcast between multiple parties (one-to-many). Burger, et al. Standards Track [Page 13] RFC 3458 Message Context for Internet Mail January 2003 Most facsimile exchanges are in isolation, rather than as part of a longer exchange. Facsimile data is typically not suitable for further processing by computer. 9.4. Voice mail People use voice mail to convey audio information, almost exclusively human speech. Voice mail is a facility that usually uses circuit-switched telephone circuits, with modest connection-time charges, often used for moderately urgent messages. A common use for them is as a prompt or invitation to communicate by some more convenient method, such as a telephone call. In most, but not all cases, the sender of a voice message does not want to send a message at all. Rather, they wished to engage in a real-time conversation. The normal device for sending and receiving a voice mail is a telephone handset. Voice messages are usually sent between just two parties (one-to- one). Voice mail data is not generally suitable for further processing by computer. 9.5. Multimedia message We define a multimedia message as a message containing more than one basic media type (text, image, audio, video, model, application). The following are some characteristics of a multimedia message. In some cases, a multimedia message is just e-mail with an attachment that a multimedia display application presents. For example, I can send you an MP3 of something I recorded in my garage today. In other cases, a multimedia message represents a convergence between two or more of the scenarios described above. For example, a voice message with an accompanying diagram or a talking head video message is a multimedia message. The characteristics will vary somewhat with the intent of the sender. This in turn may affect the user agent or application used to render the message. Burger, et al. Standards Track [Page 14] RFC 3458 Message Context for Internet Mail January 2003 10. References 10.1 Normative References [1] Bradner, S., "The Internet Standards Process -- Revision 3", BCP 9, RFC 2026, October 1996. [2] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [3] Resnick, P., "Internet Message Format", RFC 2822, April 2001. [4] Crocker, D. and P. Overell, Eds., "Augmented BNF for Syntax Specifications: ABNF", RFC 2234, November 1997. [5] Alvestrand, H. and T. Narten, "Guidelines for Writing an IANA Considerations Section in RFCs", BCP 26, RFC 2434, October 1998. 10.2 Informative References [6] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation Information in Internet Messages: The Content-Disposition Header Field", RFC 2183, August 1997. [7] Vaudreuil, G. and G. Parsons, "VPIM Voice Message MIME Sub-type Registration", RFC 2423, September 1998. [8] Burger, E., "Critical Content of Internet Mail", RFC 3459, January 2003. [9] Palme, J., Hopmann, A. and N. Shelness, "MIME Encapsulation of Aggregate Documents, such as HTML (MHTML)", RFC 2557, March 1999. [10] Levinson, E., "The MIME Multipart/Related Content-type", RFC 2387, August 1998. 11. Acknowledgments Many of the ideas here arose originally from a discussion with Jutta Degener. We'd also like to thank Keith Moore for helping us tighten-up our explanations. In the last round, we got some rather good advise from Caleb Clausen and Dave Aronson. Burger, et al. Standards Track [Page 15] RFC 3458 Message Context for Internet Mail January 2003 Antti Vaha-Sipila pointed out advances in SMS, while Stuart McRae helped distil the essence of the pager service vis a vis SMS. We offer an extra special thanks to Greg Vaudreuil for pulling RFC 2557 out of his hat. 12. Authors' Addresses Eric Burger SnowShore Networks, Inc. 285 Billerica Rd. Chelmsford, MA 01824-4120 USA Phone: +1 978 367 8403 EMail: e.burger@ieee.org Emily Candell Comverse Network Systems 200 Quannapowitt Pkwy. Wakefield, MA 01880 USA Phone: +1 781 213 2324 EMail: emily.candell@comverse.com Graham Klyne Nine by Nine United Kingdom EMail: GK-IETF@ninebynine.org Charles Eliot Microsoft Corporation One Microsoft Way Redmond WA 98052 USA Phone: +1 425 706 9760 EMail: charle@Microsoft.com Burger, et al. Standards Track [Page 16] RFC 3458 Message Context for Internet Mail January 2003 13. Full Copyright Statement Copyright (C) The Internet Society (2003). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Acknowledgement Funding for the RFC Editor function is currently provided by the Internet Society. Burger, et al. Standards Track [Page 17]