Network Working Group T. Myer Request for Comment: 680 D. Henderson NIC: 32116 BBN-TENEX April 30, 1975 Message Transmission Protocol Theodore H. Myer D. Austin Henderson BBN-TENEX This document defines a number of message fields beyond those discussed in RFC 561. The overall message format is compatible with RFC 561; it makes extensive use of the miscellaneous fileds defined within RFC 561. The purpose of this document is to establish ARPANET standards with regard to the syntax and semantics for these additional fields. It is fully expected that all fields discussed herein will not be automatically processed by all Message Servers; however, the standard is necessary so that sites which wish to make use of these fields have a standard to work with. This document attempts to tread the narrow line between features for human processing and features for machine processing. The general feeling is that the fields listed are useful to people even if automatic processing is not supplied. In most cases, machine- readable notations have been enclosed in angle brackets (<>) to allow easy non-ambiguous ways for automatic processes to know whether and where to look in any field. The entire specifications has been made excessively general to allow for experimentation. Future documents based on experience will try to be more specific. This is simply the next step following <RFC 561>. This document is contained in two sections. Section I contains the relevant parts of RFC 561 which define the basic message syntax. Section II lists the new (and existing) header fields together with their proposed uses. [Page 1] RFC 680 SECTION I: BASIC MESSAGE SYNTAX <message> ::= <header><crlf><body> <header> ::= <required header><optional header> <required header> ::= <date item><sender item> <date item> ::= DATE:<sp><date><sp>AT<sp> <time>-<zone><crlf> <date> ::= <vdate> ! <tdate> <vdate> ::= <dayofmonth><SP><vmonth><SP><vyear> <tdate> ::= <tmonth>/<dayofmonth>/<tyear> <dayofmonth> ::= one or two decimal digits <vmonth> ::= JAN ! FEB ! MAR ! APR ! MAY ! JUN ! JUL ! AUG ! SEP ! OCT ! NOV ! DEC <tmonth> ::= one or two decimal digits <vyear> ::= four decimal digits <tyear> ::= two decimal digits <zone> ::= EST ! EDT ! CST ! CDT ! MST ! MDT ! PST ! PDT ! GMT ! GDT <time> ::= four decimal digits <sender item := SENDER: <sp><user><sp>AT<sp><host> <crlf> <optional header> ::= <subjects><optional items> <subjects> ::= !<subject item> ! <subject item><subjects> <subject item> ::= SUBJECT:<sp><line><crlf> <optional items> ::= <optional item> ! <optional item> <optional items> <optional item> ::= <messid> ! <addressee item> ! <other item> <addressee item> ::= <addressee keyword>:<sp><addressee list><crlf> <addressee keywork> ::= TO:! CC:! BCC:! <messid> ::= Message-ID:<sp>[<Net Address>}]<line> <crlf> <other item> ::= <other keyword>:<sp><line><crlf> <other keyword> ::= FROM ! IN-REPLY-TO! REFERENCES! KEYWORD ! PRECEDENCE ! MESSAGE-CLASS! SPECIAL-HANDLING! AUTHENTICATION! ACCESSION-KEY <address list> ::= <addressee> ! <addressee><addressee list> <addressee> ::= <mailbox> ! <mailbox group> <mailbox> ::= <user><host spec><attention spec> <host spec> ::= !@<host> <attention spec> ::= (ATTN:<sp><user list>) [Page 2] RFC 680 <user list> ::= <user> ! <user><user list> <mailbox group> ::= <group name>:(<group numbers>) <group numbers> ::= ! (<mailbox list>) <mailbox list> ::= <mailbox> ! <mailbox>,<mailboxlist> <body> ::= <line><CRLF> ! <line><CRLF><body> <user> ::= <word> <host> ::= a standard host name <group name> ::= ! <word> <line> ::= a string containing any of the 128 ASCII characters except CR and LF <word> ::= a string containing any of the 128 ASCII characters except CR, LF, and SP <CRLF> ::= CR LF <SP> ::= space Notes: 1. A message may have at most one MESSAGE-ID item. 2. All items with the same keyword must be grasped together. Please note the following: (1) The case (upper or lower) of keywords -- specifically, 'FROM', 'DATE', 'SUBJECT', 'AT', <host>, <zone>, <vmonth> and <keyword> -- is insignificant. Although 'FROM', for example, appears in upper-case in the formal syntax above, in the header of an actual message it may appear as 'FROM', 'from', or 'From', etc. (2) No attempt has been made to legislate the format of <user> except to exclude spaces from it. (3) The time has no internal punctuation. [Page 3] RFC 680 SECTION II: MESSAGE HEADER FIELDS A. ORIGINATOR SPECIFICATION FIELDS FROM This field contains the identity of the person who wished this message to be sent. This is expected to be the originator field which is specified by the user in the case that the message is being entered by one person for another. The message-creation process should default this field to be the user entering the message. [The usage for FROM and SENDER differs from that of RFC 561.] SENDER This field contains the identity of the person who sends the message. This field is expected to be set by the message-creation process automatically. It is possible that some sites will not include this field in external communications. AUTHENTICATION This field contains a description of which originator fields have been authenticated, and by which operating systems. This field should be created by message transmission and/or reception processes (FTP/Operating System level). It is expected that current system will be able to authenticate only the SENDER field; however, later systems might have mechanisms to verify that the FROM actually authorized the SENDER to act on his/her behalf. It is expected that, when the FROM is authenticated, the SENDER will no longer be necessary for external distribution. B. REFERENCE SPECIFICATION FIELDS MESSAGE-ID This field contains a unique identifier to refer to this message. The format for a message identifier is: [Net Address]Text String CRLF Examples: [ISIB]7-DEC-74.14:23:45 [ARC]QLOURNAL 39274a3 [Page 4] RFC 680 The uniqueness of the message identifier is guaranteed by each net- address message processor making the text which follows unique for that net-address. This, specifically says net-address and not site name. This would allow BBN (for instance) to allocate unique identifiers over all four machines, which may be addressed as BBN within the message system, thus producing a more integrated service for their users. The text following the net-address is not defined here, as the problems associated with this specification are too great at this time. However, the net-address should allow automatic processes to determine if they can deal intelligently with the following text. Several types of automatic processing by the local message reader are thus possible: 1) if the site uses a filing mechanism known to the reader, the reader can retrieve the message 2) if the site supports remote message access (protocol not currently defined), the message id can be passed to the remote site and the message has been filed in the Datacomputer (using the entire message id [including net-address] as the handle), the reader can retrieve it from the Datacomputer. IN-REPLY-TO The contents of this field identify previous correspondence which this message answers. If message identifiers are used in this field, they should be enclosed in angle brackets (<>). REFERENCES The contents of this field identify other correspondence which this message references. If message identifiers are used, they should be enclosed in angle brackets (<>). KEYWORDS This field contains keywords or phrases from the message, separated by commas. [Page 5] RFC 680 C. RECEIVER SPECIFICATION FIELDS TO This field contains the identity of the primary receivers of the message. CC This field contains the identity of the secondary receivers of the message. BCC This field contains the identity of the tertiary receivers of the message. This field should not be made available to the primary and secondary receivers, but it may be recorded to provide information for access control. D. MESSAGE-TYPE SPECIFICATION FIELDS PRECEDENCE This field describes the importance and urgency of the message. Machine-readable notations will be enclosed in angle brackets (<>). <PRIORITY> means that the message should be delivered as soons as possible. <ROUTINE> means that Priority processing is not necessary. Plain text may also be included in this field. MESSAGE-CLASS This field describes the "legal" status of the message. Examples: Official, Unofficial, Record, Off the Record, Junk Mail. No automatic processing of this field is immediately expected. Certain message creation processes might, for example, always insert: MESSAGE CLASS: Unofficial ARPANET Message SPECIAL-HANDLING This field contains any special instructions with regard to the handling of the message at the receiver's end. Machine-readable notations will be enclosed in angle brackets (<>). <PRIVATE> means that the message reception process should not aid the user in circulating copies to others. Plain text may also be included in this field. [Page 6]