Network Working Group                                       Jacob Palme
Internet Draft                                 Stockholm University/KTH
draft-ietf-mailext-attributes-02.txt                             Sweden
Category: Informational                                       July 1995
Expires January 1996





                  Common Internet Message Attributes

                        Status of this Memo



  This document is an Internet-Draft.  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.''

  To learn the current status of any Internet-Draft, please check
  the ``1id-abstracts.txt'' listing contained in the Internet-
  Drafts Shadow Directories on ftp.is.co.za (Africa),
  nic.nordu.net (Europe), munnari.oz.au (Pacific Rim),
  ds.internic.net (US East Coast), or ftp.isi.edu (US West Coast).

  This memo provides information for the Internet community. This'
  memo does not specify an Internet standard of any kind, since
  this document is mainly a compilation of information taken from
  other RFC-s.. Distribution of this memo is unlimited.



                            Abstract

This memo contains a table of commonly occurring attributes in
headings and on envelopes of e-mail messages. The document compiles
information from other RFC-s such as RFC 821, RFC 822, RFC 1036,
RFC 1123, RFC 1327, RFC 1496, RFC 1521 and RFC 1766. A few commonly
occurring attributes which are not defined in RFC-s are also
included. For each attribute, the memo gives a short description
and a reference to the RFC, in which the attribute is defined.






Palme                                                          [Page 1]


draft-ietf-mailext-attributes-02.txt                          July 1995


                         Table of contents

1. Introduction

2. Use of gatewaying attributes

3. Table of attributes

   3.1  Phrases used in the tables
   3.2  Addressing information
   3.3  Envelope and format information
   3.4  Sender and recipient indication
   3.5  Response control
   3.6  Message identification and referral attributes
   3.7  Other textual attributes
   3.8  Attributes containing dates and times
   3.9  Quality information
   3.10 Language information
   3.11 Size information
   3.13 Encoding information
   3.14 Resent-attributes
   3.15 Miscellaneous

4. Acknowledgments

5. References

6. Author's address

Appendix A: Attributes sorted by Internet RFC document in which
            they appear

Appendix B: Alphabetical index





















Palme                                                          [Page 2]


draft-ietf-mailext-attributes-02.txt                          July 1995


                         1. Introduction

Many different Internet standards and RFC-s define attributes which
may occur on Internet Mail Messages and Network News Articles. The
intention of this document is to list all such attributes in one
document as an aid to people developing message systems or interested
in Internet Mail standards.

The document contains all heading attributes which the author has
found in the following Internet standards: RFC 821 [1], RFC 822 [2],
RFC 1036 [3], RFC 1123 [5], RFC 1327 [7], RFC 1496 [8], RFC 1521 [11]
and RFC 1766 [12]. Note in particular that heading attributes defined
in RFC 1421-1424, "Privacy Enhancement for Internet Electronic Mail",
are not included. A few additional attributes which often can be
found in e-mail headings but are not part of any Internet standard are
also included.

For each heading attribute, the document gives a short description and
a reference to the Internet standard or RFC, in which they are defined.



                 2. Use of gatewaying attributes

RFC 1327 defines a number of new attributes in Internet mail, which
are defined to map attributes which X.400 has but which were
previously not standardized in Internet mail. The fact that an
attribute occurs in RFC 1327 indicates that it is recommended for
use in gatewaying messages between X.400 and Internet mail, but
does not mean that the attribute is recommended for messages wholly
within Internet mail. Some of these attributes may eventually get
accepted also for usage within Internet mail, but they are, when
this is written (July 1995) not recommended for such usage.

Fields defined in RFC 1036 for use in Usenet News sometimes appear
in mail messages, either because the messages have been gatewayed
from Usenet News to e-mail, or because the messages were written in
combined clients supporting both e-mail and Usenet News in the same
client. These fields are however not standardized for use in
Internet e-mail and should be handled with caution.

Fields are given here in the spelling used in e-mail headers. This
may sometimes be English, sometimes American spelling. One attribute,
"Organisation/Organization" occurs in e-mail headers sometimes with
English, sometimes with American spelling.









Palme                                                          [Page 3]


draft-ietf-mailext-attributes-02.txt                          July 1995


                      3. Table of attributes

3.1 Phrases used in the tables

"not for general        Used to mark attributes which are defined in
usage"                  RFC 1327 for use in messages from or to
                        Internet mail/X.400 gateways. These attributes
                        have not been standardized for general usage
                        in the exchange of messages between Internet
                        mail-based systems.

"not standardized       Used to mark attributes defined only in RFC
for use in e-mail"      1036 for use in Usenet News. These attributes
                        have no standard meaning when appearing in e-
                        mail, some of them may even be used in
                        different ways by different software. When
                        appearing in e-mail, they should be handled
                        with caution. Note that RFC 1036, although
                        generally used as a standard for Usenet News,
                        is not an accepted IETF standard or on the
                        IETF standards track.

"non-standard"          This attribute is not specified in any of
                        those referenced RFC-s which are Internet
                        standards, draft standards or proposed
                        standards. The attribute appears here because
                        it is common in e-mail or Usenet News headers.
                        Usage of these attributes is not in general
                        recommended.

"discouraged"           This attribute, which is non-standard, is
                        known to create problems and should not be
                        generated. Handling of such attributes in
                        incoming mail should be done with great
                        caution.

"controversial"         The meaning and usage of this attribute is
                        controversial, i.e. different implementors
                        have chosen to implement the attribute in
                        different ways. Because of this, such
                        attributes should be handled with caution and
                        understanding of the different possible
                        interpretations.

"for limited use"       A so-called "experimental" Internet standard.
                        These should be used only if both parties
                        agree.







Palme                                                          [Page 4]


draft-ietf-mailext-attributes-02.txt                          July 1995


3.2 Addressing information

Original sender. Should in           MAIL FROM       RFC 821,
Internet be empty ("MAIL FROM:                       RFC 1123: 5.2.9.
<>") when sending notifications,
and be the list administrator
when forwarding from a
distribution list. This value may
for gatewayed messages contain a
chain of hosts to be passed in
sequence to reach the original
sender (i.e. a relative address).

Used to convey the information       Return-Path:    RFC 821,
from the MAIL FROM envelope                          RFC 1123: 5.2.13.
attribute when the message leaves
the SMTP environment in which
"MAIL FROM" is used.

Recipient to which message is to     RCPT TO         RFC 821,
be delivered. Relative address                       RFC 1123: 5.2.6.
was allowed in RFC 821, but later
prohibited in RFC 1123.

3.3 Envelope and format
information

All that is inside the envelope.     DATA            RFC 821,
                                                     RFC 1123: 5.2.8.

Trace of MTA-s which a message       Received:       RFC 822: 4.3.2,
has passed.                                          RFC 1123: 5.2.8.

An indicator that this message is    MIME-Version:   RFC 1521: 3.
formatted according to the MIME
standard, and an indication of
which version of MIME is
utilized.

List of MTA-s passed.                Path:           RFC 1036: 2.2.6,
                                                     not standardized
                                                     for use in e-mail.

Special Usenet News actions.         Control:        RFC 1036: 2.1.6,
                                                     not standardized
                                                     for use in
                                                     e-mail.

Trace of distribution lists          DL-Expansion-   RFC 1327, not for
passed.                              History-        general usage.
                                     Indication



Palme                                                          [Page 5]


draft-ietf-mailext-attributes-02.txt                          July 1995


Which body part types occur in       Original-       RFC 1327, not for
this message.                        Encoded-        general usage.
                                     Information-
                                     Types:

Special informational message.       Message-Type:   RFC 1327, not for
                                     Delivery        general usage.
                                     Report

Controls whether this message may    Alternate-      RFC 1327, not for
be forwarded to alternate            Recipient:      general usage.
recipients such as a postmaster
if delivery is not possible to
the intended recipient. Default:
Allowed.

Whether recipients are to be told    Disclose-       RFC 1327, not for
the names of other recipients of     Recipients:     general usage.
the same message. This is
primarily an X.400 facility, such
disclosure is in Internet mail
done via the To:, Cc: and Bcc:
heading fields.

3.4 Sender and recipient
indication

Author, approver                     From:           RFC 822: 4.4.1,
                                                     RFC 1123: 5.2.15-
                                                     16, 5.3.7.

Moderator                            Approved:       RFC 1036: 2.2.11,
                                                     not standardized
                                                     for use in e-mail.

Sender information inside the        Sender:         RFC 822: 4.4.2,
envelope.                                            RFC 1123: 5.2.15-
                                                     16, 5.3.7.

Main recipients.                     To:             RFC 822: 4.5.1,
                                                     RFC 1123: 5.2.15-
                                                     16, 5.3.7.

Additional recipients.               Cc:             RFC 822: 4.5.2,
                                                     RFC 1123. 5.2.15-
                                                     16, 5.3.7.

Recipients not shown to other        Bcc:            RFC 822: 4.5.3,
recipients.                                          RFC 1123: 5.2.15-
                                                     16, 5.3.7.




Palme                                                          [Page 6]


draft-ietf-mailext-attributes-02.txt                          July 1995

In Usenet News: group to which       Newsgroups:     RFC 1036: 2.1.3,
this article was posted.                             not standardized
Some systems provide this field                      and controversial
also in e-mail although it is not                    for use in e-mail.
standardized there.
Unfortunately, the field can
appear in e-mail with two
different and contradictory
meanings:
(a) Indicates the newsgroup
recipient of a message sent to
both e-mail and Usenet News
recipients.
(b) In a personally addressed
reply to a message in a
newsgroup, indicates the
newsgroup in which this
discussion originated.

Inserted by Sendmail when there      Apparently-     Non-standard,
is no "To:" recipient in the         To:             discouraged,
original message, listing                            mentioned in
recipients derived from the                          RFC 1211.
envelope into the message
heading. This behavior is not
quite proper, MTA-s should not
modify headings (except inserting
Received lines), and it can in
some cases cause Bcc recipients
to be wrongly divulged to non-Bcc
recipients.

Limitation on where this message     Distribution:   RFC 1036: 2.2.7,
can be distributed.                                  not standardized
                                                     for use in e-mail.

Fax number of the originator.        Fax:,           Non-standard.
                                     Telefax:

Phone number of the originator.      Phone:          Non-standard.

Information about the client         Mail-System-    Non-standard.
software of the originator.          Version:,
                                     Mailer:,
                                     Originating-
                                     Client:









Palme                                                          [Page 7]


draft-ietf-mailext-attributes-02.txt                          July 1995


3.5 Response control

Replacement for "From:" to which     Reply-To:       RFC 822: 4.4.3,
replies are to be sent.                              controversial.
Unfortunately, the specification
in RFC 822 is ambiguous, since
some people want this to be a
replacement for all recipients in
commands to send replies to all
recipients of the replied-to
message. The most general
consensus, however, seems to be
that "Reply-To" only indicates
replacement for the "From" field,
not for all the recipients.

Where group replies to this          Followup-To:    RFC 1036: 2.2.3,
message are to be sent.                              not standardized
                                                     for use in e-mail.

Address to which notifications       Errors-To:,     Non-standard,
are to be sent and a request to      Return-         discouraged.
get delivery notifications.          Receipt-To:
Internet standards recommend,
however, the use of RCPT TO and
Return-Path, not Errors-To, for
where notifications are to be
sent, and a new standard under
development specifies how
requests for notifications are
specified by a new parameter
"NOTIFY" to the "RCPT TO" SMTP
command.

Whether non-delivery report is       Prevent-        RFC 1327, not for
wanted at delivery error. Default    NonDelivery-    general usage.
is to want such a report.            Report:

Whether a delivery report is         Generate-       RFC 1327, not for
wanted at successful delivery.       Delivery-       general usage.
Default is not to generate such a    Report:
report.

Indicates whether the content of     Content-        RFC 1327, not for
a message is to be returned with     Return          general usage.
non-delivery notifications.

Indicates whether the content of     RET in DRPT     In forthcoming new
a message is to be returned with     SMTP exten-     Internet standard.
non-delivery notifications.          sion




Palme                                                          [Page 8]


draft-ietf-mailext-attributes-02.txt                          July 1995


3.6 Message identification and
referral attributes

Unique ID of this message.           Message-ID:     RFC 822: 4.6.1.

Unique ID of one body part of the    Content-ID:     RFC 1521: 6.1.
content of a message.

Reference to message which this      In-Reply-To:    RFC 822: 4.6.2.
message is a reply to.

Reference to other related           References:     RFC 822: 4.6.3.
messages.

Reference to previous message        Obsoletes:      RFC 1327, not for
being corrected and replaced.                        general usage.

Used in Usenet News in similar       Supersedes:     Non-standard.
ways to the "Obsoletes" attribute
described earlier in this
document.

3.7 Other textual attributes

Search keys for data base            Keywords:       RFC 822: 4.7.1.
retrieval.

Title, heading, subject.             Subject:        RFC 822: 4.7.1.

Comments on a message.               Comments:       RFC 822: 4.7.2.

Description of a particular body     Content-        RFC 1521: 6.2.
part of a message.                   description:

Organization to which the sender     Organization:   RFC 1036: 2.2.8,
of this message belongs.                             not standardized
                                                     for use in e-mail.

See Organization.                    Organisation:   Non-standard.

Short text describing a longer       Summary:        RFC 1036: 2.2.10,
message.                                             not standardized
                                                     for use in e-mail.

A text string which identifies       Content-        RFC 1327, not for
the content of a message.            identifier:     general usage.

3.8 Attributes containing dates
and times

The time when a message was          Delivery-       RFC 1327, not for
delivered to its recipient.          Date:           general usage.


Palme                                                          [Page 9]


draft-ietf-mailext-attributes-02.txt                          July 1995

In Internet, the date when a         Date:           RFC 822: 5.1,
message was written, in X.400,                       RFC 1123: 5.2.14.
the time a message was submitted.

A suggested expiration date. Can     Expires:        RFC 1036: 2.2.4,
be used both to limit the time of                    not standardized
an article which is not                              for use in e-mail.
meaningful after a certain date,
and to extend the storage of
important articles.

Time at which a message loses its    Expiry-Date:    RFC 1327, not for
validity.                                            general usage.

Latest time at which a reply is      Reply-By:       RFC 1327, not for
requested (not demanded).                            general usage.

3.9 Quality information

Can be "normal", "urgent" or "non-   Priority:       RFC 1327, not for
urgent" and can influence                            general usage.
transmission speed and delivery.

Sometimes used as a priority         Precedence:     Non-standard,
value which can influence                            controversial,
transmission speed and delivery.                     discouraged.
Common values are "bulk" and
"first-class". Other uses is to
control automatic replies and to
control return-of-content
facilities, and to stop mailing
list loops.

Can be high, normal or low and is    Importance:     RFC 1327, not for
only used in the recipient client                    general usage.
(UA).

Can be personal, private, company    Sensitivity:    RFC 1327, not for
confidential or absent.                              general usage.

Body parts are missing.              Incomplete-     RFC 1327, not for
                                     Copy:           general usage.

3.10 Language information

Can include a code for the           Language:       RFC 1327, not for
natural language used in a                           general usage.
message, e.g. "en" for English.

Can include a code for the           Content-        RFC 1766, proposed
natural language used in a           Language:       standard.
message, e.g. "en" for English.



Palme                                                         [Page 10]


draft-ietf-mailext-attributes-02.txt                          July 1995


3.11 Size information

Inserted by certain mailers to       Content-        Non-standard,
indicate the size in bytes of the    length:         discouraged.
message text. Can cause several
robustness and interoperability
problems and is not recommended.

Size of the message.                 Lines:          RFC 1036: 2.2.12,
                                                     not standardized
                                                     for use in e-mail.

3.12 Conversion control

The body of this message may not     Conversion:     RFC 1327, not for
be converted from one character                      general usage.
set to another.

The body of this message may not     Conversion-     RFC 1327, not for
be converted from one character      With-Loss:      general usage.
set to another if information
will be lost.

3.13 Encoding information

Format of content (character set     Content-Type:   RFC 1049,
etc.) Note that the values for                       RFC 1123: 5.2.13,
this field is defined in                             RFC 1521: 4.
different ways in RFC 1049 and in
MIME (RFC 1521), look for the
"MIME-version" heading field to
understand if Content-Type is to
be interpreted according to RFC
1049 or according to MIME. The
MIME definition should be used in
generating mail.

Coding method used in content.       Content-        RFC 1521: 5.
                                     Transfer-
                                     Encoding

Coding method used in content.       Encoding:       RFC 1154,
                                                     RFC 1505,
                                                     for limited use.










Palme                                                         [Page 11]


draft-ietf-mailext-attributes-02.txt                          July 1995


3.14 Resent-attributes

When manually forwarding a           Resent-Reply-   RFC 822: C.3.3.
message, attributes referring to     To:,
the forwarding, not to the           Resent-From:,
original message.  Note: MIME        Resent-
specifies another way of             Sender:,
resending messages, using the        Resent-From:,
"Message" Content-Type.              Resent-Date:,
                                     Resent-To:,
                                     Resent-cc:,
                                     Resent-bcc:,
                                     Resent-
                                     Message-ID:

3.15 Miscellaneous

Name of file in which a copy of      Fcc:            Non-standard.
this message is stored.

Has been automatically forwarded.    Auto-           RFC 1327, not for
                                     Forwarded:      general usage.

Can be used in Internet mail to      Discarded-      RFC 1327, not for
indicate X.400 extensions which      X400-IPMS-      general usage.
could not be mapped to Internet      Extensions:
mail format.

Can be used in Internet mail to      Discarded-      RFC 1327, not for
 indicate X.400 extensions which     X400-MTS-       general usage.
 could not be mapped to Internet     Extensions:
mail format.



                          4. Acknowledgments

Harald Tveit Alvestrand, Keith Moore, Nick Smith and several other
people have helped me with compiling this list. I alone take
responsibility for any errors which may still be in the list.

An earlier version of this list has been published as part of [13].












Palme                                                         [Page 12]


draft-ietf-mailext-attributes-02.txt                          July 1995


                            5. References

Ref.    Author, title                                    IETF status
                                                         (July 1995)
------  ----------------------------------------------   -----------
[1]     J. Postel: "Simple Mail Transfer Protocol",      Standard,
        STD 10, RFC 821, August 1982.                    Recommended.

[2]     D. Crocker: "Standard for the format of ARPA     Standard,
        Internet text messages." STD 11, RFC 822,        Recommended.
        August 1982.

[3]     M.R. Horton, R. Adams: "Standard for             Non-standard
        interchange of USENET messages", RFC 1036,       (but still
        December 1987.                                   widely used).

[4]     M. Sirbu: "A Content-Type header field for       Standard,
        internet messages", RFC 1049, March 1988.        Recommended.

[5]     R. Braden (editor): "Requirements for Internet   Standard,
        Hosts -- Application and Support", STD-3, RFC    Required
        1123, October 1989.

[6]     D. Robinson, R. Ullman: "Encoding Header Field   Non-standard.
        for Internet Messages", RFC 1154, April 1990.

[7]     S. Hardcastle-Kille: "Mapping between            Proposed
        X.400(1988) / ISO 10021 and RFC 822",  RFC       standard,
        1327 May 1992.                                   elective.

[8]     H. Alvestrand & J. Romaguera: "Rules for         Proposed
        Downgrading Messages from X.400/88 to X.400/84   standard,
        When MIME Content-Types are Present in the       elective.
        Messages", RFC 1496, August 1993.

[9]     A. Costanzo: "Encoding Header Field for          Non-standard.
        Internet Messages", RFC 1154, April 1990.

[10]    A. Costanzo, D. Robinson: "Encoding Header       Experimental.
        Field for Internet Messages", RFC 1505, August
        1993.

[11]    N. Borenstein & N. Freed: "MIME (Multipurpose    Draft
        Internet Mail Extensions) Part One: Mechanisms   Standard,
        for Specifying and Describing the Format of      elective.
        Internet Message Bodies", RFC 1521, Sept 1993.

[12]    H. Alvestrand: "Tags for the Identification of   Proposed
        Languages", RFC 1766, February 1995.             standard,
                                                         elective.

[13]    J. Palme: "Electronic Mail", Artech House        Non-standard.
        publishers, London-Boston January 1995.

Palme                                                         [Page 13]


draft-ietf-mailext-attributes-02.txt                          July 1995


                          6. Author's address

Jacob Palme                          Phone: +46-8-16 16 67
Stockholm University/KTH             Fax: +46-8-783 08 29
Electrum 230                         E-mail: jpalme@dsv.su.se
S-164 40 Kista, Sweden


                             Appendix A:
Attributes sorted by Internet RFC document in which they appear.



RFC 821
-------

DATA
MAIL FROM
RCPT TO

RFC 822
-------

Bcc
Cc
Comments
Date
From
In-Reply-To
Keywords
Message-ID
Received
References
Reply-To
Resent-
Resent-bcc
Resent-Date
Resent-From
Resent-From
Resent-Message-ID
Resent-Reply-To
Resent-ToResent-cc
Return-Path
Sender
Sender
Subject
To







Palme                                                         [Page 14]


draft-ietf-mailext-attributes-02.txt                          July 1995

RFC 1036
--------

Approved
Control
Distribution
Expires
Followup-To
Lines
Newsgroups
Organization
Path
Summary

RFC 1049
--------

Content-Type

RFC 1327
--------

Alternate-recipient
Auto-Forwarded
Autoforwarded
Content-identifier
Content-Return
Conversion
Conversion-With-Loss
Delivery-Date
Discarded-X400-IPMS-Extensions
Discarded-X400-MTS-Extensions
Disclose-Recipients
DL-Expansion-History
Expiry-Date
Generate-Delivery-Report
Importance
Incomplete-Copy
Language
Message-Type Delivery
Obsoletes
Original-Encoded-Information-Types
Prevent-NonDelivery-Report
Priority
Reply-By
Report
Sensitivity

RFC 1505
--------

Encoding



Palme                                                         [Page 15]


draft-ietf-mailext-attributes-02.txt                          July 1995

RFC 1521
--------

Content-description
Content-ID
Content-Transfer-Encoding
Content-Type
MIME-Version

Not Internet standard
---------------------

Apparently-to
Content-length
Encoding
Errors-To
Return-Receipt-To
Fax
Telefax
Fcc
Mail-System-Version
Mailer
Organisation
Originating-Client
Phone
Supersedes





























Palme                                                         [Page 16]


draft-ietf-mailext-attributes-02.txt                          July 1995

                             Appendix B:
                         Alphabetical index

Section Heading-field
------- -------------

3.3     Alternate-Recipient
3.4     Apparently-To
3.4     Approved
3.16    Auto-Forwarded
3.4     Bcc
3.4     Cc
3.7     Comments
3.7     Content-Description
3.6     Content-ID
3.7     Content-identifier
3.10    Content-Language
3.11    Content-Lenght
3.5     Content-Return
3.13    Content-Transfer-Encoding
3.13    Content-Type
3.3     Control
3.12    Conversion
3.12    Conversion-With-Loss
3.3     DATA
3.8     Date
3.8     Delivery-Date
3.16    Discarded-X400-IPMS-Extensions
3.16    Discarded-X400-MTS-Extensions
3.3     Disclose-Recipients
3.4     Distribution
3.3     DL-Expansion-History-Indication
3.13    Encoding
3.5     Errors-To
3.8     Expires
3.4     Fax
3.15    Fcc
3.5     Followup-To
3.4     From
3.5     Generate-Delivery-Report
3.9     Importance
3.6     In-Reply-To
3.9     Incomplete-Copy
3.7     Keywords
3.10    Language
3.11    Lines
3.2     MAIL FROM
3.4     Mail-System-Version
3.4     Mailer
3.6     Message-ID
3.3     Message-Type
3.3     MIME-Version
3.4     Newsgroups


Palme                                                         [Page 18]


draft-ietf-mailext-attributes-02.txt                          July 1995


3.6     Obsoletes
3.7     Organisation
3.7     Organization
3.3     Original-encoded-Information-Types
3.4     Originating-Client
3.3     Path
3.4     Phone
3.9     Precedence
3.5     Prevent-NonDelivery-Report
3.9     Priority
3.2     RCPT TO
3.3     Received
3.6     References
3.8     Reply-By
3.5     Reply-To
3.14    Resent-
3.5     RET in DRPT SMTP extension
3.2     Return-Path
3.5     Return-Receipt-To
3.4     Sender
3.9     Sensitivity
3.7     Subject
3.7     Summary
3.6     Supersedes
3.4     Telefax
3.4     To




























Palme                                                         [Page 19]