rfc2821.txt
上传用户:horngjaan
上传日期:2009-12-12
资源大小:2882k
文件大小:188k
源码类别:

Email服务器

开发平台:

C#

  1. Network Working Group                                 J. Klensin, Editor
  2. Request for Comments: 2821                             AT&T Laboratories
  3. Obsoletes: 821, 974, 1869                                     April 2001
  4. Updates: 1123
  5. Category: Standards Track
  6.                      Simple Mail Transfer Protocol
  7. Status of this Memo
  8.    This document specifies an Internet standards track protocol for the
  9.    Internet community, and requests discussion and suggestions for
  10.    improvements.  Please refer to the current edition of the "Internet
  11.    Official Protocol Standards" (STD 1) for the standardization state
  12.    and status of this protocol.  Distribution of this memo is unlimited.
  13. Copyright Notice
  14.    Copyright (C) The Internet Society (2001).  All Rights Reserved.
  15. Abstract
  16.    This document is a self-contained specification of the basic protocol
  17.    for the Internet electronic mail transport.  It consolidates, updates
  18.    and clarifies, but doesn't add new or change existing functionality
  19.    of the following:
  20.    -  the original SMTP (Simple Mail Transfer Protocol) specification of
  21.       RFC 821 [30],
  22.    -  domain name system requirements and implications for mail
  23.       transport from RFC 1035 [22] and RFC 974 [27],
  24.    -  the clarifications and applicability statements in RFC 1123 [2],
  25.       and
  26.    -  material drawn from the SMTP Extension mechanisms [19].
  27.    It obsoletes RFC 821, RFC 974, and updates RFC 1123 (replaces the
  28.    mail transport materials of RFC 1123).  However, RFC 821 specifies
  29.    some features that were not in significant use in the Internet by the
  30.    mid-1990s and (in appendices) some additional transport models.
  31.    Those sections are omitted here in the interest of clarity and
  32.    brevity; readers needing them should refer to RFC 821.
  33. Klensin                     Standards Track                     [Page 1]
  34. RFC 2821             Simple Mail Transfer Protocol            April 2001
  35.    It also includes some additional material from RFC 1123 that required
  36.    amplification.  This material has been identified in multiple ways,
  37.    mostly by tracking flaming on various lists and newsgroups and
  38.    problems of unusual readings or interpretations that have appeared as
  39.    the SMTP extensions have been deployed.  Where this specification
  40.    moves beyond consolidation and actually differs from earlier
  41.    documents, it supersedes them technically as well as textually.
  42.    Although SMTP was designed as a mail transport and delivery protocol,
  43.    this specification also contains information that is important to its
  44.    use as a 'mail submission' protocol, as recommended for POP [3, 26]
  45.    and IMAP [6].  Additional submission issues are discussed in RFC 2476
  46.    [15].
  47.    Section 2.3 provides definitions of terms specific to this document.
  48.    Except when the historical terminology is necessary for clarity, this
  49.    document uses the current 'client' and 'server' terminology to
  50.    identify the sending and receiving SMTP processes, respectively.
  51.    A companion document [32] discusses message headers, message bodies
  52.    and formats and structures for them, and their relationship.
  53. Table of Contents
  54.    1. Introduction ..................................................  4
  55.    2. The SMTP Model ................................................  5
  56.    2.1 Basic Structure ..............................................  5
  57.    2.2 The Extension Model ..........................................  7
  58.    2.2.1 Background .................................................  7
  59.    2.2.2 Definition and Registration of Extensions ..................  8
  60.    2.3 Terminology ..................................................  9
  61.    2.3.1 Mail Objects ............................................... 10
  62.    2.3.2 Senders and Receivers ...................................... 10
  63.    2.3.3 Mail Agents and Message Stores ............................. 10
  64.    2.3.4 Host ....................................................... 11
  65.    2.3.5 Domain ..................................................... 11
  66.    2.3.6 Buffer and State Table ..................................... 11
  67.    2.3.7 Lines ...................................................... 12
  68.    2.3.8 Originator, Delivery, Relay, and Gateway Systems ........... 12
  69.    2.3.9 Message Content and Mail Data .............................. 13
  70.    2.3.10 Mailbox and Address ....................................... 13
  71.    2.3.11 Reply ..................................................... 13
  72.    2.4 General Syntax Principles and Transaction Model .............. 13
  73.    3. The SMTP Procedures: An Overview .............................. 15
  74.    3.1 Session Initiation ........................................... 15
  75.    3.2 Client Initiation ............................................ 16
  76.    3.3 Mail Transactions ............................................ 16
  77.    3.4 Forwarding for Address Correction or Updating ................ 19
  78. Klensin                     Standards Track                     [Page 2]
  79. RFC 2821             Simple Mail Transfer Protocol            April 2001
  80.    3.5 Commands for Debugging Addresses ............................. 20
  81.    3.5.1 Overview ................................................... 20
  82.    3.5.2 VRFY Normal Response ....................................... 22
  83.    3.5.3 Meaning of VRFY or EXPN Success Response ................... 22
  84.    3.5.4 Semantics and Applications of EXPN ......................... 23
  85.    3.6 Domains ...................................................... 23
  86.    3.7 Relaying ..................................................... 24
  87.    3.8 Mail Gatewaying .............................................. 25
  88.    3.8.1 Header Fields in Gatewaying ................................ 26
  89.    3.8.2 Received Lines in Gatewaying ............................... 26
  90.    3.8.3 Addresses in Gatewaying .................................... 26
  91.    3.8.4 Other Header Fields in Gatewaying .......................... 27
  92.    3.8.5 Envelopes in Gatewaying .................................... 27
  93.    3.9 Terminating Sessions and Connections ......................... 27
  94.    3.10 Mailing Lists and Aliases ................................... 28
  95.    3.10.1 Alias ..................................................... 28
  96.    3.10.2 List ...................................................... 28
  97.    4. The SMTP Specifications ....................................... 29
  98.    4.1 SMTP Commands ................................................ 29
  99.    4.1.1 Command Semantics and Syntax ............................... 29
  100.    4.1.1.1  Extended HELLO (EHLO) or HELLO (HELO) ................... 29
  101.    4.1.1.2 MAIL (MAIL) .............................................. 31
  102.    4.1.1.3 RECIPIENT (RCPT) ......................................... 31
  103.    4.1.1.4 DATA (DATA) .............................................. 33
  104.    4.1.1.5 RESET (RSET) ............................................. 34
  105.    4.1.1.6 VERIFY (VRFY) ............................................ 35
  106.    4.1.1.7 EXPAND (EXPN) ............................................ 35
  107.    4.1.1.8 HELP (HELP) .............................................. 35
  108.    4.1.1.9 NOOP (NOOP) .............................................. 35
  109.    4.1.1.10 QUIT (QUIT) ............................................. 36
  110.    4.1.2 Command Argument Syntax .................................... 36
  111.    4.1.3 Address Literals ........................................... 38
  112.    4.1.4 Order of Commands .......................................... 39
  113.    4.1.5 Private-use Commands ....................................... 40
  114.    4.2  SMTP Replies ................................................ 40
  115.    4.2.1 Reply Code Severities and Theory ........................... 42
  116.    4.2.2 Reply Codes by Function Groups ............................. 44
  117.    4.2.3  Reply Codes in Numeric Order .............................. 45
  118.    4.2.4 Reply Code 502 ............................................. 46
  119.    4.2.5 Reply Codes After DATA and the Subsequent <CRLF>.<CRLF> .... 46
  120.    4.3 Sequencing of Commands and Replies ........................... 47
  121.    4.3.1 Sequencing Overview ........................................ 47
  122.    4.3.2 Command-Reply Sequences .................................... 48
  123.    4.4 Trace Information ............................................ 49
  124.    4.5 Additional Implementation Issues ............................. 53
  125.    4.5.1 Minimum Implementation ..................................... 53
  126.    4.5.2 Transparency ............................................... 53
  127.    4.5.3 Sizes and Timeouts ......................................... 54
  128. Klensin                     Standards Track                     [Page 3]
  129. RFC 2821             Simple Mail Transfer Protocol            April 2001
  130.    4.5.3.1 Size limits and minimums ................................. 54
  131.    4.5.3.2 Timeouts ................................................. 56
  132.    4.5.4 Retry Strategies ........................................... 57
  133.    4.5.4.1 Sending Strategy ......................................... 58
  134.    4.5.4.2 Receiving Strategy ....................................... 59
  135.    4.5.5 Messages with a null reverse-path .......................... 59
  136.    5. Address Resolution and Mail Handling .......................... 60
  137.    6. Problem Detection and Handling ................................ 62
  138.    6.1 Reliable Delivery and Replies by Email ....................... 62
  139.    6.2 Loop Detection ............................................... 63
  140.    6.3 Compensating for Irregularities .............................. 63
  141.    7. Security Considerations ....................................... 64
  142.    7.1 Mail Security and Spoofing ................................... 64
  143.    7.2 "Blind" Copies ............................................... 65
  144.    7.3 VRFY, EXPN, and Security ..................................... 65
  145.    7.4 Information Disclosure in Announcements ...................... 66
  146.    7.5 Information Disclosure in Trace Fields ....................... 66
  147.    7.6 Information Disclosure in Message Forwarding ................. 67
  148.    7.7 Scope of Operation of SMTP Servers ........................... 67
  149.    8. IANA Considerations ........................................... 67
  150.    9. References .................................................... 68
  151.    10. Editor's Address ............................................. 70
  152.    11. Acknowledgments .............................................. 70
  153.    Appendices ....................................................... 71
  154.    A. TCP Transport Service ......................................... 71
  155.    B. Generating SMTP Commands from RFC 822 Headers ................. 71
  156.    C. Source Routes ................................................. 72
  157.    D. Scenarios ..................................................... 73
  158.    E. Other Gateway Issues .......................................... 76
  159.    F. Deprecated Features of RFC 821 ................................ 76
  160.    Full Copyright Statement ......................................... 79
  161. 1. Introduction
  162.    The objective of the Simple Mail Transfer Protocol (SMTP) is to
  163.    transfer mail reliably and efficiently.
  164.    SMTP is independent of the particular transmission subsystem and
  165.    requires only a reliable ordered data stream channel.  While this
  166.    document specifically discusses transport over TCP, other transports
  167.    are possible.  Appendices to RFC 821 describe some of them.
  168.    An important feature of SMTP is its capability to transport mail
  169.    across networks, usually referred to as "SMTP mail relaying" (see
  170.    section 3.8).  A network consists of the mutually-TCP-accessible
  171.    hosts on the public Internet, the mutually-TCP-accessible hosts on a
  172.    firewall-isolated TCP/IP Intranet, or hosts in some other LAN or WAN
  173.    environment utilizing a non-TCP transport-level protocol.  Using
  174. Klensin                     Standards Track                     [Page 4]
  175. RFC 2821             Simple Mail Transfer Protocol            April 2001
  176.    SMTP, a process can transfer mail to another process on the same
  177.    network or to some other network via a relay or gateway process
  178.    accessible to both networks.
  179.    In this way, a mail message may pass through a number of intermediate
  180.    relay or gateway hosts on its path from sender to ultimate recipient.
  181.    The Mail eXchanger mechanisms of the domain name system [22, 27] (and
  182.    section 5 of this document) are used to identify the appropriate
  183.    next-hop destination for a message being transported.
  184. 2. The SMTP Model
  185. 2.1 Basic Structure
  186.    The SMTP design can be pictured as:
  187.                +----------+                +----------+
  188.    +------+    |          |                |          |
  189.    | User |<-->|          |      SMTP      |          |
  190.    +------+    |  Client- |Commands/Replies| Server-  |
  191.    +------+    |   SMTP   |<-------------->|    SMTP  |    +------+
  192.    | File |<-->|          |    and Mail    |          |<-->| File |
  193.    |System|    |          |                |          |    |System|
  194.    +------+    +----------+                +----------+    +------+
  195.                 SMTP client                SMTP server
  196.    When an SMTP client has a message to transmit, it establishes a two-
  197.    way transmission channel to an SMTP server.  The responsibility of an
  198.    SMTP client is to transfer mail messages to one or more SMTP servers,
  199.    or report its failure to do so.
  200.    The means by which a mail message is presented to an SMTP client, and
  201.    how that client determines the domain name(s) to which mail messages
  202.    are to be transferred is a local matter, and is not addressed by this
  203.    document.  In some cases, the domain name(s) transferred to, or
  204.    determined by, an SMTP client will identify the final destination(s)
  205.    of the mail message.  In other cases, common with SMTP clients
  206.    associated with implementations of the POP [3, 26] or IMAP [6]
  207.    protocols, or when the SMTP client is inside an isolated transport
  208.    service environment, the domain name determined will identify an
  209.    intermediate destination through which all mail messages are to be
  210.    relayed.  SMTP clients that transfer all traffic, regardless of the
  211.    target domain names associated with the individual messages, or that
  212.    do not maintain queues for retrying message transmissions that
  213.    initially cannot be completed, may otherwise conform to this
  214.    specification but are not considered fully-capable.  Fully-capable
  215.    SMTP implementations, including the relays used by these less capable
  216. Klensin                     Standards Track                     [Page 5]
  217. RFC 2821             Simple Mail Transfer Protocol            April 2001
  218.    ones, and their destinations, are expected to support all of the
  219.    queuing, retrying, and alternate address functions discussed in this
  220.    specification.
  221.    The means by which an SMTP client, once it has determined a target
  222.    domain name, determines the identity of an SMTP server to which a
  223.    copy of a message is to be transferred, and then performs that
  224.    transfer, is covered by this document.  To effect a mail transfer to
  225.    an SMTP server, an SMTP client establishes a two-way transmission
  226.    channel to that SMTP server.  An SMTP client determines the address
  227.    of an appropriate host running an SMTP server by resolving a
  228.    destination domain name to either an intermediate Mail eXchanger host
  229.    or a final target host.
  230.    An SMTP server may be either the ultimate destination or an
  231.    intermediate "relay" (that is, it may assume the role of an SMTP
  232.    client after receiving the message) or "gateway" (that is, it may
  233.    transport the message further using some protocol other than SMTP).
  234.    SMTP commands are generated by the SMTP client and sent to the SMTP
  235.    server.  SMTP replies are sent from the SMTP server to the SMTP
  236.    client in response to the commands.
  237.    In other words, message transfer can occur in a single connection
  238.    between the original SMTP-sender and the final SMTP-recipient, or can
  239.    occur in a series of hops through intermediary systems.  In either
  240.    case, a formal handoff of responsibility for the message occurs: the
  241.    protocol requires that a server accept responsibility for either
  242.    delivering a message or properly reporting the failure to do so.
  243.    Once the transmission channel is established and initial handshaking
  244.    completed, the SMTP client normally initiates a mail transaction.
  245.    Such a transaction consists of a series of commands to specify the
  246.    originator and destination of the mail and transmission of the
  247.    message content (including any headers or other structure) itself.
  248.    When the same message is sent to multiple recipients, this protocol
  249.    encourages the transmission of only one copy of the data for all
  250.    recipients at the same destination (or intermediate relay) host.
  251.    The server responds to each command with a reply; replies may
  252.    indicate that the command was accepted, that additional commands are
  253.    expected, or that a temporary or permanent error condition exists.
  254.    Commands specifying the sender or recipients may include server-
  255.    permitted SMTP service extension requests as discussed in section
  256.    2.2.  The dialog is purposely lock-step, one-at-a-time, although this
  257.    can be modified by mutually-agreed extension requests such as command
  258.    pipelining [13].
  259. Klensin                     Standards Track                     [Page 6]
  260. RFC 2821             Simple Mail Transfer Protocol            April 2001
  261.    Once a given mail message has been transmitted, the client may either
  262.    request that the connection be shut down or may initiate other mail
  263.    transactions.  In addition, an SMTP client may use a connection to an
  264.    SMTP server for ancillary services such as verification of email
  265.    addresses or retrieval of mailing list subscriber addresses.
  266.    As suggested above, this protocol provides mechanisms for the
  267.    transmission of mail.  This transmission normally occurs directly
  268.    from the sending user's host to the receiving user's host when the
  269.    two hosts are connected to the same transport service.  When they are
  270.    not connected to the same transport service, transmission occurs via
  271.    one or more relay SMTP servers.  An intermediate host that acts as
  272.    either an SMTP relay or as a gateway into some other transmission
  273.    environment is usually selected through the use of the domain name
  274.    service (DNS) Mail eXchanger mechanism.
  275.    Usually, intermediate hosts are determined via the DNS MX record, not
  276.    by explicit "source" routing (see section 5 and appendices C and
  277.    F.2).
  278. 2.2 The Extension Model
  279. 2.2.1 Background
  280.    In an effort that started in 1990, approximately a decade after RFC
  281.    821 was completed, the protocol was modified with a "service
  282.    extensions" model that permits the client and server to agree to
  283.    utilize shared functionality beyond the original SMTP requirements.
  284.    The SMTP extension mechanism defines a means whereby an extended SMTP
  285.    client and server may recognize each other, and the server can inform
  286.    the client as to the service extensions that it supports.
  287.    Contemporary SMTP implementations MUST support the basic extension
  288.    mechanisms.  For instance, servers MUST support the EHLO command even
  289.    if they do not implement any specific extensions and clients SHOULD
  290.    preferentially utilize EHLO rather than HELO.  (However, for
  291.    compatibility with older conforming implementations, SMTP clients and
  292.    servers MUST support the original HELO mechanisms as a fallback.)
  293.    Unless the different characteristics of HELO must be identified for
  294.    interoperability purposes, this document discusses only EHLO.
  295.    SMTP is widely deployed and high-quality implementations have proven
  296.    to be very robust.  However, the Internet community now considers
  297.    some services to be important that were not anticipated when the
  298.    protocol was first designed.  If support for those services is to be
  299.    added, it must be done in a way that permits older implementations to
  300.    continue working acceptably.  The extension framework consists of:
  301. Klensin                     Standards Track                     [Page 7]
  302. RFC 2821             Simple Mail Transfer Protocol            April 2001
  303.    -  The SMTP command EHLO, superseding the earlier HELO,
  304.    -  a registry of SMTP service extensions,
  305.    -  additional parameters to the SMTP MAIL and RCPT commands, and
  306.    -  optional replacements for commands defined in this protocol, such
  307.       as for DATA in non-ASCII transmissions [33].
  308.    SMTP's strength comes primarily from its simplicity.  Experience with
  309.    many protocols has shown that protocols with few options tend towards
  310.    ubiquity, whereas protocols with many options tend towards obscurity.
  311.    Each and every extension, regardless of its benefits, must be
  312.    carefully scrutinized with respect to its implementation, deployment,
  313.    and interoperability costs.  In many cases, the cost of extending the
  314.    SMTP service will likely outweigh the benefit.
  315. 2.2.2 Definition and Registration of Extensions
  316.    The IANA maintains a registry of SMTP service extensions.  A
  317.    corresponding EHLO keyword value is associated with each extension.
  318.    Each service extension registered with the IANA must be defined in a
  319.    formal standards-track or IESG-approved experimental protocol
  320.    document.  The definition must include:
  321.    -  the textual name of the SMTP service extension;
  322.    -  the EHLO keyword value associated with the extension;
  323.    -  the syntax and possible values of parameters associated with the
  324.       EHLO keyword value;
  325.    -  any additional SMTP verbs associated with the extension
  326.       (additional verbs will usually be, but are not required to be, the
  327.       same as the EHLO keyword value);
  328.    -  any new parameters the extension associates with the MAIL or RCPT
  329.       verbs;
  330.    -  a description of how support for the extension affects the
  331.       behavior of a server and client SMTP; and,
  332.    -  the increment by which the extension is increasing the maximum
  333.       length of the commands MAIL and/or RCPT, over that specified in
  334.       this standard.
  335. Klensin                     Standards Track                     [Page 8]
  336. RFC 2821             Simple Mail Transfer Protocol            April 2001
  337.    In addition, any EHLO keyword value starting with an upper or lower
  338.    case "X" refers to a local SMTP service extension used exclusively
  339.    through bilateral agreement.  Keywords beginning with "X" MUST NOT be
  340.    used in a registered service extension.  Conversely, keyword values
  341.    presented in the EHLO response that do not begin with "X" MUST
  342.    correspond to a standard, standards-track, or IESG-approved
  343.    experimental SMTP service extension registered with IANA.  A
  344.    conforming server MUST NOT offer non-"X"-prefixed keyword values that
  345.    are not described in a registered extension.
  346.    Additional verbs and parameter names are bound by the same rules as
  347.    EHLO keywords; specifically, verbs beginning with "X" are local
  348.    extensions that may not be registered or standardized.  Conversely,
  349.    verbs not beginning with "X" must always be registered.
  350. 2.3 Terminology
  351.    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  352.    "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
  353.    document are to be interpreted as described below.
  354.    1. MUST   This word, or the terms "REQUIRED" or "SHALL", mean that
  355.       the definition is an absolute requirement of the specification.
  356.    2. MUST NOT   This phrase, or the phrase "SHALL NOT", mean that the
  357.       definition is an absolute prohibition of the specification.
  358.    3. SHOULD   This word, or the adjective "RECOMMENDED", mean that
  359.       there may exist valid reasons in particular circumstances to
  360.       ignore a particular item, but the full implications must be
  361.       understood and carefully weighed before choosing a different
  362.       course.
  363.    4. SHOULD NOT   This phrase, or the phrase "NOT RECOMMENDED" mean
  364.       that there may exist valid reasons in particular circumstances
  365.       when the particular behavior is acceptable or even useful, but the
  366.       full implications should be understood and the case carefully
  367.       weighed before implementing any behavior described with this
  368.       label.
  369.    5. MAY   This word, or the adjective "OPTIONAL", mean that an item is
  370.       truly optional.  One vendor may choose to include the item because
  371.       a particular marketplace requires it or because the vendor feels
  372.       that it enhances the product while another vendor may omit the
  373.       same item.  An implementation which does not include a particular
  374.       option MUST be prepared to interoperate with another
  375.       implementation which does include the option, though perhaps with
  376.       reduced functionality.  In the same vein an implementation which
  377. Klensin                     Standards Track                     [Page 9]
  378. RFC 2821             Simple Mail Transfer Protocol            April 2001
  379.       does include a particular option MUST be prepared to interoperate
  380.       with another implementation which does not include the option
  381.       (except, of course, for the feature the option provides.)
  382. 2.3.1 Mail Objects
  383.    SMTP transports a mail object.  A mail object contains an envelope
  384.    and content.
  385.    The SMTP envelope is sent as a series of SMTP protocol units
  386.    (described in section 3).  It consists of an originator address (to
  387.    which error reports should be directed); one or more recipient
  388.    addresses; and optional protocol extension material.  Historically,
  389.    variations on the recipient address specification command (RCPT TO)
  390.    could be used to specify alternate delivery modes, such as immediate
  391.    display; those variations have now been deprecated (see appendix F,
  392.    section F.6).
  393.    The SMTP content is sent in the SMTP DATA protocol unit and has two
  394.    parts:  the headers and the body.  If the content conforms to other
  395.    contemporary standards, the headers form a collection of field/value
  396.    pairs structured as in the message format specification [32]; the
  397.    body, if structured, is defined according to MIME [12].  The content
  398.    is textual in nature, expressed using the US-ASCII repertoire [1].
  399.    Although SMTP extensions (such as "8BITMIME" [20]) may relax this
  400.    restriction for the content body, the content headers are always
  401.    encoded using the US-ASCII repertoire.  A MIME extension [23] defines
  402.    an algorithm for representing header values outside the US-ASCII
  403.    repertoire, while still encoding them using the US-ASCII repertoire.
  404. 2.3.2 Senders and Receivers
  405.    In RFC 821, the two hosts participating in an SMTP transaction were
  406.    described as the "SMTP-sender" and "SMTP-receiver".  This document
  407.    has been changed to reflect current industry terminology and hence
  408.    refers to them as the "SMTP client" (or sometimes just "the client")
  409.    and "SMTP server" (or just "the server"), respectively.  Since a
  410.    given host may act both as server and client in a relay situation,
  411.    "receiver" and "sender" terminology is still used where needed for
  412.    clarity.
  413. 2.3.3 Mail Agents and Message Stores
  414.    Additional mail system terminology became common after RFC 821 was
  415.    published and, where convenient, is used in this specification.  In
  416.    particular, SMTP servers and clients provide a mail transport service
  417.    and therefore act as "Mail Transfer Agents" (MTAs).  "Mail User
  418.    Agents" (MUAs or UAs) are normally thought of as the sources and
  419. Klensin                     Standards Track                    [Page 10]
  420. RFC 2821             Simple Mail Transfer Protocol            April 2001
  421.    targets of mail.  At the source, an MUA might collect mail to be
  422.    transmitted from a user and hand it off to an MTA; the final
  423.    ("delivery") MTA would be thought of as handing the mail off to an
  424.    MUA (or at least transferring responsibility to it, e.g., by
  425.    depositing the message in a "message store").  However, while these
  426.    terms are used with at least the appearance of great precision in
  427.    other environments, the implied boundaries between MUAs and MTAs
  428.    often do not accurately match common, and conforming, practices with
  429.    Internet mail.  Hence, the reader should be cautious about inferring
  430.    the strong relationships and responsibilities that might be implied
  431.    if these terms were used elsewhere.
  432. 2.3.4 Host
  433.    For the purposes of this specification, a host is a computer system
  434.    attached to the Internet (or, in some cases, to a private TCP/IP
  435.    network) and supporting the SMTP protocol.  Hosts are known by names
  436.    (see "domain"); identifying them by numerical address is discouraged.
  437. 2.3.5 Domain
  438.    A domain (or domain name) consists of one or more dot-separated
  439.    components.  These components ("labels" in DNS terminology [22]) are
  440.    restricted for SMTP purposes to consist of a sequence of letters,
  441.    digits, and hyphens drawn from the ASCII character set [1].  Domain
  442.    names are used as names of hosts and of other entities in the domain
  443.    name hierarchy.  For example, a domain may refer to an alias (label
  444.    of a CNAME RR) or the label of Mail eXchanger records to be used to
  445.    deliver mail instead of representing a host name.  See [22] and
  446.    section 5 of this specification.
  447.    The domain name, as described in this document and in [22], is the
  448.    entire, fully-qualified name (often referred to as an "FQDN").  A
  449.    domain name that is not in FQDN form is no more than a local alias.
  450.    Local aliases MUST NOT appear in any SMTP transaction.
  451. 2.3.6 Buffer and State Table
  452.    SMTP sessions are stateful, with both parties carefully maintaining a
  453.    common view of the current state.  In this document we model this
  454.    state by a virtual "buffer" and a "state table" on the server which
  455.    may be used by the client to, for example, "clear the buffer" or
  456.    "reset the state table," causing the information in the buffer to be
  457.    discarded and the state to be returned to some previous state.
  458. Klensin                     Standards Track                    [Page 11]
  459. RFC 2821             Simple Mail Transfer Protocol            April 2001
  460. 2.3.7 Lines
  461.    SMTP commands and, unless altered by a service extension, message
  462.    data, are transmitted in "lines".  Lines consist of zero or more data
  463.    characters terminated by the sequence ASCII character "CR" (hex value
  464.    0D) followed immediately by ASCII character "LF" (hex value 0A).
  465.    This termination sequence is denoted as <CRLF> in this document.
  466.    Conforming implementations MUST NOT recognize or generate any other
  467.    character or character sequence as a line terminator.  Limits MAY be
  468.    imposed on line lengths by servers (see section 4.5.3).
  469.    In addition, the appearance of "bare" "CR" or "LF" characters in text
  470.    (i.e., either without the other) has a long history of causing
  471.    problems in mail implementations and applications that use the mail
  472.    system as a tool.  SMTP client implementations MUST NOT transmit
  473.    these characters except when they are intended as line terminators
  474.    and then MUST, as indicated above, transmit them only as a <CRLF>
  475.    sequence.
  476. 2.3.8 Originator, Delivery, Relay, and Gateway Systems
  477.    This specification makes a distinction among four types of SMTP
  478.    systems, based on the role those systems play in transmitting
  479.    electronic mail.  An "originating" system (sometimes called an SMTP
  480.    originator) introduces mail into the Internet or, more generally,
  481.    into a transport service environment.  A "delivery" SMTP system is
  482.    one that receives mail from a transport service environment and
  483.    passes it to a mail user agent or deposits it in a message store
  484.    which a mail user agent is expected to subsequently access.  A
  485.    "relay" SMTP system (usually referred to just as a "relay") receives
  486.    mail from an SMTP client and transmits it, without modification to
  487.    the message data other than adding trace information, to another SMTP
  488.    server for further relaying or for delivery.
  489.    A "gateway" SMTP system (usually referred to just as a "gateway")
  490.    receives mail from a client system in one transport environment and
  491.    transmits it to a server system in another transport environment.
  492.    Differences in protocols or message semantics between the transport
  493.    environments on either side of a gateway may require that the gateway
  494.    system perform transformations to the message that are not permitted
  495.    to SMTP relay systems.  For the purposes of this specification,
  496.    firewalls that rewrite addresses should be considered as gateways,
  497.    even if SMTP is used on both sides of them (see [11]).
  498. Klensin                     Standards Track                    [Page 12]
  499. RFC 2821             Simple Mail Transfer Protocol            April 2001
  500. 2.3.9 Message Content and Mail Data
  501.    The terms "message content" and "mail data" are used interchangeably
  502.    in this document to describe the material transmitted after the DATA
  503.    command is accepted and before the end of data indication is
  504.    transmitted.  Message content includes message headers and the
  505.    possibly-structured message body.  The MIME specification [12]
  506.    provides the standard mechanisms for structured message bodies.
  507. 2.3.10 Mailbox and Address
  508.    As used in this specification, an "address" is a character string
  509.    that identifies a user to whom mail will be sent or a location into
  510.    which mail will be deposited.  The term "mailbox" refers to that
  511.    depository.  The two terms are typically used interchangeably unless
  512.    the distinction between the location in which mail is placed (the
  513.    mailbox) and a reference to it (the address) is important.  An
  514.    address normally consists of user and domain specifications.  The
  515.    standard mailbox naming convention is defined to be "local-
  516.    part@domain": contemporary usage permits a much broader set of
  517.    applications than simple "user names".  Consequently, and due to a
  518.    long history of problems when intermediate hosts have attempted to
  519.    optimize transport by modifying them, the local-part MUST be
  520.    interpreted and assigned semantics only by the host specified in the
  521.    domain part of the address.
  522. 2.3.11 Reply
  523.    An SMTP reply is an acknowledgment (positive or negative) sent from
  524.    receiver to sender via the transmission channel in response to a
  525.    command.  The general form of a reply is a numeric completion code
  526.    (indicating failure or success) usually followed by a text string.
  527.    The codes are for use by programs and the text is usually intended
  528.    for human users.  Recent work [34] has specified further structuring
  529.    of the reply strings, including the use of supplemental and more
  530.    specific completion codes.
  531. 2.4 General Syntax Principles and Transaction Model
  532.    SMTP commands and replies have a rigid syntax.  All commands begin
  533.    with a command verb.  All Replies begin with a three digit numeric
  534.    code.  In some commands and replies, arguments MUST follow the verb
  535.    or reply code.  Some commands do not accept arguments (after the
  536.    verb), and some reply codes are followed, sometimes optionally, by
  537.    free form text.  In both cases, where text appears, it is separated
  538.    from the verb or reply code by a space character.  Complete
  539.    definitions of commands and replies appear in section 4.
  540. Klensin                     Standards Track                    [Page 13]
  541. RFC 2821             Simple Mail Transfer Protocol            April 2001
  542.    Verbs and argument values (e.g., "TO:" or "to:" in the RCPT command
  543.    and extension name keywords) are not case sensitive, with the sole
  544.    exception in this specification of a mailbox local-part (SMTP
  545.    Extensions may explicitly specify case-sensitive elements).  That is,
  546.    a command verb, an argument value other than a mailbox local-part,
  547.    and free form text MAY be encoded in upper case, lower case, or any
  548.    mixture of upper and lower case with no impact on its meaning.  This
  549.    is NOT true of a mailbox local-part.  The local-part of a mailbox
  550.    MUST BE treated as case sensitive.  Therefore, SMTP implementations
  551.    MUST take care to preserve the case of mailbox local-parts.  Mailbox
  552.    domains are not case sensitive.  In particular, for some hosts the
  553.    user "smith" is different from the user "Smith".  However, exploiting
  554.    the case sensitivity of mailbox local-parts impedes interoperability
  555.    and is discouraged.
  556.    A few SMTP servers, in violation of this specification (and RFC 821)
  557.    require that command verbs be encoded by clients in upper case.
  558.    Implementations MAY wish to employ this encoding to accommodate those
  559.    servers.
  560.    The argument field consists of a variable length character string
  561.    ending with the end of the line, i.e., with the character sequence
  562.    <CRLF>.  The receiver will take no action until this sequence is
  563.    received.
  564.    The syntax for each command is shown with the discussion of that
  565.    command.  Common elements and parameters are shown in section 4.1.2.
  566.    Commands and replies are composed of characters from the ASCII
  567.    character set [1].  When the transport service provides an 8-bit byte
  568.    (octet) transmission channel, each 7-bit character is transmitted
  569.    right justified in an octet with the high order bit cleared to zero.
  570.    More specifically, the unextended SMTP service provides seven bit
  571.    transport only.  An originating SMTP client which has not
  572.    successfully negotiated an appropriate extension with a particular
  573.    server MUST NOT transmit messages with information in the high-order
  574.    bit of octets.  If such messages are transmitted in violation of this
  575.    rule, receiving SMTP servers MAY clear the high-order bit or reject
  576.    the message as invalid.  In general, a relay SMTP SHOULD assume that
  577.    the message content it has received is valid and, assuming that the
  578.    envelope permits doing so, relay it without inspecting that content.
  579.    Of course, if the content is mislabeled and the data path cannot
  580.    accept the actual content, this may result in ultimate delivery of a
  581.    severely garbled message to the recipient.  Delivery SMTP systems MAY
  582.    reject ("bounce") such messages rather than deliver them.  No sending
  583.    SMTP system is permitted to send envelope commands in any character
  584. Klensin                     Standards Track                    [Page 14]
  585. RFC 2821             Simple Mail Transfer Protocol            April 2001
  586.    set other than US-ASCII; receiving systems SHOULD reject such
  587.    commands, normally using "500 syntax error - invalid character"
  588.    replies.
  589.    Eight-bit message content transmission MAY be requested of the server
  590.    by a client using extended SMTP facilities, notably the "8BITMIME"
  591.    extension [20].  8BITMIME SHOULD be supported by SMTP servers.
  592.    However, it MUST not be construed as authorization to transmit
  593.    unrestricted eight bit material.  8BITMIME MUST NOT be requested by
  594.    senders for material with the high bit on that is not in MIME format
  595.    with an appropriate content-transfer encoding; servers MAY reject
  596.    such messages.
  597.    The metalinguistic notation used in this document corresponds to the
  598.    "Augmented BNF" used in other Internet mail system documents.  The
  599.    reader who is not familiar with that syntax should consult the ABNF
  600.    specification [8].  Metalanguage terms used in running text are
  601.    surrounded by pointed brackets (e.g., <CRLF>) for clarity.
  602. 3. The SMTP Procedures: An Overview
  603.    This section contains descriptions of the procedures used in SMTP:
  604.    session initiation, the mail transaction, forwarding mail, verifying
  605.    mailbox names and expanding mailing lists, and the opening and
  606.    closing exchanges.  Comments on relaying, a note on mail domains, and
  607.    a discussion of changing roles are included at the end of this
  608.    section.  Several complete scenarios are presented in appendix D.
  609. 3.1 Session Initiation
  610.    An SMTP session is initiated when a client opens a connection to a
  611.    server and the server responds with an opening message.
  612.    SMTP server implementations MAY include identification of their
  613.    software and version information in the connection greeting reply
  614.    after the 220 code, a practice that permits more efficient isolation
  615.    and repair of any problems.  Implementations MAY make provision for
  616.    SMTP servers to disable the software and version announcement where
  617.    it causes security concerns.  While some systems also identify their
  618.    contact point for mail problems, this is not a substitute for
  619.    maintaining the required "postmaster" address (see section 4.5.1).
  620.    The SMTP protocol allows a server to formally reject a transaction
  621.    while still allowing the initial connection as follows: a 554
  622.    response MAY be given in the initial connection opening message
  623.    instead of the 220.  A server taking this approach MUST still wait
  624.    for the client to send a QUIT (see section 4.1.1.10) before closing
  625.    the connection and SHOULD respond to any intervening commands with
  626. Klensin                     Standards Track                    [Page 15]
  627. RFC 2821             Simple Mail Transfer Protocol            April 2001
  628.    "503 bad sequence of commands".  Since an attempt to make an SMTP
  629.    connection to such a system is probably in error, a server returning
  630.    a 554 response on connection opening SHOULD provide enough
  631.    information in the reply text to facilitate debugging of the sending
  632.    system.
  633. 3.2 Client Initiation
  634.    Once the server has sent the welcoming message and the client has
  635.    received it, the client normally sends the EHLO command to the
  636.    server, indicating the client's identity.  In addition to opening the
  637.    session, use of EHLO indicates that the client is able to process
  638.    service extensions and requests that the server provide a list of the
  639.    extensions it supports.  Older SMTP systems which are unable to
  640.    support service extensions and contemporary clients which do not
  641.    require service extensions in the mail session being initiated, MAY
  642.    use HELO instead of EHLO.  Servers MUST NOT return the extended
  643.    EHLO-style response to a HELO command.  For a particular connection
  644.    attempt, if the server returns a "command not recognized" response to
  645.    EHLO, the client SHOULD be able to fall back and send HELO.
  646.    In the EHLO command the host sending the command identifies itself;
  647.    the command may be interpreted as saying "Hello, I am <domain>" (and,
  648.    in the case of EHLO, "and I support service extension requests").
  649. 3.3 Mail Transactions
  650.    There are three steps to SMTP mail transactions.  The transaction
  651.    starts with a MAIL command which gives the sender identification.
  652.    (In general, the MAIL command may be sent only when no mail
  653.    transaction is in progress; see section 4.1.4.)  A series of one or
  654.    more RCPT commands follows giving the receiver information.  Then a
  655.    DATA command initiates transfer of the mail data and is terminated by
  656.    the "end of mail" data indicator, which also confirms the
  657.    transaction.
  658.    The first step in the procedure is the MAIL command.
  659.       MAIL FROM:<reverse-path> [SP <mail-parameters> ] <CRLF>
  660.    This command tells the SMTP-receiver that a new mail transaction is
  661.    starting and to reset all its state tables and buffers, including any
  662.    recipients or mail data.  The <reverse-path> portion of the first or
  663.    only argument contains the source mailbox (between "<" and ">"
  664.    brackets), which can be used to report errors (see section 4.2 for a
  665.    discussion of error reporting).  If accepted, the SMTP server returns
  666.    a 250 OK reply.  If the mailbox specification is not acceptable for
  667.    some reason, the server MUST return a reply indicating whether the
  668. Klensin                     Standards Track                    [Page 16]
  669. RFC 2821             Simple Mail Transfer Protocol            April 2001
  670.    failure is permanent (i.e., will occur again if the client tries to
  671.    send the same address again) or temporary (i.e., the address might be
  672.    accepted if the client tries again later).  Despite the apparent
  673.    scope of this requirement, there are circumstances in which the
  674.    acceptability of the reverse-path may not be determined until one or
  675.    more forward-paths (in RCPT commands) can be examined.  In those
  676.    cases, the server MAY reasonably accept the reverse-path (with a 250
  677.    reply) and then report problems after the forward-paths are received
  678.    and examined.  Normally, failures produce 550 or 553 replies.
  679.    Historically, the <reverse-path> can contain more than just a
  680.    mailbox, however, contemporary systems SHOULD NOT use source routing
  681.    (see appendix C).
  682.    The optional <mail-parameters> are associated with negotiated SMTP
  683.    service extensions (see section 2.2).
  684.    The second step in the procedure is the RCPT command.
  685.       RCPT TO:<forward-path> [ SP <rcpt-parameters> ] <CRLF>
  686.    The first or only argument to this command includes a forward-path
  687.    (normally a mailbox and domain, always surrounded by "<" and ">"
  688.    brackets) identifying one recipient.  If accepted, the SMTP server
  689.    returns a 250 OK reply and stores the forward-path.  If the recipient
  690.    is known not to be a deliverable address, the SMTP server returns a
  691.    550 reply, typically with a string such as "no such user - " and the
  692.    mailbox name (other circumstances and reply codes are possible).
  693.    This step of the procedure can be repeated any number of times.
  694.    The <forward-path> can contain more than just a mailbox.
  695.    Historically, the <forward-path> can be a source routing list of
  696.    hosts and the destination mailbox, however, contemporary SMTP clients
  697.    SHOULD NOT utilize source routes (see appendix C).  Servers MUST be
  698.    prepared to encounter a list of source routes in the forward path,
  699.    but SHOULD ignore the routes or MAY decline to support the relaying
  700.    they imply.  Similarly, servers MAY decline to accept mail that is
  701.    destined for other hosts or systems.  These restrictions make a
  702.    server useless as a relay for clients that do not support full SMTP
  703.    functionality.  Consequently, restricted-capability clients MUST NOT
  704.    assume that any SMTP server on the Internet can be used as their mail
  705.    processing (relaying) site.  If a RCPT command appears without a
  706.    previous MAIL command, the server MUST return a 503 "Bad sequence of
  707.    commands" response.  The optional <rcpt-parameters> are associated
  708.    with negotiated SMTP service extensions (see section 2.2).
  709.    The third step in the procedure is the DATA command (or some
  710.    alternative specified in a service extension).
  711. Klensin                     Standards Track                    [Page 17]
  712. RFC 2821             Simple Mail Transfer Protocol            April 2001
  713.       DATA <CRLF>
  714.    If accepted, the SMTP server returns a 354 Intermediate reply and
  715.    considers all succeeding lines up to but not including the end of
  716.    mail data indicator to be the message text.  When the end of text is
  717.    successfully received and stored the SMTP-receiver sends a 250 OK
  718.    reply.
  719.    Since the mail data is sent on the transmission channel, the end of
  720.    mail data must be indicated so that the command and reply dialog can
  721.    be resumed.  SMTP indicates the end of the mail data by sending a
  722.    line containing only a "." (period or full stop).  A transparency
  723.    procedure is used to prevent this from interfering with the user's
  724.    text (see section 4.5.2).
  725.    The end of mail data indicator also confirms the mail transaction and
  726.    tells the SMTP server to now process the stored recipients and mail
  727.    data.  If accepted, the SMTP server returns a 250 OK reply.  The DATA
  728.    command can fail at only two points in the protocol exchange:
  729.    -  If there was no MAIL, or no RCPT, command, or all such commands
  730.       were rejected, the server MAY return a "command out of sequence"
  731.       (503) or "no valid recipients" (554) reply in response to the DATA
  732.       command.  If one of those replies (or any other 5yz reply) is
  733.       received, the client MUST NOT send the message data; more
  734.       generally, message data MUST NOT be sent unless a 354 reply is
  735.       received.
  736.    -  If the verb is initially accepted and the 354 reply issued, the
  737.       DATA command should fail only if the mail transaction was
  738.       incomplete (for example, no recipients), or if resources were
  739.       unavailable (including, of course, the server unexpectedly
  740.       becoming unavailable), or if the server determines that the
  741.       message should be rejected for policy or other reasons.
  742.    However, in practice, some servers do not perform recipient
  743.    verification until after the message text is received.  These servers
  744.    SHOULD treat a failure for one or more recipients as a "subsequent
  745.    failure" and return a mail message as discussed in section 6.  Using
  746.    a "550 mailbox not found" (or equivalent) reply code after the data
  747.    are accepted makes it difficult or impossible for the client to
  748.    determine which recipients failed.
  749.    When RFC 822 format [7, 32] is being used, the mail data include the
  750.    memo header items such as Date, Subject, To, Cc, From.  Server SMTP
  751.    systems SHOULD NOT reject messages based on perceived defects in the
  752.    RFC 822 or MIME [12] message header or message body.  In particular,
  753. Klensin                     Standards Track                    [Page 18]
  754. RFC 2821             Simple Mail Transfer Protocol            April 2001
  755.    they MUST NOT reject messages in which the numbers of Resent-fields
  756.    do not match or Resent-to appears without Resent-from and/or Resent-
  757.    date.
  758.    Mail transaction commands MUST be used in the order discussed above.
  759. 3.4 Forwarding for Address Correction or Updating
  760.    Forwarding support is most often required to consolidate and simplify
  761.    addresses within, or relative to, some enterprise and less frequently
  762.    to establish addresses to link a person's prior address with current
  763.    one.  Silent forwarding of messages (without server notification to
  764.    the sender), for security or non-disclosure purposes, is common in
  765.    the contemporary Internet.
  766.    In both the enterprise and the "new address" cases, information
  767.    hiding (and sometimes security) considerations argue against exposure
  768.    of the "final" address through the SMTP protocol as a side-effect of
  769.    the forwarding activity.  This may be especially important when the
  770.    final address may not even be reachable by the sender.  Consequently,
  771.    the "forwarding" mechanisms described in section 3.2 of RFC 821, and
  772.    especially the 251 (corrected destination) and 551 reply codes from
  773.    RCPT must be evaluated carefully by implementers and, when they are
  774.    available, by those configuring systems.
  775.    In particular:
  776.    *  Servers MAY forward messages when they are aware of an address
  777.       change.  When they do so, they MAY either provide address-updating
  778.       information with a 251 code, or may forward "silently" and return
  779.       a 250 code.  But, if a 251 code is used, they MUST NOT assume that
  780.       the client will actually update address information or even return
  781.       that information to the user.
  782.    Alternately,
  783.    *  Servers MAY reject or bounce messages when they are not
  784.       deliverable when addressed.  When they do so, they MAY either
  785.       provide address-updating information with a 551 code, or may
  786.       reject the message as undeliverable with a 550 code and no
  787.       address-specific information.  But, if a 551 code is used, they
  788.       MUST NOT assume that the client will actually update address
  789.       information or even return that information to the user.
  790.    SMTP server implementations that support the 251 and/or 551 reply
  791.    codes are strongly encouraged to provide configuration mechanisms so
  792.    that sites which conclude that they would undesirably disclose
  793.    information can disable or restrict their use.
  794. Klensin                     Standards Track                    [Page 19]
  795. RFC 2821             Simple Mail Transfer Protocol            April 2001
  796. 3.5 Commands for Debugging Addresses
  797. 3.5.1 Overview
  798.    SMTP provides commands to verify a user name or obtain the content of
  799.    a mailing list.  This is done with the VRFY and EXPN commands, which
  800.    have character string arguments.  Implementations SHOULD support VRFY
  801.    and EXPN (however, see section 3.5.2 and 7.3).
  802.    For the VRFY command, the string is a user name or a user name and
  803.    domain (see below).  If a normal (i.e., 250) response is returned,
  804.    the response MAY include the full name of the user and MUST include
  805.    the mailbox of the user.  It MUST be in either of the following
  806.    forms:
  807.       User Name <local-part@domain>
  808.       local-part@domain
  809.    When a name that is the argument to VRFY could identify more than one
  810.    mailbox, the server MAY either note the ambiguity or identify the
  811.    alternatives.  In other words, any of the following are legitimate
  812.    response to VRFY:
  813.       553 User ambiguous
  814.    or
  815.       553- Ambiguous;  Possibilities are
  816.       553-Joe Smith <jsmith@foo.com>
  817.       553-Harry Smith <hsmith@foo.com>
  818.       553 Melvin Smith <dweep@foo.com>
  819.    or
  820.       553-Ambiguous;  Possibilities
  821.       553- <jsmith@foo.com>
  822.       553- <hsmith@foo.com>
  823.       553 <dweep@foo.com>
  824.    Under normal circumstances, a client receiving a 553 reply would be
  825.    expected to expose the result to the user.  Use of exactly the forms
  826.    given, and the "user ambiguous" or "ambiguous" keywords, possibly
  827.    supplemented by extended reply codes such as those described in [34],
  828.    will facilitate automated translation into other languages as needed.
  829.    Of course, a client that was highly automated or that was operating
  830.    in another language than English, might choose to try to translate
  831.    the response, to return some other indication to the user than the
  832. Klensin                     Standards Track                    [Page 20]
  833. RFC 2821             Simple Mail Transfer Protocol            April 2001
  834.    literal text of the reply, or to take some automated action such as
  835.    consulting a directory service for additional information before
  836.    reporting to the user.
  837.    For the EXPN command, the string identifies a mailing list, and the
  838.    successful (i.e., 250) multiline response MAY include the full name
  839.    of the users and MUST give the mailboxes on the mailing list.
  840.    In some hosts the distinction between a mailing list and an alias for
  841.    a single mailbox is a bit fuzzy, since a common data structure may
  842.    hold both types of entries, and it is possible to have mailing lists
  843.    containing only one mailbox.  If a request is made to apply VRFY to a
  844.    mailing list, a positive response MAY be given if a message so
  845.    addressed would be delivered to everyone on the list, otherwise an
  846.    error SHOULD be reported (e.g., "550 That is a mailing list, not a
  847.    user" or "252 Unable to verify members of mailing list").  If a
  848.    request is made to expand a user name, the server MAY return a
  849.    positive response consisting of a list containing one name, or an
  850.    error MAY be reported (e.g., "550 That is a user name, not a mailing
  851.    list").
  852.    In the case of a successful multiline reply (normal for EXPN) exactly
  853.    one mailbox is to be specified on each line of the reply.  The case
  854.    of an ambiguous request is discussed above.
  855.    "User name" is a fuzzy term and has been used deliberately.  An
  856.    implementation of the VRFY or EXPN commands MUST include at least
  857.    recognition of local mailboxes as "user names".  However, since
  858.    current Internet practice often results in a single host handling
  859.    mail for multiple domains, hosts, especially hosts that provide this
  860.    functionality, SHOULD accept the "local-part@domain" form as a "user
  861.    name"; hosts MAY also choose to recognize other strings as "user
  862.    names".
  863.    The case of expanding a mailbox list requires a multiline reply, such
  864.    as:
  865.       C: EXPN Example-People
  866.       S: 250-Jon Postel <Postel@isi.edu>
  867.       S: 250-Fred Fonebone <Fonebone@physics.foo-u.edu>
  868.       S: 250 Sam Q. Smith <SQSmith@specific.generic.com>
  869.    or
  870.       C: EXPN Executive-Washroom-List
  871.       S: 550 Access Denied to You.
  872. Klensin                     Standards Track                    [Page 21]
  873. RFC 2821             Simple Mail Transfer Protocol            April 2001
  874.    The character string arguments of the VRFY and EXPN commands cannot
  875.    be further restricted due to the variety of implementations of the
  876.    user name and mailbox list concepts.  On some systems it may be
  877.    appropriate for the argument of the EXPN command to be a file name
  878.    for a file containing a mailing list, but again there are a variety
  879.    of file naming conventions in the Internet.  Similarly, historical
  880.    variations in what is returned by these commands are such that the
  881.    response SHOULD be interpreted very carefully, if at all, and SHOULD
  882.    generally only be used for diagnostic purposes.
  883. 3.5.2 VRFY Normal Response
  884.    When normal (2yz or 551) responses are returned from a VRFY or EXPN
  885.    request, the reply normally includes the mailbox name, i.e.,
  886.    "<local-part@domain>", where "domain" is a fully qualified domain
  887.    name, MUST appear in the syntax.  In circumstances exceptional enough
  888.    to justify violating the intent of this specification, free-form text
  889.    MAY be returned.  In order to facilitate parsing by both computers
  890.    and people, addresses SHOULD appear in pointed brackets.  When
  891.    addresses, rather than free-form debugging information, are returned,
  892.    EXPN and VRFY MUST return only valid domain addresses that are usable
  893.    in SMTP RCPT commands.  Consequently, if an address implies delivery
  894.    to a program or other system, the mailbox name used to reach that
  895.    target MUST be given.  Paths (explicit source routes) MUST NOT be
  896.    returned by VRFY or EXPN.
  897.    Server implementations SHOULD support both VRFY and EXPN.  For
  898.    security reasons, implementations MAY provide local installations a
  899.    way to disable either or both of these commands through configuration
  900.    options or the equivalent.  When these commands are supported, they
  901.    are not required to work across relays when relaying is supported.
  902.    Since they were both optional in RFC 821, they MUST be listed as
  903.    service extensions in an EHLO response, if they are supported.
  904. 3.5.3 Meaning of VRFY or EXPN Success Response
  905.    A server MUST NOT return a 250 code in response to a VRFY or EXPN
  906.    command unless it has actually verified the address.  In particular,
  907.    a server MUST NOT return 250 if all it has done is to verify that the
  908.    syntax given is valid.  In that case, 502 (Command not implemented)
  909.    or 500 (Syntax error, command unrecognized) SHOULD be returned.  As
  910.    stated elsewhere, implementation (in the sense of actually validating
  911.    addresses and returning information) of VRFY and EXPN are strongly
  912.    recommended.  Hence, implementations that return 500 or 502 for VRFY
  913.    are not in full compliance with this specification.
  914. Klensin                     Standards Track                    [Page 22]
  915. RFC 2821             Simple Mail Transfer Protocol            April 2001
  916.    There may be circumstances where an address appears to be valid but
  917.    cannot reasonably be verified in real time, particularly when a
  918.    server is acting as a mail exchanger for another server or domain.
  919.    "Apparent validity" in this case would normally involve at least
  920.    syntax checking and might involve verification that any domains
  921.    specified were ones to which the host expected to be able to relay
  922.    mail.  In these situations, reply code 252 SHOULD be returned.  These
  923.    cases parallel the discussion of RCPT verification discussed in
  924.    section 2.1.  Similarly, the discussion in section 3.4 applies to the
  925.    use of reply codes 251 and 551 with VRFY (and EXPN) to indicate
  926.    addresses that are recognized but that would be forwarded or bounced
  927.    were mail received for them.  Implementations generally SHOULD be
  928.    more aggressive about address verification in the case of VRFY than
  929.    in the case of RCPT, even if it takes a little longer to do so.
  930. 3.5.4 Semantics and Applications of EXPN
  931.    EXPN is often very useful in debugging and understanding problems
  932.    with mailing lists and multiple-target-address aliases.  Some systems
  933.    have attempted to use source expansion of mailing lists as a means of
  934.    eliminating duplicates.  The propagation of aliasing systems with
  935.    mail on the Internet, for hosts (typically with MX and CNAME DNS
  936.    records), for mailboxes (various types of local host aliases), and in
  937.    various proxying arrangements, has made it nearly impossible for
  938.    these strategies to work consistently, and mail systems SHOULD NOT
  939.    attempt them.
  940. 3.6 Domains
  941.    Only resolvable, fully-qualified, domain names (FQDNs) are permitted
  942.    when domain names are used in SMTP.  In other words, names that can
  943.    be resolved to MX RRs or A RRs (as discussed in section 5) are
  944.    permitted, as are CNAME RRs whose targets can be resolved, in turn,
  945.    to MX or A RRs.  Local nicknames or unqualified names MUST NOT be
  946.    used.  There are two exceptions to the rule requiring FQDNs:
  947.    -  The domain name given in the EHLO command MUST BE either a primary
  948.       host name (a domain name that resolves to an A RR) or, if the host
  949.       has no name, an address literal as described in section 4.1.1.1.
  950.    -  The reserved mailbox name "postmaster" may be used in a RCPT
  951.       command without domain qualification (see section 4.1.1.3) and
  952.       MUST be accepted if so used.
  953. Klensin                     Standards Track                    [Page 23]
  954. RFC 2821             Simple Mail Transfer Protocol            April 2001
  955. 3.7 Relaying
  956.    In general, the availability of Mail eXchanger records in the domain
  957.    name system [22, 27] makes the use of explicit source routes in the
  958.    Internet mail system unnecessary.  Many historical problems with
  959.    their interpretation have made their use undesirable.  SMTP clients
  960.    SHOULD NOT generate explicit source routes except under unusual
  961.    circumstances.  SMTP servers MAY decline to act as mail relays or to
  962.    accept addresses that specify source routes.  When route information
  963.    is encountered, SMTP servers are also permitted to ignore the route
  964.    information and simply send to the final destination specified as the
  965.    last element in the route and SHOULD do so.  There has been an
  966.    invalid practice of using names that do not appear in the DNS as
  967.    destination names, with the senders counting on the intermediate
  968.    hosts specified in source routing to resolve any problems.  If source
  969.    routes are stripped, this practice will cause failures.  This is one
  970.    of several reasons why SMTP clients MUST NOT generate invalid source
  971.    routes or depend on serial resolution of names.
  972.    When source routes are not used, the process described in RFC 821 for
  973.    constructing a reverse-path from the forward-path is not applicable
  974.    and the reverse-path at the time of delivery will simply be the
  975.    address that appeared in the MAIL command.
  976.    A relay SMTP server is usually the target of a DNS MX record that
  977.    designates it, rather than the final delivery system.  The relay
  978.    server may accept or reject the task of relaying the mail in the same
  979.    way it accepts or rejects mail for a local user.  If it accepts the
  980.    task, it then becomes an SMTP client, establishes a transmission
  981.    channel to the next SMTP server specified in the DNS (according to
  982.    the rules in section 5), and sends it the mail.  If it declines to
  983.    relay mail to a particular address for policy reasons, a 550 response
  984.    SHOULD be returned.
  985.    Many mail-sending clients exist, especially in conjunction with
  986.    facilities that receive mail via POP3 or IMAP, that have limited
  987.    capability to support some of the requirements of this specification,
  988.    such as the ability to queue messages for subsequent delivery
  989.    attempts.  For these clients, it is common practice to make private
  990.    arrangements to send all messages to a single server for processing
  991.    and subsequent distribution.  SMTP, as specified here, is not ideally
  992.    suited for this role, and work is underway on standardized mail
  993.    submission protocols that might eventually supercede the current
  994.    practices.  In any event, because these arrangements are private and
  995.    fall outside the scope of this specification, they are not described
  996.    here.
  997. Klensin                     Standards Track                    [Page 24]
  998. RFC 2821             Simple Mail Transfer Protocol            April 2001
  999.    It is important to note that MX records can point to SMTP servers
  1000.    which act as gateways into other environments, not just SMTP relays
  1001.    and final delivery systems; see sections 3.8 and 5.
  1002.    If an SMTP server has accepted the task of relaying the mail and
  1003.    later finds that the destination is incorrect or that the mail cannot
  1004.    be delivered for some other reason, then it MUST construct an
  1005.    "undeliverable mail" notification message and send it to the
  1006.    originator of the undeliverable mail (as indicated by the reverse-
  1007.    path).  Formats specified for non-delivery reports by other standards
  1008.    (see, for example, [24, 25]) SHOULD be used if possible.
  1009.    This notification message must be from the SMTP server at the relay
  1010.    host or the host that first determines that delivery cannot be
  1011.    accomplished.  Of course, SMTP servers MUST NOT send notification
  1012.    messages about problems transporting notification messages.  One way
  1013.    to prevent loops in error reporting is to specify a null reverse-path
  1014.    in the MAIL command of a notification message.  When such a message
  1015.    is transmitted the reverse-path MUST be set to null (see section
  1016.    4.5.5 for additional discussion).  A MAIL command with a null
  1017.    reverse-path appears as follows:
  1018.       MAIL FROM:<>
  1019.    As discussed in section 2.4.1, a relay SMTP has no need to inspect or
  1020.    act upon the headers or body of the message data and MUST NOT do so
  1021.    except to add its own "Received:" header (section 4.4) and,
  1022.    optionally, to attempt to detect looping in the mail system (see
  1023.    section 6.2).
  1024. 3.8 Mail Gatewaying
  1025.    While the relay function discussed above operates within the Internet
  1026.    SMTP transport service environment, MX records or various forms of
  1027.    explicit routing may require that an intermediate SMTP server perform
  1028.    a translation function between one transport service and another.  As
  1029.    discussed in section 2.3.8, when such a system is at the boundary
  1030.    between two transport service environments, we refer to it as a
  1031.    "gateway" or "gateway SMTP".
  1032.    Gatewaying mail between different mail environments, such as
  1033.    different mail formats and protocols, is complex and does not easily
  1034.    yield to standardization.  However, some general requirements may be
  1035.    given for a gateway between the Internet and another mail
  1036.    environment.
  1037. Klensin                     Standards Track                    [Page 25]
  1038. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1039. 3.8.1 Header Fields in Gatewaying
  1040.    Header fields MAY be rewritten when necessary as messages are
  1041.    gatewayed across mail environment boundaries.  This may involve
  1042.    inspecting the message body or interpreting the local-part of the
  1043.    destination address in spite of the prohibitions in section 2.4.1.
  1044.    Other mail systems gatewayed to the Internet often use a subset of
  1045.    RFC 822 headers or provide similar functionality with a different
  1046.    syntax, but some of these mail systems do not have an equivalent to
  1047.    the SMTP envelope.  Therefore, when a message leaves the Internet
  1048.    environment, it may be necessary to fold the SMTP envelope
  1049.    information into the message header.  A possible solution would be to
  1050.    create new header fields to carry the envelope information (e.g.,
  1051.    "X-SMTP-MAIL:"  and "X-SMTP-RCPT:"); however, this would require
  1052.    changes in mail programs in foreign environments and might risk
  1053.    disclosure of private information (see section 7.2).
  1054. 3.8.2 Received Lines in Gatewaying
  1055.    When forwarding a message into or out of the Internet environment, a
  1056.    gateway MUST prepend a Received: line, but it MUST NOT alter in any
  1057.    way a Received: line that is already in the header.
  1058.    "Received:" fields of messages originating from other environments
  1059.    may not conform exactly to this specification.  However, the most
  1060.    important use of Received: lines is for debugging mail faults, and
  1061.    this debugging can be severely hampered by well-meaning gateways that
  1062.    try to "fix" a Received: line.  As another consequence of trace
  1063.    fields arising in non-SMTP environments, receiving systems MUST NOT
  1064.    reject mail based on the format of a trace field and SHOULD be
  1065.    extremely robust in the light of unexpected information or formats in
  1066.    those fields.
  1067.    The gateway SHOULD indicate the environment and protocol in the "via"
  1068.    clauses of Received field(s) that it supplies.
  1069. 3.8.3 Addresses in Gatewaying
  1070.    From the Internet side, the gateway SHOULD accept all valid address
  1071.    formats in SMTP commands and in RFC 822 headers, and all valid RFC
  1072.    822 messages.  Addresses and headers generated by gateways MUST
  1073.    conform to applicable Internet standards (including this one and RFC
  1074.    822).  Gateways are, of course, subject to the same rules for
  1075.    handling source routes as those described for other SMTP systems in
  1076.    section 3.3.
  1077. Klensin                     Standards Track                    [Page 26]
  1078. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1079. 3.8.4 Other Header Fields in Gatewaying
  1080.    The gateway MUST ensure that all header fields of a message that it
  1081.    forwards into the Internet mail environment meet the requirements for
  1082.    Internet mail.  In particular, all addresses in "From:", "To:",
  1083.    "Cc:", etc., fields MUST be transformed (if necessary) to satisfy RFC
  1084.    822 syntax, MUST reference only fully-qualified domain names, and
  1085.    MUST be effective and useful for sending replies.  The translation
  1086.    algorithm used to convert mail from the Internet protocols to another
  1087.    environment's protocol SHOULD ensure that error messages from the
  1088.    foreign mail environment are delivered to the return path from the
  1089.    SMTP envelope, not to the sender listed in the "From:" field (or
  1090.    other fields) of the RFC 822 message.
  1091. 3.8.5 Envelopes in Gatewaying
  1092.    Similarly, when forwarding a message from another environment into
  1093.    the Internet, the gateway SHOULD set the envelope return path in
  1094.    accordance with an error message return address, if supplied by the
  1095.    foreign environment.  If the foreign environment has no equivalent
  1096.    concept, the gateway must select and use a best approximation, with
  1097.    the message originator's address as the default of last resort.
  1098. 3.9 Terminating Sessions and Connections
  1099.    An SMTP connection is terminated when the client sends a QUIT
  1100.    command.  The server responds with a positive reply code, after which
  1101.    it closes the connection.
  1102.    An SMTP server MUST NOT intentionally close the connection except:
  1103.    -  After receiving a QUIT command and responding with a 221 reply.
  1104.    -  After detecting the need to shut down the SMTP service and
  1105.       returning a 421 response code.  This response code can be issued
  1106.       after the server receives any command or, if necessary,
  1107.       asynchronously from command receipt (on the assumption that the
  1108.       client will receive it after the next command is issued).
  1109.    In particular, a server that closes connections in response to
  1110.    commands that are not understood is in violation of this
  1111.    specification.  Servers are expected to be tolerant of unknown
  1112.    commands, issuing a 500 reply and awaiting further instructions from
  1113.    the client.
  1114. Klensin                     Standards Track                    [Page 27]
  1115. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1116.    An SMTP server which is forcibly shut down via external means SHOULD
  1117.    attempt to send a line containing a 421 response code to the SMTP
  1118.    client before exiting.  The SMTP client will normally read the 421
  1119.    response code after sending its next command.
  1120.    SMTP clients that experience a connection close, reset, or other
  1121.    communications failure due to circumstances not under their control
  1122.    (in violation of the intent of this specification but sometimes
  1123.    unavoidable) SHOULD, to maintain the robustness of the mail system,
  1124.    treat the mail transaction as if a 451 response had been received and
  1125.    act accordingly.
  1126. 3.10 Mailing Lists and Aliases
  1127.    An SMTP-capable host SHOULD support both the alias and the list
  1128.    models of address expansion for multiple delivery.  When a message is
  1129.    delivered or forwarded to each address of an expanded list form, the
  1130.    return address in the envelope ("MAIL FROM:") MUST be changed to be
  1131.    the address of a person or other entity who administers the list.
  1132.    However, in this case, the message header [32] MUST be left
  1133.    unchanged; in particular, the "From" field of the message header is
  1134.    unaffected.
  1135.    An important mail facility is a mechanism for multi-destination
  1136.    delivery of a single message, by transforming (or "expanding" or
  1137.    "exploding") a pseudo-mailbox address into a list of destination
  1138.    mailbox addresses.  When a message is sent to such a pseudo-mailbox
  1139.    (sometimes called an "exploder"), copies are forwarded or
  1140.    redistributed to each mailbox in the expanded list.  Servers SHOULD
  1141.    simply utilize the addresses on the list; application of heuristics
  1142.    or other matching rules to eliminate some addresses, such as that of
  1143.    the originator, is strongly discouraged.  We classify such a pseudo-
  1144.    mailbox as an "alias" or a "list", depending upon the expansion
  1145.    rules.
  1146. 3.10.1 Alias
  1147.    To expand an alias, the recipient mailer simply replaces the pseudo-
  1148.    mailbox address in the envelope with each of the expanded addresses
  1149.    in turn; the rest of the envelope and the message body are left
  1150.    unchanged.  The message is then delivered or forwarded to each
  1151.    expanded address.
  1152. 3.10.2 List
  1153.    A mailing list may be said to operate by "redistribution" rather than
  1154.    by "forwarding".  To expand a list, the recipient mailer replaces the
  1155.    pseudo-mailbox address in the envelope with all of the expanded
  1156. Klensin                     Standards Track                    [Page 28]
  1157. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1158.    addresses.  The return address in the envelope is changed so that all
  1159.    error messages generated by the final deliveries will be returned to
  1160.    a list administrator, not to the message originator, who generally
  1161.    has no control over the contents of the list and will typically find
  1162.    error messages annoying.
  1163. 4. The SMTP Specifications
  1164. 4.1 SMTP Commands
  1165. 4.1.1 Command Semantics and Syntax
  1166.    The SMTP commands define the mail transfer or the mail system
  1167.    function requested by the user.  SMTP commands are character strings
  1168.    terminated by <CRLF>.  The commands themselves are alphabetic
  1169.    characters terminated by <SP> if parameters follow and <CRLF>
  1170.    otherwise.  (In the interest of improved interoperability, SMTP
  1171.    receivers are encouraged to tolerate trailing white space before the
  1172.    terminating <CRLF>.)  The syntax of the local part of a mailbox must
  1173.    conform to receiver site conventions and the syntax specified in
  1174.    section 4.1.2.  The SMTP commands are discussed below.  The SMTP
  1175.    replies are discussed in section 4.2.
  1176.    A mail transaction involves several data objects which are
  1177.    communicated as arguments to different commands.  The reverse-path is
  1178.    the argument of the MAIL command, the forward-path is the argument of
  1179.    the RCPT command, and the mail data is the argument of the DATA
  1180.    command.  These arguments or data objects must be transmitted and
  1181.    held pending the confirmation communicated by the end of mail data
  1182.    indication which finalizes the transaction.  The model for this is
  1183.    that distinct buffers are provided to hold the types of data objects,
  1184.    that is, there is a reverse-path buffer, a forward-path buffer, and a
  1185.    mail data buffer.  Specific commands cause information to be appended
  1186.    to a specific buffer, or cause one or more buffers to be cleared.
  1187.    Several commands (RSET, DATA, QUIT) are specified as not permitting
  1188.    parameters.  In the absence of specific extensions offered by the
  1189.    server and accepted by the client, clients MUST NOT send such
  1190.    parameters and servers SHOULD reject commands containing them as
  1191.    having invalid syntax.
  1192. 4.1.1.1  Extended HELLO (EHLO) or HELLO (HELO)
  1193.    These commands are used to identify the SMTP client to the SMTP
  1194.    server.  The argument field contains the fully-qualified domain name
  1195.    of the SMTP client if one is available.  In situations in which the
  1196.    SMTP client system does not have a meaningful domain name (e.g., when
  1197.    its address is dynamically allocated and no reverse mapping record is
  1198. Klensin                     Standards Track                    [Page 29]
  1199. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1200.    available), the client SHOULD send an address literal (see section
  1201.    4.1.3), optionally followed by information that will help to identify
  1202.    the client system.  y The SMTP server identifies itself to the SMTP
  1203.    client in the connection greeting reply and in the response to this
  1204.    command.
  1205.    A client SMTP SHOULD start an SMTP session by issuing the EHLO
  1206.    command.  If the SMTP server supports the SMTP service extensions it
  1207.    will give a successful response, a failure response, or an error
  1208.    response.  If the SMTP server, in violation of this specification,
  1209.    does not support any SMTP service extensions it will generate an
  1210.    error response.  Older client SMTP systems MAY, as discussed above,
  1211.    use HELO (as specified in RFC 821) instead of EHLO, and servers MUST
  1212.    support the HELO command and reply properly to it.  In any event, a
  1213.    client MUST issue HELO or EHLO before starting a mail transaction.
  1214.    These commands, and a "250 OK" reply to one of them, confirm that
  1215.    both the SMTP client and the SMTP server are in the initial state,
  1216.    that is, there is no transaction in progress and all state tables and
  1217.    buffers are cleared.
  1218.    Syntax:
  1219.       ehlo            = "EHLO" SP Domain CRLF
  1220.       helo            = "HELO" SP Domain CRLF
  1221.    Normally, the response to EHLO will be a multiline reply.  Each line
  1222.    of the response contains a keyword and, optionally, one or more
  1223.    parameters.  Following the normal syntax for multiline replies, these
  1224.    keyworks follow the code (250) and a hyphen for all but the last
  1225.    line, and the code and a space for the last line.  The syntax for a
  1226.    positive response, using the ABNF notation and terminal symbols of
  1227.    [8], is:
  1228.       ehlo-ok-rsp  =    ( "250"    domain [ SP ehlo-greet ] CRLF )
  1229.                    / (    "250-"   domain [ SP ehlo-greet ] CRLF
  1230.                        *( "250-"   ehlo-line                CRLF )
  1231.                           "250"    SP ehlo-line             CRLF  )
  1232.       ehlo-greet   = 1*(%d0-9 / %d11-12 / %d14-127)
  1233.                    ; string of any characters other than CR or LF
  1234.       ehlo-line    = ehlo-keyword *( SP ehlo-param )
  1235.       ehlo-keyword = (ALPHA / DIGIT) *(ALPHA / DIGIT / "-")
  1236.                    ; additional syntax of ehlo-params depends on
  1237.                    ; ehlo-keyword
  1238. Klensin                     Standards Track                    [Page 30]
  1239. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1240.       ehlo-param   = 1*(%d33-127)
  1241.                    ; any CHAR excluding <SP> and all
  1242.                    ; control characters (US-ASCII 0-31 inclusive)
  1243.    Although EHLO keywords may be specified in upper, lower, or mixed
  1244.    case, they MUST always be recognized and processed in a case-
  1245.    insensitive manner.  This is simply an extension of practices
  1246.    specified in RFC 821 and section 2.4.1.
  1247. 4.1.1.2 MAIL (MAIL)
  1248.    This command is used to initiate a mail transaction in which the mail
  1249.    data is delivered to an SMTP server which may, in turn, deliver it to
  1250.    one or more mailboxes or pass it on to another system (possibly using
  1251.    SMTP).  The argument field contains a reverse-path and may contain
  1252.    optional parameters.  In general, the MAIL command may be sent only
  1253.    when no mail transaction is in progress, see section 4.1.4.
  1254.    The reverse-path consists of the sender mailbox.  Historically, that
  1255.    mailbox might optionally have been preceded by a list of hosts, but
  1256.    that behavior is now deprecated (see appendix C).  In some types of
  1257.    reporting messages for which a reply is likely to cause a mail loop
  1258.    (for example, mail delivery and nondelivery notifications), the
  1259.    reverse-path may be null (see section 3.7).
  1260.    This command clears the reverse-path buffer, the forward-path buffer,
  1261.    and the mail data buffer; and inserts the reverse-path information
  1262.    from this command into the reverse-path buffer.
  1263.    If service extensions were negotiated, the MAIL command may also
  1264.    carry parameters associated with a particular service extension.
  1265.    Syntax:
  1266.       "MAIL FROM:" ("<>" / Reverse-Path)
  1267.                        [SP Mail-parameters] CRLF
  1268. 4.1.1.3 RECIPIENT (RCPT)
  1269.    This command is used to identify an individual recipient of the mail
  1270.    data; multiple recipients are specified by multiple use of this
  1271.    command.  The argument field contains a forward-path and may contain
  1272.    optional parameters.
  1273.    The forward-path normally consists of the required destination
  1274.    mailbox.  Sending systems SHOULD not generate the optional list of
  1275.    hosts known as a source route.  Receiving systems MUST recognize
  1276. Klensin                     Standards Track                    [Page 31]
  1277. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1278.    source route syntax but SHOULD strip off the source route
  1279.    specification and utilize the domain name associated with the mailbox
  1280.    as if the source route had not been provided.
  1281.    Similarly, relay hosts SHOULD strip or ignore source routes, and
  1282.    names MUST NOT be copied into the reverse-path.  When mail reaches
  1283.    its ultimate destination (the forward-path contains only a
  1284.    destination mailbox), the SMTP server inserts it into the destination
  1285.    mailbox in accordance with its host mail conventions.
  1286.    For example, mail received at relay host xyz.com with envelope
  1287.    commands
  1288.       MAIL FROM:<userx@y.foo.org>
  1289.       RCPT TO:<@hosta.int,@jkl.org:userc@d.bar.org>
  1290.    will normally be sent directly on to host d.bar.org with envelope
  1291.    commands
  1292.       MAIL FROM:<userx@y.foo.org>
  1293.       RCPT TO:<userc@d.bar.org>
  1294.    As provided in appendix C, xyz.com MAY also choose to relay the
  1295.    message to hosta.int, using the envelope commands
  1296.       MAIL FROM:<userx@y.foo.org>
  1297.       RCPT TO:<@hosta.int,@jkl.org:userc@d.bar.org>
  1298.    or to jkl.org, using the envelope commands
  1299.       MAIL FROM:<userx@y.foo.org>
  1300.       RCPT TO:<@jkl.org:userc@d.bar.org>
  1301.    Of course, since hosts are not required to relay mail at all, xyz.com
  1302.    may also reject the message entirely when the RCPT command is
  1303.    received, using a 550 code (since this is a "policy reason").
  1304.    If service extensions were negotiated, the RCPT command may also
  1305.    carry parameters associated with a particular service extension
  1306.    offered by the server.  The client MUST NOT transmit parameters other
  1307.    than those associated with a service extension offered by the server
  1308.    in its EHLO response.
  1309. Syntax:
  1310.    "RCPT TO:" ("<Postmaster@" domain ">" / "<Postmaster>" / Forward-Path)
  1311.                     [SP Rcpt-parameters] CRLF
  1312. Klensin                     Standards Track                    [Page 32]
  1313. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1314. 4.1.1.4 DATA (DATA)
  1315.    The receiver normally sends a 354 response to DATA, and then treats
  1316.    the lines (strings ending in <CRLF> sequences, as described in
  1317.    section 2.3.7) following the command as mail data from the sender.
  1318.    This command causes the mail data to be appended to the mail data
  1319.    buffer.  The mail data may contain any of the 128 ASCII character
  1320.    codes, although experience has indicated that use of control
  1321.    characters other than SP, HT, CR, and LF may cause problems and
  1322.    SHOULD be avoided when possible.
  1323.    The mail data is terminated by a line containing only a period, that
  1324.    is, the character sequence "<CRLF>.<CRLF>" (see section 4.5.2).  This
  1325.    is the end of mail data indication.  Note that the first <CRLF> of
  1326.    this terminating sequence is also the <CRLF> that ends the final line
  1327.    of the data (message text) or, if there was no data, ends the DATA
  1328.    command itself.  An extra <CRLF> MUST NOT be added, as that would
  1329.    cause an empty line to be added to the message.  The only exception
  1330.    to this rule would arise if the message body were passed to the
  1331.    originating SMTP-sender with a final "line" that did not end in
  1332.    <CRLF>; in that case, the originating SMTP system MUST either reject
  1333.    the message as invalid or add <CRLF> in order to have the receiving
  1334.    SMTP server recognize the "end of data" condition.
  1335.    The custom of accepting lines ending only in <LF>, as a concession to
  1336.    non-conforming behavior on the part of some UNIX systems, has proven
  1337.    to cause more interoperability problems than it solves, and SMTP
  1338.    server systems MUST NOT do this, even in the name of improved
  1339.    robustness.  In particular, the sequence "<LF>.<LF>" (bare line
  1340.    feeds, without carriage returns) MUST NOT be treated as equivalent to
  1341.    <CRLF>.<CRLF> as the end of mail data indication.
  1342.    Receipt of the end of mail data indication requires the server to
  1343.    process the stored mail transaction information.  This processing
  1344.    consumes the information in the reverse-path buffer, the forward-path
  1345.    buffer, and the mail data buffer, and on the completion of this
  1346.    command these buffers are cleared.  If the processing is successful,
  1347.    the receiver MUST send an OK reply.  If the processing fails the
  1348.    receiver MUST send a failure reply.  The SMTP model does not allow
  1349.    for partial failures at this point: either the message is accepted by
  1350.    the server for delivery and a positive response is returned or it is
  1351.    not accepted and a failure reply is returned.  In sending a positive
  1352.    completion reply to the end of data indication, the receiver takes
  1353.    full responsibility for the message (see section 6.1).  Errors that
  1354.    are diagnosed subsequently MUST be reported in a mail message, as
  1355.    discussed in section 4.4.
  1356. Klensin                     Standards Track                    [Page 33]
  1357. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1358.    When the SMTP server accepts a message either for relaying or for
  1359.    final delivery, it inserts a trace record (also referred to
  1360.    interchangeably as a "time stamp line" or "Received" line) at the top
  1361.    of the mail data.  This trace record indicates the identity of the
  1362.    host that sent the message, the identity of the host that received
  1363.    the message (and is inserting this time stamp), and the date and time
  1364.    the message was received.  Relayed messages will have multiple time
  1365.    stamp lines.  Details for formation of these lines, including their
  1366.    syntax, is specified in section 4.4.
  1367.    Additional discussion about the operation of the DATA command appears
  1368.    in section 3.3.
  1369.    Syntax:
  1370.       "DATA" CRLF
  1371. 4.1.1.5 RESET (RSET)
  1372.    This command specifies that the current mail transaction will be
  1373.    aborted.  Any stored sender, recipients, and mail data MUST be
  1374.    discarded, and all buffers and state tables cleared.  The receiver
  1375.    MUST send a "250 OK" reply to a RSET command with no arguments.  A
  1376.    reset command may be issued by the client at any time.  It is
  1377.    effectively equivalent to a NOOP (i.e., if has no effect) if issued
  1378.    immediately after EHLO, before EHLO is issued in the session, after
  1379.    an end-of-data indicator has been sent and acknowledged, or
  1380.    immediately before a QUIT.  An SMTP server MUST NOT close the
  1381.    connection as the result of receiving a RSET; that action is reserved
  1382.    for QUIT (see section 4.1.1.10).
  1383.    Since EHLO implies some additional processing and response by the
  1384.    server, RSET will normally be more efficient than reissuing that
  1385.    command, even though the formal semantics are the same.
  1386.    There are circumstances, contrary to the intent of this
  1387.    specification, in which an SMTP server may receive an indication that
  1388.    the underlying TCP connection has been closed or reset.  To preserve
  1389.    the robustness of the mail system, SMTP servers SHOULD be prepared
  1390.    for this condition and SHOULD treat it as if a QUIT had been received
  1391.    before the connection disappeared.
  1392.    Syntax:
  1393.       "RSET" CRLF
  1394. Klensin                     Standards Track                    [Page 34]
  1395. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1396. 4.1.1.6 VERIFY (VRFY)
  1397.    This command asks the receiver to confirm that the argument
  1398.    identifies a user or mailbox.  If it is a user name, information is
  1399.    returned as specified in section 3.5.
  1400.    This command has no effect on the reverse-path buffer, the forward-
  1401.    path buffer, or the mail data buffer.
  1402.    Syntax:
  1403.       "VRFY" SP String CRLF
  1404. 4.1.1.7 EXPAND (EXPN)
  1405.    This command asks the receiver to confirm that the argument
  1406.    identifies a mailing list, and if so, to return the membership of
  1407.    that list.  If the command is successful, a reply is returned
  1408.    containing information as described in section 3.5.  This reply will
  1409.    have multiple lines except in the trivial case of a one-member list.
  1410.    This command has no effect on the reverse-path buffer, the forward-
  1411.    path buffer, or the mail data buffer and may be issued at any time.
  1412.    Syntax:
  1413.       "EXPN" SP String CRLF
  1414. 4.1.1.8 HELP (HELP)
  1415.    This command causes the server to send helpful information to the
  1416.    client.  The command MAY take an argument (e.g., any command name)
  1417.    and return more specific information as a response.
  1418.    This command has no effect on the reverse-path buffer, the forward-
  1419.    path buffer, or the mail data buffer and may be issued at any time.
  1420.    SMTP servers SHOULD support HELP without arguments and MAY support it
  1421.    with arguments.
  1422.    Syntax:
  1423.       "HELP" [ SP String ] CRLF
  1424. 4.1.1.9 NOOP (NOOP)
  1425.    This command does not affect any parameters or previously entered
  1426.    commands.  It specifies no action other than that the receiver send
  1427.    an OK reply.
  1428. Klensin                     Standards Track                    [Page 35]
  1429. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1430.    This command has no effect on the reverse-path buffer, the forward-
  1431.    path buffer, or the mail data buffer and may be issued at any time.
  1432.    If a parameter string is specified, servers SHOULD ignore it.
  1433.    Syntax:
  1434.       "NOOP" [ SP String ] CRLF
  1435. 4.1.1.10 QUIT (QUIT)
  1436.    This command specifies that the receiver MUST send an OK reply, and
  1437.    then close the transmission channel.
  1438.    The receiver MUST NOT intentionally close the transmission channel
  1439.    until it receives and replies to a QUIT command (even if there was an
  1440.    error).  The sender MUST NOT intentionally close the transmission
  1441.    channel until it sends a QUIT command and SHOULD wait until it
  1442.    receives the reply (even if there was an error response to a previous
  1443.    command).  If the connection is closed prematurely due to violations
  1444.    of the above or system or network failure, the server MUST cancel any
  1445.    pending transaction, but not undo any previously completed
  1446.    transaction, and generally MUST act as if the command or transaction
  1447.    in progress had received a temporary error (i.e., a 4yz response).
  1448.    The QUIT command may be issued at any time.
  1449.    Syntax:
  1450.       "QUIT" CRLF
  1451. 4.1.2 Command Argument Syntax
  1452.    The syntax of the argument fields of the above commands (using the
  1453.    syntax specified in [8] where applicable) is given below.  Some of
  1454.    the productions given below are used only in conjunction with source
  1455.    routes as described in appendix C.  Terminals not defined in this
  1456.    document, such as ALPHA, DIGIT, SP, CR, LF, CRLF, are as defined in
  1457.    the "core" syntax [8 (section 6)] or in the message format syntax
  1458.    [32].
  1459.       Reverse-path = Path
  1460.       Forward-path = Path
  1461.       Path = "<" [ A-d-l ":" ] Mailbox ">"
  1462.       A-d-l = At-domain *( "," A-d-l )
  1463.             ; Note that this form, the so-called "source route",
  1464.             ; MUST BE accepted, SHOULD NOT be generated, and SHOULD be
  1465.             ; ignored.
  1466.       At-domain = "@" domain
  1467.       Mail-parameters = esmtp-param *(SP esmtp-param)
  1468.       Rcpt-parameters = esmtp-param *(SP esmtp-param)
  1469. Klensin                     Standards Track                    [Page 36]
  1470. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1471.       esmtp-param     = esmtp-keyword ["=" esmtp-value]
  1472.       esmtp-keyword   = (ALPHA / DIGIT) *(ALPHA / DIGIT / "-")
  1473.       esmtp-value     = 1*(%d33-60 / %d62-127)
  1474.             ; any CHAR excluding "=", SP, and control characters
  1475.       Keyword  = Ldh-str
  1476.       Argument = Atom
  1477.       Domain = (sub-domain 1*("." sub-domain)) / address-literal
  1478.       sub-domain = Let-dig [Ldh-str]
  1479.       address-literal = "[" IPv4-address-literal /
  1480.                             IPv6-address-literal /
  1481.                             General-address-literal "]"
  1482.             ; See section 4.1.3
  1483.       Mailbox = Local-part "@" Domain
  1484.       Local-part = Dot-string / Quoted-string
  1485.             ; MAY be case-sensitive
  1486.       Dot-string = Atom *("." Atom)
  1487.       Atom = 1*atext
  1488.       Quoted-string = DQUOTE *qcontent DQUOTE
  1489.       String = Atom / Quoted-string
  1490.    While the above definition for Local-part is relatively permissive,
  1491.    for maximum interoperability, a host that expects to receive mail
  1492.    SHOULD avoid defining mailboxes where the Local-part requires (or
  1493.    uses) the Quoted-string form or where the Local-part is case-
  1494.    sensitive.  For any purposes that require generating or comparing
  1495.    Local-parts (e.g., to specific mailbox names), all quoted forms MUST
  1496.    be treated as equivalent and the sending system SHOULD transmit the
  1497.    form that uses the minimum quoting possible.
  1498.    Systems MUST NOT define mailboxes in such a way as to require the use
  1499.    in SMTP of non-ASCII characters (octets with the high order bit set
  1500.    to one) or ASCII "control characters" (decimal value 0-31 and 127).
  1501.    These characters MUST NOT be used in MAIL or RCPT commands or other
  1502.    commands that require mailbox names.
  1503.    Note that the backslash, "", is a quote character, which is used to
  1504.    indicate that the next character is to be used literally (instead of
  1505.    its normal interpretation).  For example, "Joe,Smith" indicates a
  1506.    single nine character user field with the comma being the fourth
  1507.    character of the field.
  1508. Klensin                     Standards Track                    [Page 37]
  1509. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1510.    To promote interoperability and consistent with long-standing
  1511.    guidance about conservative use of the DNS in naming and applications
  1512.    (e.g., see section 2.3.1 of the base DNS document, RFC1035 [22]),
  1513.    characters outside the set of alphas, digits, and hyphen MUST NOT
  1514.    appear in domain name labels for SMTP clients or servers.  In
  1515.    particular, the underscore character is not permitted.  SMTP servers
  1516.    that receive a command in which invalid character codes have been
  1517.    employed, and for which there are no other reasons for rejection,
  1518.    MUST reject that command with a 501 response.
  1519. 4.1.3 Address Literals
  1520.    Sometimes a host is not known to the domain name system and
  1521.    communication (and, in particular, communication to report and repair
  1522.    the error) is blocked.  To bypass this barrier a special literal form
  1523.    of the address is allowed as an alternative to a domain name.  For
  1524.    IPv4 addresses, this form uses four small decimal integers separated
  1525.    by dots and enclosed by brackets such as [123.255.37.2], which
  1526.    indicates an (IPv4) Internet Address in sequence-of-octets form.  For
  1527.    IPv6 and other forms of addressing that might eventually be
  1528.    standardized, the form consists of a standardized "tag" that
  1529.    identifies the address syntax, a colon, and the address itself, in a
  1530.    format specified as part of the IPv6 standards [17].
  1531.    Specifically:
  1532.       IPv4-address-literal = Snum 3("." Snum)
  1533.       IPv6-address-literal = "IPv6:" IPv6-addr
  1534.       General-address-literal = Standardized-tag ":" 1*dcontent
  1535.       Standardized-tag = Ldh-str
  1536.             ; MUST be specified in a standards-track RFC
  1537.             ; and registered with IANA
  1538.       Snum = 1*3DIGIT  ; representing a decimal integer
  1539.             ; value in the range 0 through 255
  1540.       Let-dig = ALPHA / DIGIT
  1541.       Ldh-str = *( ALPHA / DIGIT / "-" ) Let-dig
  1542.       IPv6-addr = IPv6-full / IPv6-comp / IPv6v4-full / IPv6v4-comp
  1543.       IPv6-hex  = 1*4HEXDIG
  1544.       IPv6-full = IPv6-hex 7(":" IPv6-hex)
  1545.       IPv6-comp = [IPv6-hex *5(":" IPv6-hex)] "::" [IPv6-hex *5(":"
  1546.                  IPv6-hex)]
  1547.             ; The "::" represents at least 2 16-bit groups of zeros
  1548.             ; No more than 6 groups in addition to the "::" may be
  1549.             ; present
  1550.       IPv6v4-full = IPv6-hex 5(":" IPv6-hex) ":" IPv4-address-literal
  1551.       IPv6v4-comp = [IPv6-hex *3(":" IPv6-hex)] "::"
  1552. Klensin                     Standards Track                    [Page 38]
  1553. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1554.                    [IPv6-hex *3(":" IPv6-hex) ":"] IPv4-address-literal
  1555.             ; The "::" represents at least 2 16-bit groups of zeros
  1556.             ; No more than 4 groups in addition to the "::" and
  1557.             ; IPv4-address-literal may be present
  1558. 4.1.4 Order of Commands
  1559.    There are restrictions on the order in which these commands may be
  1560.    used.
  1561.    A session that will contain mail transactions MUST first be
  1562.    initialized by the use of the EHLO command.  An SMTP server SHOULD
  1563.    accept commands for non-mail transactions (e.g., VRFY or EXPN)
  1564.    without this initialization.
  1565.    An EHLO command MAY be issued by a client later in the session.  If
  1566.    it is issued after the session begins, the SMTP server MUST clear all
  1567.    buffers and reset the state exactly as if a RSET command had been
  1568.    issued.  In other words, the sequence of RSET followed immediately by
  1569.    EHLO is redundant, but not harmful other than in the performance cost
  1570.    of executing unnecessary commands.
  1571.    If the EHLO command is not acceptable to the SMTP server, 501, 500,
  1572.    or 502 failure replies MUST be returned as appropriate.  The SMTP
  1573.    server MUST stay in the same state after transmitting these replies
  1574.    that it was in before the EHLO was received.
  1575.    The SMTP client MUST, if possible, ensure that the domain parameter
  1576.    to the EHLO command is a valid principal host name (not a CNAME or MX
  1577.    name) for its host.  If this is not possible (e.g., when the client's
  1578.    address is dynamically assigned and the client does not have an
  1579.    obvious name), an address literal SHOULD be substituted for the
  1580.    domain name and supplemental information provided that will assist in
  1581.    identifying the client.
  1582.    An SMTP server MAY verify that the domain name parameter in the EHLO
  1583.    command actually corresponds to the IP address of the client.
  1584.    However, the server MUST NOT refuse to accept a message for this
  1585.    reason if the verification fails: the information about verification
  1586.    failure is for logging and tracing only.
  1587.    The NOOP, HELP, EXPN, VRFY, and RSET commands can be used at any time
  1588.    during a session, or without previously initializing a session.  SMTP
  1589.    servers SHOULD process these normally (that is, not return a 503
  1590.    code) even if no EHLO command has yet been received; clients SHOULD
  1591.    open a session with EHLO before sending these commands.
  1592. Klensin                     Standards Track                    [Page 39]
  1593. RFC 2821             Simple Mail Transfer Protocol            April 2001
  1594.    If these rules are followed, the example in RFC 821 that shows "550
  1595.    access denied to you" in response to an EXPN command is incorrect
  1596.    unless an EHLO command precedes the EXPN or the denial of access is
  1597.    based on the client's IP address or other authentication or
  1598.    authorization-determining mechanisms.
  1599.    The MAIL command (or the obsolete SEND, SOML, or SAML commands)
  1600.    begins a mail transaction.  Once started, a mail transaction consists
  1601.    of a transaction beginning command, one or more RCPT commands, and a
  1602.    DATA command, in that order.  A mail transaction may be aborted by
  1603.    the RSET (or a new EHLO) command.  There may be zero or more
  1604.    transactions in a session.  MAIL (or SEND, SOML, or SAML) MUST NOT be
  1605.    sent if a mail transaction is already open, i.e., it should be sent
  1606.    only if no mail transaction had been started in the session, or it
  1607.    the previous one successfully concluded with a successful DATA
  1608.    command, or if the previous one was aborted with a RSET.
  1609.    If the transaction beginning command argument is not acceptable, a
  1610.    501 failure reply MUST be returned and the SMTP server MUST stay in
  1611.    the same state.  If the commands in a transaction are out of order to
  1612.    the degree that they cannot be processed by the server, a 503 failure
  1613.    reply MUST be returned and the SMTP server MUST stay in the same
  1614.    state.