home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / r / rfc822.zip / RFC822.TXT < prev   
Text File  |  1987-04-19  |  132KB  |  3,334 lines
  1.  
  2.  
  3.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  4.  
  5.  
  6.                                   PREFACE
  7.  
  8.  
  9.           By 1977, the Arpanet employed several informal standards for
  10.      the  text  messages (mail) sent among its host computers.  It was
  11.      felt necessary to codify these practices and  provide  for  those
  12.      features  that  seemed  imminent.   The result of that effort was
  13.      Request for Comments (RFC) #733, "Standard for the Format of ARPA
  14.      Network Text Message", by Crocker, Vittal, Pogran, and Henderson.
  15.      The specification attempted to avoid major  changes  in  existing
  16.      software, while permitting several new features.
  17.  
  18.           This document revises the specifications  in  RFC  #733,  in
  19.      order  to  serve  the  needs  of the larger and more complex ARPA
  20.      Internet.  Some of RFC #733's features failed  to  gain  adequate
  21.      acceptance.   In  order to simplify the standard and the software
  22.      that follows it, these features have been removed.   A  different
  23.      addressing  scheme  is  used, to handle the case of inter-network
  24.      mail; and the concept of re-transmission has been introduced.
  25.  
  26.           This specification is intended for use in the ARPA Internet.
  27.      However, an attempt has been made to free it of any dependence on
  28.      that environment, so that it can be applied to other network text
  29.      message systems.
  30.  
  31.           The specification of RFC #733 took place over the course  of
  32.      one  year, using the ARPANET mail environment, itself, to provide
  33.      an on-going forum for discussing the capabilities to be included.
  34.      More  than  twenty individuals, from across the country, partici-
  35.      pated in  the  original  discussion.   The  development  of  this
  36.      revised specification has, similarly, utilized network mail-based
  37.      group discussion.  Both specification efforts  greatly  benefited
  38.      from the comments and ideas of the participants.
  39.  
  40.           The syntax of the standard,  in  RFC  #733,  was  originally
  41.      specified  in  the  Backus-Naur Form (BNF) meta-language.  Ken L.
  42.      Harrenstien, of SRI International, was responsible for  re-coding
  43.      the  BNF  into  an  augmented  BNF  that makes the representation
  44.      smaller and easier to understand.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  55.  
  56.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- iiiiiiii ----                      RRRRFFFFCCCC ####888822222222
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  69.  
  70.  
  71.      _1.  _I_N_T_R_O_D_U_C_T_I_O_N
  72.  
  73.      _1._1.  _S_c_o_p_e
  74.  
  75.           This standard specifies a syntax for text messages that  are
  76.      sent  among  computer  users, within the framework of "electronic
  77.      mail".  The standard supersedes  the  one  specified  in  ARPANET
  78.      Request  for Comments #733, "Standard for the Format of ARPA Net-
  79.      work Text Messages".
  80.  
  81.           In this context, messages are viewed as having  an  envelope
  82.      and  contents.   The  envelope  contains  whatever information is
  83.      needed to accomplish transmission  and  delivery.   The  contents
  84.      compose  the object to be delivered to the recipient.  This stan-
  85.      dard applies only to the format and some of the semantics of mes-
  86.      sage  contents.   It contains no specification of the information
  87.      in the envelope.
  88.  
  89.           However, some message systems may use information  from  the
  90.      contents  to create the envelope.  It is intended that this stan-
  91.      dard facilitate the acquisition of such information by programs.
  92.  
  93.           Some message systems may  store  messages  in  formats  that
  94.      differ  from the one specified in this standard.  This specifica-
  95.      tion is intended strictly as a definition of what message content
  96.      format is to be passed _b_e_t_w_e_e_n hosts.
  97.  
  98.      Note:  This standard is _n_o_t intended to dictate the internal for-
  99.             mats  used  by sites, the specific message system features
  100.             that they are expected to support, or any of  the  charac-
  101.             teristics  of  user interface programs that create or read
  102.             messages.
  103.  
  104.           A distinction should be made between what the  specification
  105.      _r_e_q_u_i_r_e_s  and  what  it _a_l_l_o_w_s.  Messages can be made complex and
  106.      rich with formally-structured components of information or can be
  107.      kept small and simple, with a minimum of such information.  Also,
  108.      the standard simplifies the interpretation  of  differing  visual
  109.      formats  in  messages;  only  the  visual  aspect of a message is
  110.      affected and not the interpretation  of  information  within  it.
  111.      Implementors may choose to retain such visual distinctions.
  112.  
  113.           The formal definition is divided into four levels.  The bot-
  114.      tom level describes the meta-notation used in this document.  The
  115.      second level describes basic lexical analyzers that  feed  tokens
  116.      to  higher-level  parsers.   Next is an overall specification for
  117.      messages; it permits distinguishing individual fields.   Finally,
  118.      there is definition of the contents of several structured fields.
  120.  
  121.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- 1111 ----                      RRRRFFFFCCCC ####888822222222
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  134.  
  135.  
  136.      _1._2.  _C_o_m_m_u_n_i_c_a_t_i_o_n _F_r_a_m_e_w_o_r_k
  137.  
  138.           Messages consist of lines of text.   No  special  provisions
  139.      are  made for encoding drawings, facsimile, speech, or structured
  140.      text.  No significant consideration has been given  to  questions
  141.      of  data  compression  or to transmission and storage efficiency,
  142.      and the standard tends to be free with the number  of  bits  con-
  143.      sumed.   For  example,  field  names  are specified as free text,
  144.      rather than special terse codes.
  145.  
  146.           A general "memo" framework is used.  That is, a message con-
  147.      sists of some information in a rigid format, followed by the main
  148.      part of the message, with a format that is not specified in  this
  149.      document.   The  syntax of several fields of the rigidly-formated
  150.      ("headers") section is defined in  this  specification;  some  of
  151.      these fields must be included in all messages.
  152.  
  153.           The syntax  that  distinguishes  between  header  fields  is
  154.      specified  separately  from  the  internal  syntax for particular
  155.      fields.  This separation is intended to allow simple  parsers  to
  156.      operate on the general structure of messages, without concern for
  157.      the detailed structure of individual header fields.   Appendix  B
  158.      is provided to facilitate construction of these parsers.
  159.  
  160.           In addition to the fields specified in this document, it  is
  161.      expected  that  other fields will gain common use.  As necessary,
  162.      the specifications for these "extension-fields" will be published
  163.      through  the same mechanism used to publish this document.  Users
  164.      may also  wish  to  extend  the  set  of  fields  that  they  use
  165.      privately.  Such "user-defined fields" are permitted.
  166.  
  167.           The framework severely constrains document tone and  appear-
  168.      ance and is primarily useful for most intra-organization communi-
  169.      cations and  well-structured   inter-organization  communication.
  170.      It  also  can  be used for some types of inter-process communica-
  171.      tion, such as simple file transfer and remote job entry.  A  more
  172.      robust  framework might allow for multi-font, multi-color, multi-
  173.      dimension encoding of information.  A  less  robust  one,  as  is
  174.      present  in  most  single-machine  message  systems,  would  more
  175.      severely constrain the ability to add fields and the decision  to
  176.      include specific fields.  In contrast with paper-based communica-
  177.      tion, it is interesting to note that the _r_e_c_e_i_v_e_r  of  a  message
  178.      can   exercise  an  extraordinary  amount  of  control  over  the
  179.      message's appearance.  The amount of actual control available  to
  180.      message  receivers  is  contingent upon the capabilities of their
  181.      individual message systems.
  182.  
  183.  
  185.  
  186.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- 2222 ----                      RRRRFFFFCCCC ####888822222222
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  199.  
  200.  
  201.      _2.  _N_O_T_A_T_I_O_N_A_L _C_O_N_V_E_N_T_I_O_N_S
  202.  
  203.           This specification uses an augmented Backus-Naur Form  (BNF)
  204.      notation.  The differences from standard BNF involve naming rules
  205.      and indicating repetition and "local" alternatives.
  206.  
  207.      _2._1.  _R_u_l_e _n_a_m_i_n_g
  208.  
  209.           Angle brackets ("<", ">") are not  used,  in  general.   The
  210.      name  of  a rule is simply the name itself, rather than "<name>".
  211.      Quotation-marks enclose literal text (which may be  upper  and/or
  212.      lower  case).   Certain  basic  rules  are  in uppercase, such as
  213.      SPACE, TAB, CRLF, DIGIT, ALPHA, etc.  Angle brackets are used  in
  214.      rule  definitions,  and  in  the rest of this  document, whenever
  215.      their presence will facilitate discerning the use of rule names.
  216.  
  217.      _2._2.  _R_u_l_e_1 / _R_u_l_e_2:  _A_l_t_e_r_n_a_t_i_v_e_s
  218.  
  219.           Elements separated by slash ("/") are alternatives.   There-
  220.      fore "foo / bar" will accept foo or bar.
  221.  
  222.      _2._3.  (_R_u_l_e_1 _R_u_l_e_2):  _L_o_c_a_l _a_l_t_e_r_n_a_t_i_v_e_s
  223.  
  224.           Elements enclosed in parentheses are  treated  as  a  single
  225.      element.   Thus,  "(elem  (foo  /  bar)  elem)"  allows the token
  226.      sequences "elem foo elem" and "elem bar elem".
  227.  
  228.      _2._4.  *_R_u_l_e:  _R_e_p_e_t_i_t_i_o_n
  229.  
  230.           The character "*" preceding an element indicates repetition.
  231.      The full form is:
  232.  
  233.                               <l>*<m>element
  234.  
  235.      indicating at least <l> and at most <m> occurrences  of  element.
  236.      Default values are 0 and infinity so that "*(element)" allows any
  237.      number, including zero; "1*element" requires at  least  one;  and
  238.      "1*2element" allows one or two.
  239.  
  240.      _2._5.  [_R_u_l_e]:  _O_p_t_i_o_n_a_l
  241.  
  242.           Square brackets enclose optional elements; "[foo  bar]"   is
  243.      equivalent to "*1(foo bar)".
  244.  
  245.      _2._6.  _n_R_u_l_e:  _S_p_e_c_i_f_i_c _r_e_p_e_t_i_t_i_o_n
  246.  
  247.           "<n>(element)" is equivalent to "<n>*<n>(element)"; that is,
  248.      exactly  <n>  occurrences  of (element). Thus 2DIGIT is a 2-digit
  249.      number, and 3ALPHA is a string of three alphabetic characters.
  250.  
  251.  
  252.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- 3333 ----                      RRRRFFFFCCCC ####888822222222
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  265.  
  266.  
  267.      _2._7.  #_R_u_l_e:  _L_i_s_t_s
  268.  
  269.           A construct "#" is defined, similar to "*", as follows:
  270.  
  271.                               <l>#<m>element
  272.  
  273.      indicating at least <l> and at most <m> elements, each  separated
  274.      by  one  or more commas (","). This makes the usual form of lists
  275.      very easy; a rule such as '(element *("," element))' can be shown
  276.      as  "1#element".   Wherever this construct is used, null elements
  277.      are allowed, but do not  contribute  to  the  count  of  elements
  278.      present.   That  is,  "(element),,(element)"  is  permitted,  but
  279.      counts as only two elements.  Therefore, where at least one  ele-
  280.      ment  is required, at least one non-null element must be present.
  281.      Default values are 0 and infinity so that "#(element)" allows any
  282.      number,  including  zero;  "1#element" requires at least one; and
  283.      "1#2element" allows one or two.
  284.  
  285.      _2._8.  ; _C_o_m_m_e_n_t_s
  286.  
  287.           A semi-colon, set off some distance to  the  right  of  rule
  288.      text,  starts  a comment that continues to the end of line.  This
  289.      is a simple way of including useful notes in  parallel  with  the
  290.      specifications.
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  316.  
  317.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- 4444 ----                      RRRRFFFFCCCC ####888822222222
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  330.  
  331.  
  332.      _3.  _L_E_X_I_C_A_L _A_N_A_L_Y_S_I_S _O_F _M_E_S_S_A_G_E_S
  333.  
  334.      _3._1.  _G_e_n_e_r_a_l _D_e_s_c_r_i_p_t_i_o_n
  335.  
  336.           A message consists of header fields and, optionally, a body.
  337.      The  body  is simply a sequence of lines containing ASCII charac-
  338.      ters.  It is separated from the headers by a null line  (i.e.,  a
  339.      line with nothing preceding the CRLF).
  340.  
  341.      _3._1._1.  _L_o_n_g _H_e_a_d_e_r _F_i_e_l_d_s
  342.  
  343.         Each header field can be viewed as a single, logical  line  of
  344.         ASCII  characters,  comprising  a field-name and a field-body.
  345.         For convenience, the field-body  portion  of  this  conceptual
  346.         entity  can be split into a multiple-line representation; this
  347.         is called "folding".  The general rule is that wherever  there
  348.         may  be  linear-white-space  (_n_o_t  simply  LWSP-chars), a CRLF
  349.         immediately followed by _a_t _l_e_a_s_t one LWSP-char may instead  be
  350.         inserted.  Thus, the single line
  351.  
  352.             To:  "Joe & J. Harvey" <ddd @Org>, JJV @ BBN
  353.  
  354.         can be represented as:
  355.  
  356.             To:  "Joe & J. Harvey" <ddd @ Org>,
  357.                     JJV@BBN
  358.  
  359.         and
  360.  
  361.             To:  "Joe & J. Harvey"
  362.                             <ddd@ Org>, JJV
  363.              @BBN
  364.  
  365.         and
  366.  
  367.             To:  "Joe &
  368.              J. Harvey" <ddd @ Org>, JJV @ BBN
  369.  
  370.              The process of moving  from  this  folded   multiple-line
  371.         representation  of a header field to its single line represen-
  372.         tation is called "unfolding".  Unfolding  is  accomplished  by
  373.         regarding   CRLF   immediately  followed  by  a  LWSP-char  as
  374.         equivalent to the LWSP-char.
  375.  
  376.         Note:  While the standard  permits  folding  wherever  linear-
  377.                white-space is permitted, it is recommended that struc-
  378.                tured fields, such as those containing addresses, limit
  379.                folding  to higher-level syntactic breaks.  For address
  380.                fields, it  is  recommended  that  such  folding  occur
  381.  
  382.  
  383.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- 5555 ----                      RRRRFFFFCCCC ####888822222222
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  396.  
  397.  
  398.                between addresses, after the separating comma.
  399.  
  400.      _3._1._2.  _S_t_r_u_c_t_u_r_e _o_f _H_e_a_d_e_r _F_i_e_l_d_s
  401.  
  402.         Once a field has been unfolded, it may be viewed as being com-
  403.         posed of a field-name followed by a colon (":"), followed by a
  404.         field-body, and  terminated  by  a  carriage-return/line-feed.
  405.         The  field-name must be composed of printable ASCII characters
  406.         (i.e., characters that  have  values  between  33.  and  126.,
  407.         decimal, except colon).  The field-body may be composed of any
  408.         ASCII characters, except CR or LF.  (While CR and/or LF may be
  409.         present  in the actual text, they are removed by the action of
  410.         unfolding the field.)
  411.  
  412.         Certain field-bodies of headers may be  interpreted  according
  413.         to  an  internal  syntax  that some systems may wish to parse.
  414.         These  fields  are  called  "structured   fields".    Examples
  415.         include  fields containing dates and addresses.  Other fields,
  416.         such as "Subject"  and  "Comments",  are  regarded  simply  as
  417.         strings of text.
  418.  
  419.         Note:  Any field which has a field-body  that  is  defined  as
  420.                other  than  simply <text> is to be treated as a struc-
  421.                tured field.
  422.  
  423.                Field-names, unstructured field bodies  and  structured
  424.                field bodies each are scanned by their own, independent
  425.                "lexical" analyzers.
  426.  
  427.      _3._1._3.  _U_n_s_t_r_u_c_t_u_r_e_d _F_i_e_l_d _B_o_d_i_e_s
  428.  
  429.         For some fields, such as "Subject" and "Comments",  no  struc-
  430.         turing  is assumed, and they are treated simply as <text>s, as
  431.         in the message body.  Rules of folding apply to these  fields,
  432.         so  that  such  field  bodies  which occupy several lines must
  433.         therefore have the second and successive lines indented by  at
  434.         least one LWSP-char.
  435.  
  436.      _3._1._4.  _S_t_r_u_c_t_u_r_e_d _F_i_e_l_d _B_o_d_i_e_s
  437.  
  438.         To aid in the creation and reading of structured  fields,  the
  439.         free  insertion   of linear-white-space (which permits folding
  440.         by inclusion of CRLFs)  is  allowed  between  lexical  tokens.
  441.         Rather  than  obscuring  the  syntax  specifications for these
  442.         structured fields with explicit syntax for this  linear-white-
  443.         space, the existence of another "lexical" analyzer is assumed.
  444.         This analyzer does not apply  for  unstructured  field  bodies
  445.         that  are  simply  strings  of  text, as described above.  The
  446.         analyzer provides  an  interpretation  of  the  unfolded  text
  447.  
  448.  
  449.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- 6666 ----                      RRRRFFFFCCCC ####888822222222
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  462.  
  463.  
  464.         composing  the body of the field as a sequence of lexical sym-
  465.         bols.
  466.  
  467.         These symbols are:
  468.  
  469.                      -  individual special characters
  470.                      -  quoted-strings
  471.                      -  domain-literals
  472.                      -  comments
  473.                      -  atoms
  474.  
  475.         The first four of these symbols  are  self-delimiting.   Atoms
  476.         are not; they are delimited by the self-delimiting symbols and
  477.         by  linear-white-space.   For  the  purposes  of  regenerating
  478.         sequences  of  atoms  and quoted-strings, exactly one SPACE is
  479.         assumed to exist, and should be used, between them.  (Also, in
  480.         the "Clarifications" section on "White Space", below, note the
  481.         rules about treatment of multiple contiguous LWSP-chars.)
  482.  
  483.         So, for example, the folded body of an address field
  484.  
  485.             ":sysmail"@  Some-Group. Some-Org,
  486.             Muhammed.(I am  the greatest) Ali @(the)Vegas.WBA
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  513.  
  514.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- 7777 ----                      RRRRFFFFCCCC ####888822222222
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  527.  
  528.  
  529.         is analyzed into the following lexical symbols and types:
  530.  
  531.                     :sysmail              quoted string
  532.                     @                     special
  533.                     Some-Group            atom
  534.                     .                     special
  535.                     Some-Org              atom
  536.                     ,                     special
  537.                     Muhammed              atom
  538.                     .                     special
  539.                     (I am  the greatest)  comment
  540.                     Ali                   atom
  541.                     @                     atom
  542.                     (the)                 comment
  543.                     Vegas                 atom
  544.                     .                     special
  545.                     WBA                   atom
  546.  
  547.         The canonical representations for the data in these  addresses
  548.         are the following strings:
  549.  
  550.                         ":sysmail"@Some-Group.Some-Org
  551.  
  552.         and
  553.  
  554.                             Muhammed.Ali@Vegas.WBA
  555.  
  556.         Note:  For purposes of display, and when passing  such  struc-
  557.                tured information to other systems, such as mail proto-
  558.                col  services,  there  must  be  _n_o  linear-white-space
  559.                between  <word>s  that are separated by period (".") or
  560.                at-sign ("@") and exactly one SPACE between  all  other
  561.                <word>s.  Also, headers should be in a folded form.
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  578.  
  579.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- 8888 ----                      RRRRFFFFCCCC ####888822222222
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  592.  
  593.  
  594.      _3._2.  _H_e_a_d_e_r _F_i_e_l_d _D_e_f_i_n_i_t_i_o_n_s
  595.  
  596.           These rules show a field meta-syntax, without regard for the
  597.      particular  type  or internal syntax.  Their purpose is to permit
  598.      detection of fields; also, they present to  higher-level  parsers
  599.      an image of each field as fitting on one line.
  600.  
  601.      field       =  field-name ":" [ field-body ] CRLF
  602.  
  603.      field-name  =  1*<any CHAR, excluding CTLs, SPACE, and ":">
  604.  
  605.      field-body  =  field-body-contents
  606.                     [CRLF LWSP-char field-body]
  607.  
  608.      field-body-contents =
  609.                    <the ASCII characters making up the field-body, as
  610.                     defined in the following sections, and consisting
  611.                     of combinations of atom, quoted-string, and
  612.                     specials tokens, or else consisting of texts>
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  643.  
  644.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- 9999 ----                      RRRRFFFFCCCC ####888822222222
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  657.  
  658.  
  659.      _3._3.  _L_e_x_i_c_a_l _T_o_k_e_n_s
  660.  
  661.           The following rules are used to define an underlying lexical
  662.      analyzer,  which  feeds  tokens to higher level parsers.  See the
  663.      ANSI references, in the Bibliography.
  664.  
  665.                                                  ; (  Octal, Decimal.)
  666.      CHAR        =  <any ASCII character>        ; (  0-177,  0.-127.)
  667.      ALPHA       =  <any ASCII alphabetic character>
  668.                                                  ; (101-132, 65.- 90.)
  669.                                                  ; (141-172, 97.-122.)
  670.      DIGIT       =  <any ASCII decimal digit>    ; ( 60- 71, 48.- 57.)
  671.      CTL         =  <any ASCII control           ; (  0- 37,  0.- 31.)
  672.                      character and DEL>          ; (    177,     127.)
  673.      CR          =  <ASCII CR, carriage return>  ; (     15,      13.)
  674.      LF          =  <ASCII LF, linefeed>         ; (     12,      10.)
  675.      SPACE       =  <ASCII SP, space>            ; (     40,      32.)
  676.      HTAB        =  <ASCII HT, horizontal-tab>   ; (     11,       9.)
  677.      <">         =  <ASCII quote mark>           ; (     42,      34.)
  678.      CRLF        =  CR LF
  679.  
  680.      LWSP-char   =  SPACE / HTAB                 ; semantics = SPACE
  681.  
  682.      linear-white-space =  1*([CRLF] LWSP-char)  ; semantics = SPACE
  683.                                                  ; CRLF => folding
  684.  
  685.      specials    =  "(" / ")" / "<" / ">" / "@"  ; Must be in quoted-
  686.                  /  "," / ";" / ":" / "\" / <">  ;  string, to use
  687.                  /  "." / "[" / "]"              ;  within a word.
  688.  
  689.      delimiters  =  specials / linear-white-space / comment
  690.  
  691.      text        =  <any CHAR, including bare    ; => atoms, specials,
  692.                      CR & bare LF, but NOT       ;  comments and
  693.                      including CRLF>             ;  quoted-strings are
  694.                                                  ;  NOT recognized.
  695.  
  696.      atom        =  1*<any CHAR except specials, SPACE and CTLs>
  697.  
  698.      quoted-string = <"> *(qtext/quoted-pair) <">; Regular qtext or
  699.                                                  ;   quoted chars.
  700.  
  701.      qtext       =  <any CHAR excepting <">,     ; => may be folded
  702.                      "\" & CR, and including
  703.                      linear-white-space>
  704.  
  705.      domain-literal =  "[" *(dtext / quoted-pair) "]"
  706.  
  708.  
  709.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11110000 ----                      RRRRFFFFCCCC ####888822222222
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  722.  
  723.  
  724.      dtext       =  <any CHAR excluding "[",     ; => may be folded
  725.                      "]", "\" & CR, & including
  726.                      linear-white-space>
  727.  
  728.      comment     =  "(" *(ctext / quoted-pair / comment) ")"
  729.  
  730.      ctext       =  <any CHAR excluding "(",     ; => may be folded
  731.                      ")", "\" & CR, & including
  732.                      linear-white-space>
  733.  
  734.      quoted-pair =  "\" CHAR                     ; may quote any char
  735.  
  736.      phrase      =  1*word                       ; Sequence of words
  737.  
  738.      word        =  atom / quoted-string
  739.  
  740.  
  741.      _3._4.  _C_l_a_r_i_f_i_c_a_t_i_o_n_s
  742.  
  743.      _3._4._1.  _Q_u_o_t_i_n_g
  744.  
  745.         Some characters are reserved for special interpretation,  such
  746.         as  delimiting lexical tokens.  To permit use of these charac-
  747.         ters as uninterpreted data, a quoting mechanism  is  provided.
  748.         To quote a character, precede it with a backslash ("\").
  749.  
  750.         This mechanism is not fully general.  Characters may be quoted
  751.         only  within  a subset of the lexical constructs.  In particu-
  752.         lar, quoting is limited to use within:
  753.  
  754.                              -  quoted-string
  755.                              -  domain-literal
  756.                              -  comment
  757.  
  758.         Within these constructs, quoting is _r_e_q_u_i_r_e_d for  CR  and  "\"
  759.         and for the character(s) that delimit the token (e.g., "(" and
  760.         ")" for a comment).  However, quoting  is  _p_e_r_m_i_t_t_e_d  for  any
  761.         character.
  762.  
  763.         Note:  In particular, quoting is _n_o_t permitted  within  atoms.
  764.                For  example  when  the local-part of an addr-spec must
  765.                contain a special character, a quoted  string  must  be
  766.                used.  Therefore, a specification such as:
  767.  
  768.                             Full\ Name@Domain
  769.  
  770.  
  771.  
  773.  
  774.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11111111 ----                      RRRRFFFFCCCC ####888822222222
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  787.  
  788.  
  789.                is not legal and must be specified as:
  790.  
  791.                             "Full Name"@Domain
  792.  
  793.  
  794.      _3._4._2.  _W_h_i_t_e _S_p_a_c_e
  795.  
  796.         Note:  In structured field bodies, multiple linear space ASCII
  797.                characters  (namely  HTABs  and  SPACEs) are treated as
  798.                single spaces and may freely surround any  symbol.   In
  799.                all header fields, the only place in which at least one
  800.                LWSP-char is _r_e_q_u_i_r_e_d is at the beginning of  continua-
  801.                tion lines in a folded field.
  802.  
  803.         When passing text to processes  that  do  not  interpret  text
  804.         according to this standard (e.g., mail protocol servers), then
  805.         _n_o linear-white-space characters should occur between a period
  806.         (".") or at-sign ("@") and a <word>.  Exactly _o_n_e SPACE should
  807.         be used in place of arbitrary linear-white-space  and  comment
  808.         sequences.
  809.  
  810.         Note:  Within systems conforming to this standard, wherever  a
  811.                member of the list of delimiters is allowed, LWSP-chars
  812.                may also occur before and/or after it.
  813.  
  814.         Writers of  mail-sending  (i.e.,  header-generating)  programs
  815.         should realize that there is no network-wide definition of the
  816.         effect of ASCII HT (horizontal-tab) characters on the  appear-
  817.         ance  of  text  at another network host; therefore, the use of
  818.         tabs in message headers, though permitted, is discouraged.
  819.  
  820.      _3._4._3.  _C_o_m_m_e_n_t_s
  821.  
  822.         A comment is a set of ASCII characters, which is  enclosed  in
  823.         matching  parentheses  and which is not within a quoted-string
  824.         The comment construct permits message originators to add  text
  825.         which  will  be  useful  for  human readers, but which will be
  826.         ignored by the formal semantics.  Comments should be  retained
  827.         while  the  message  is subject to interpretation according to
  828.         this standard.  However, comments  must  _n_o_t  be  included  in
  829.         other  cases,  such  as  during  protocol  exchanges with mail
  830.         servers.
  831.  
  832.         Comments nest, so that if an unquoted left parenthesis  occurs
  833.         in  a  comment  string,  there  must  also be a matching right
  834.         parenthesis.  When a comment acts as the delimiter  between  a
  835.         sequence of two lexical symbols, such as two atoms, it is lex-
  836.         ically equivalent with a single SPACE,  for  the  purposes  of
  837.         regenerating  the  sequence, such as when passing the sequence
  838.  
  839.  
  840.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11112222 ----                      RRRRFFFFCCCC ####888822222222
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  853.  
  854.  
  855.         onto a mail protocol server.  Comments are  detected  as  such
  856.         only within field-bodies of structured fields.
  857.  
  858.         If a comment is to be "folded" onto multiple lines,  then  the
  859.         syntax  for  folding  must  be  adhered to.  (See the "Lexical
  860.         Analysis of Messages" section on "Folding Long Header  Fields"
  861.         above,  and  the  section on "Case Independence" below.)  Note
  862.         that  the  official  semantics  therefore  do  not  "see"  any
  863.         unquoted CRLFs that are in comments, although particular pars-
  864.         ing programs may wish to note their presence.  For these  pro-
  865.         grams,  it would be reasonable to interpret a "CRLF LWSP-char"
  866.         as being a CRLF that is part of the comment; i.e., the CRLF is
  867.         kept  and  the  LWSP-char is discarded.  Quoted CRLFs (i.e., a
  868.         backslash followed by a CR followed by a  LF)  still  must  be
  869.         followed by at least one LWSP-char.
  870.  
  871.      _3._4._4.  _D_e_l_i_m_i_t_i_n_g _a_n_d _Q_u_o_t_i_n_g _C_h_a_r_a_c_t_e_r_s
  872.  
  873.         The quote character (backslash) and  characters  that  delimit
  874.         syntactic  units  are not, generally, to be taken as data that
  875.         are part of the delimited or quoted unit(s).   In  particular,
  876.         the   quotation-marks   that   define   a  quoted-string,  the
  877.         parentheses that define  a  comment  and  the  backslash  that
  878.         quotes  a  following  character  are  _n_o_t  part of the quoted-
  879.         string, comment or quoted character.  A quotation-mark that is
  880.         to  be  part  of  a quoted-string, a parenthesis that is to be
  881.         part of a comment and a backslash that is to be part of either
  882.         must  each be preceded by the quote-character backslash ("\").
  883.         Note that the syntax allows any character to be quoted  within
  884.         a  quoted-string  or  comment; however only certain characters
  885.         _m_u_s_t be quoted to be included as data.  These  characters  are
  886.         the  ones that are not part of the alternate text group (i.e.,
  887.         ctext or qtext).
  888.  
  889.         The one exception to this rule  is  that  a  single  SPACE  is
  890.         assumed  to  exist  between  contiguous words in a phrase, and
  891.         this interpretation is independent of  the  actual  number  of
  892.         LWSP-chars  that  the  creator  places  between the words.  To
  893.         include more than one SPACE, the creator must make  the  LWSP-
  894.         chars be part of a quoted-string.
  895.  
  896.         Quotation marks that delimit a quoted string  and  backslashes
  897.         that  quote  the  following character should _n_o_t accompany the
  898.         quoted-string when the string is passed to processes  that  do
  899.         not interpret data according to this specification (e.g., mail
  900.         protocol servers).
  901.  
  902.  
  904.  
  905.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11113333 ----                      RRRRFFFFCCCC ####888822222222
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  918.  
  919.  
  920.      _3._4._5.  _Q_u_o_t_e_d-_s_t_r_i_n_g_s
  921.  
  922.         Where permitted (i.e., in words in structured fields)  quoted-
  923.         strings  are  treated  as a single symbol.  That is, a quoted-
  924.         string is equivalent to an atom, syntactically.  If a  quoted-
  925.         string  is to be "folded" onto multiple lines, then the syntax
  926.         for folding must be adhered to.  (See the "Lexical Analysis of
  927.         Messages"  section  on "Folding Long Header Fields" above, and
  928.         the section on "Case  Independence"  below.)   Therefore,  the
  929.         official  semantics  do  not  "see" any bare CRLFs that are in
  930.         quoted-strings; however particular parsing programs  may  wish
  931.         to  note  their presence.  For such programs, it would be rea-
  932.         sonable to interpret a "CRLF LWSP-char" as being a CRLF  which
  933.         is  part  of the quoted-string; i.e., the CRLF is kept and the
  934.         LWSP-char is discarded.  Quoted CRLFs (i.e., a backslash  fol-
  935.         lowed  by  a CR followed by a LF) are also subject to rules of
  936.         folding, but the presence of the quoting character (backslash)
  937.         explicitly  indicates  that  the  CRLF  is  data to the quoted
  938.         string.  Stripping off the first following LWSP-char  is  also
  939.         appropriate when parsing quoted CRLFs.
  940.  
  941.      _3._4._6.  _B_r_a_c_k_e_t_i_n_g _C_h_a_r_a_c_t_e_r_s
  942.  
  943.         There is one type of bracket which must occur in matched pairs
  944.         and may have pairs nested within each other:
  945.  
  946.             o   Parentheses ("(" and ")") are used  to  indicate  com-
  947.                 ments.
  948.  
  949.         There are three types of brackets which must occur in  matched
  950.         pairs, and which may _n_o_t be nested:
  951.  
  952.             o   Colon/semi-colon (":" and ";") are   used  in  address
  953.                 specifications  to  indicate that the included list of
  954.                 addresses are to be treated as a group.
  955.  
  956.             o   Angle brackets ("<" and ">")  are  generally  used  to
  957.                 indicate  the  presence of a one machine-usable refer-
  958.                 ence (e.g., delimiting mailboxes), possibly  including
  959.                 source-routing to the machine.
  960.  
  961.             o   Square brackets ("[" and "]") are used to indicate the
  962.                 presence  of  a  domain-literal, which the appropriate
  963.                 name-domain  is  to  use  directly,  bypassing  normal
  964.                 name-resolution mechanisms.
  965.  
  966.  
  967.  
  969.  
  970.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11114444 ----                      RRRRFFFFCCCC ####888822222222
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  983.  
  984.  
  985.      _3._4._7.  _C_a_s_e _I_n_d_e_p_e_n_d_e_n_c_e
  986.  
  987.         Except as noted, alphabetic strings may be represented in  any
  988.         combination of upper and lower case.  The only syntactic units
  989.         which requires preservation of case information are:
  990.  
  991.                     -  text
  992.                     -  qtext
  993.                     -  dtext
  994.                     -  ctext
  995.                     -  quoted-pair
  996.                     -  local-part, except "Postmaster"
  997.  
  998.         When matching any other syntactic unit, case is to be ignored.
  999.         For  example, the field-names "From", "FROM", "from", and even
  1000.         "FroM" are semantically equal and should all be treated ident-
  1001.         ically.
  1002.  
  1003.         When generating these units, any mix of upper and  lower  case
  1004.         alphabetic  characters  may  be  used.  The case shown in this
  1005.         specification is suggested for message-creating processes.
  1006.  
  1007.         Note:  The reserved local-part address unit, "Postmaster",  is
  1008.                an  exception.   When  the  value "Postmaster" is being
  1009.                interpreted, it must be  accepted  in  any  mixture  of
  1010.                case, including "POSTMASTER", and "postmaster".
  1011.  
  1012.      _3._4._8.  _F_o_l_d_i_n_g _L_o_n_g _H_e_a_d_e_r _F_i_e_l_d_s
  1013.  
  1014.         Each header field may be represented on exactly one line  con-
  1015.         sisting  of the name of the field and its body, and terminated
  1016.         by a CRLF; this is what the parser sees.  For readability, the
  1017.         field-body  portion of long header fields may be "folded" onto
  1018.         multiple lines of the actual field.  "Long" is commonly inter-
  1019.         preted  to  mean greater than 65 or 72 characters.  The former
  1020.         length serves as a limit, when the message is to be viewed  on
  1021.         most  simple terminals which use simple display software; how-
  1022.         ever, the limit is not imposed by this standard.
  1023.  
  1024.         Note:  Some display software often can selectively fold lines,
  1025.                to  suit  the display terminal.  In such cases, sender-
  1026.                provided  folding  can  interfere  with   the   display
  1027.                software.
  1028.  
  1029.      _3._4._9.  _B_a_c_k_s_p_a_c_e _C_h_a_r_a_c_t_e_r_s
  1030.  
  1031.         ASCII BS characters (Backspace, decimal 8) may be included  in
  1032.         texts and quoted-strings to effect overstriking.  However, any
  1033.         use of backspaces which effects an overstrike to the  left  of
  1034.  
  1035.  
  1036.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11115555 ----                      RRRRFFFFCCCC ####888822222222
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1049.  
  1050.  
  1051.         the beginning of the text or quoted-string is prohibited.
  1052.  
  1053.      _3._4._1_0.  _N_e_t_w_o_r_k-_s_p_e_c_i_f_i_c _T_r_a_n_s_f_o_r_m_a_t_i_o_n_s
  1054.  
  1055.         During transmission through heterogeneous networks, it may  be
  1056.         necessary  to  force data to conform to a network's local con-
  1057.         ventions.  For example, it may be required that a CR  be  fol-
  1058.         lowed  either by LF, making a CRLF, or by <null>, if the CR is
  1059.         to stand alone).  Such transformations are reversed, when  the
  1060.         message exits that network.
  1061.  
  1062.         When  crossing  network  boundaries,  the  message  should  be
  1063.         treated  as  passing  through  two modules.  It will enter the
  1064.         first module containing whatever network-specific  transforma-
  1065.         tions  that  were  necessary  to  permit migration through the
  1066.         "current" network.  It then passes through the modules:
  1067.  
  1068.             o   Transformation Reversal
  1069.  
  1070.                 The "current" network's idiosyncracies are removed and
  1071.                 the  message  is returned to the canonical form speci-
  1072.                 fied in this standard.
  1073.  
  1074.             o   Transformation
  1075.  
  1076.                 The "next" network's local idiosyncracies are  imposed
  1077.                 on the message.
  1078.  
  1079.                                 ------------------
  1080.                     >From   ==>  | Remove Net-A   |
  1081.                     Net-A       | idiosyncracies |
  1082.                                 ------------------
  1083.                                        ||
  1084.                                        \/
  1085.                                   Conformance
  1086.                                   with standard
  1087.                                        ||
  1088.                                        \/
  1089.                                 ------------------
  1090.                                 | Impose Net-B   |  ==>  To
  1091.                                 | idiosyncracies |       Net-B
  1092.                                 ------------------
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1100.  
  1101.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11116666 ----                      RRRRFFFFCCCC ####888822222222
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1114.  
  1115.  
  1116.      _4.  _M_E_S_S_A_G_E _S_P_E_C_I_F_I_C_A_T_I_O_N
  1117.  
  1118.      _4._1.  _S_y_n_t_a_x
  1119.  
  1120.      Note:  Due to an artifact of the notational conventions, the syn-
  1121.             tax  indicates that, when present, some fields, must be in
  1122.             a particular order.  Header fields  are  _n_o_t  required  to
  1123.             occur  in  any  particular  order, except that the message
  1124.             body must occur _a_f_t_e_r  the  headers.   It  is  recommended
  1125.             that,  if  present,  headers be sent in the order "Return-
  1126.             Path", "Received", "Date",  "From",  "Subject",  "Sender",
  1127.             "To", "cc", etc.
  1128.  
  1129.             This specification permits multiple  occurrences  of  most
  1130.             fields.   Except  as  noted,  their  interpretation is not
  1131.             specified here, and their use is discouraged.
  1132.  
  1133.           The following syntax for the bodies of various fields should
  1134.      be  thought  of  as  describing  each field body as a single long
  1135.      string (or line).  The "Lexical Analysis of Message"  section  on
  1136.      "Long  Header Fields", above, indicates how such long strings can
  1137.      be represented on more than one line in  the  actual  transmitted
  1138.      message.
  1139.  
  1140.      message     =  fields *( CRLF *text )       ; Everything after
  1141.                                                  ;  first null line
  1142.                                                  ;  is message body
  1143.  
  1144.      fields      =    dates                      ; Creation time,
  1145.                       source                     ;  author id & one
  1146.                     1*destination                ;  address required
  1147.                      *optional-field             ;  others optional
  1148.  
  1149.      source      = [  trace ]                    ; net traversals
  1150.                       originator                 ; original mail
  1151.                    [  resent ]                   ; forwarded
  1152.  
  1153.      trace       =    return                     ; path to sender
  1154.                     1*received                   ; receipt tags
  1155.  
  1156.      return      =  "Return-path" ":" route-addr ; return address
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1165.  
  1166.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11117777 ----                      RRRRFFFFCCCC ####888822222222
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1179.  
  1180.  
  1181.      received    =  "Received"    ":"            ; one per relay
  1182.                        ["from" domain]           ; sending host
  1183.                        ["by"   domain]           ; receiving host
  1184.                        ["via"  atom]             ; physical path
  1185.                       *("with" atom)             ; link/mail protocol
  1186.                        ["id"   msg-id]           ; receiver msg id
  1187.                        ["for"  addr-spec]        ; initial form
  1188.                         ";"    date-time         ; time received
  1189.  
  1190.      originator  =   authentic                   ; authenticated addr
  1191.                    [ "Reply-To"   ":" 1#address] )
  1192.  
  1193.      authentic   =   "From"       ":"   mailbox  ; Single author
  1194.                  / ( "Sender"     ":"   mailbox  ; Actual submittor
  1195.                      "From"       ":" 1#mailbox) ; Multiple authors
  1196.                                                  ;  or not sender
  1197.  
  1198.      resent      =   resent-authentic
  1199.                    [ "Resent-Reply-To"  ":" 1#address] )
  1200.  
  1201.      resent-authentic =
  1202.                  =   "Resent-From"      ":"   mailbox
  1203.                  / ( "Resent-Sender"    ":"   mailbox
  1204.                      "Resent-From"      ":" 1#mailbox  )
  1205.  
  1206.      dates       =   orig-date                   ; Original
  1207.                    [ resent-date ]               ; Forwarded
  1208.  
  1209.      orig-date   =  "Date"        ":"   date-time
  1210.  
  1211.      resent-date =  "Resent-Date" ":"   date-time
  1212.  
  1213.      destination =  "To"          ":" 1#address  ; Primary
  1214.                  /  "Resent-To"   ":" 1#address
  1215.                  /  "cc"          ":" 1#address  ; Secondary
  1216.                  /  "Resent-cc"   ":" 1#address
  1217.                  /  "bcc"         ":"  #address  ; Blind carbon
  1218.                  /  "Resent-bcc"  ":"  #address
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1230.  
  1231.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11118888 ----                      RRRRFFFFCCCC ####888822222222
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1244.  
  1245.  
  1246.      optional-field =
  1247.                  /  "Message-ID"        ":"   msg-id
  1248.                  /  "Resent-Message-ID" ":"   msg-id
  1249.                  /  "In-Reply-To"       ":"  *(phrase / msg-id)
  1250.                  /  "References"        ":"  *(phrase / msg-id)
  1251.                  /  "Keywords"          ":"  #phrase
  1252.                  /  "Subject"           ":"  *text
  1253.                  /  "Comments"          ":"  *text
  1254.                  /  "Encrypted"         ":" 1#2word
  1255.                  /  extension-field              ; To be defined
  1256.                  /  user-defined-field           ; May be pre-empted
  1257.  
  1258.      msg-id      =  "<" addr-spec ">"            ; Unique message id
  1259.      extension-field =
  1260.                    <Any field which is defined in a document
  1261.                     published as a formal extension to this
  1262.                     specification; none will have names beginning
  1263.                     with the string "X-">
  1264.  
  1265.      user-defined-field =
  1266.                    <Any field which has not been defined
  1267.                     in this specification or published as an
  1268.                     extension to this specification; names for
  1269.                     such fields must be unique and may be
  1270.                     pre-empted by published extensions>
  1271.  
  1272.      _4._2.  _F_o_r_w_a_r_d_i_n_g
  1273.  
  1274.           Some systems permit mail recipients to  forward  a  message,
  1275.      retaining  the original headers, by adding some new fields.  This
  1276.      standard supports such a service, through the "Resent-" prefix to
  1277.      field names.
  1278.  
  1279.           Whenever the string "Resent-" begins a field name, the field
  1280.      has  the  same  semantics as a field whose name does not have the
  1281.      prefix.  However, the message is assumed to have  been  forwarded
  1282.      by  an original recipient who attached the "Resent-" field.  This
  1283.      new field is treated as being more recent  than  the  equivalent,
  1284.      original  field.   For  example, the "Resent-From", indicates the
  1285.      person that forwarded the message, whereas the "From" field indi-
  1286.      cates the original author.
  1287.  
  1288.           Use of such precedence  information  depends  upon  partici-
  1289.      pants'  communication needs.  For example, this standard does not
  1290.      dictate when a "Resent-From:" address should receive replies,  in
  1291.      lieu of sending them to the "From:" address.
  1292.  
  1293.      Note:  In general, the "Resent-" fields should be treated as con-
  1294.             taining  a  set  of information that is independent of the
  1295.  
  1296.  
  1297.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 11119999 ----                      RRRRFFFFCCCC ####888822222222
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1310.  
  1311.  
  1312.             set of original fields.  Information for  one  set  should
  1313.             not  automatically be taken from the other.  The interpre-
  1314.             tation of multiple "Resent-" fields, of the same type,  is
  1315.             undefined.
  1316.  
  1317.           In the remainder of this specification, occurrence of  legal
  1318.      "Resent-"  fields  are treated identically with the occurrence of
  1319.      fields whose names do not contain this prefix.
  1320.  
  1321.      _4._3.  _T_r_a_c_e _F_i_e_l_d_s
  1322.  
  1323.           Trace information is used to provide an audit trail of  mes-
  1324.      sage  handling.   In  addition,  it indicates a route back to the
  1325.      sender of the message.
  1326.  
  1327.           The list of known "via" and  "with"  values  are  registered
  1328.      with  the  Network  Information  Center, SRI International, Menlo
  1329.      Park, California.
  1330.  
  1331.      _4._3._1.  _R_e_t_u_r_n-_P_a_t_h
  1332.  
  1333.         This field  is  added  by  the  final  transport  system  that
  1334.         delivers  the message to its recipient.  The field is intended
  1335.         to contain definitive information about the address and  route
  1336.         back to the message's originator.
  1337.  
  1338.         Note:  The "Reply-To" field is added  by  the  originator  and
  1339.                serves  to  direct  replies,  whereas the "Return-Path"
  1340.                field is used to identify a path back to  the  origina-
  1341.                tor.
  1342.  
  1343.         While the syntax  indicates  that  a  route  specification  is
  1344.         optional,  every attempt should be made to provide that infor-
  1345.         mation in this field.
  1346.  
  1347.      _4._3._2.  _R_e_c_e_i_v_e_d
  1348.  
  1349.         A copy of this field is added by each transport  service  that
  1350.         relays the message.  The information in the field can be quite
  1351.         useful for tracing transport problems.
  1352.  
  1353.         The names of the sending  and  receiving  hosts  and  time-of-
  1354.         receipt may be specified.  The "via" parameter may be used, to
  1355.         indicate what physical mechanism the message  was  sent  over,
  1356.         such  as  Arpanet or Phonenet, and the "with" parameter may be
  1357.         used to indicate the mail-,  or  connection-,  level  protocol
  1358.         that  was  used, such as the SMTP mail protocol, or X.25 tran-
  1359.         sport protocol.
  1361.  
  1362.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22220000 ----                      RRRRFFFFCCCC ####888822222222
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1375.  
  1376.  
  1377.         Note:  Several "with" parameters may  be  included,  to  fully
  1378.                specify the set of protocols that were used.
  1379.  
  1380.         Some transport services queue mail; the internal message iden-
  1381.         tifier that is assigned to the message may be noted, using the
  1382.         "id" parameter.  When the  sending  host  uses  a  destination
  1383.         address specification that the receiving host reinterprets, by
  1384.         expansion or transformation, the receiving host  may  wish  to
  1385.         record  the original specification, using the "for" parameter.
  1386.         For example, when a copy of mail is sent to the  member  of  a
  1387.         distribution  list,  this  parameter may be used to record the
  1388.         original address that was used to specify the list.
  1389.  
  1390.      _4._4.  _O_r_i_g_i_n_a_t_o_r _F_i_e_l_d_s
  1391.  
  1392.           The standard allows only a subset of the combinations possi-
  1393.      ble  with the From, Sender, Reply-To, Resent-From, Resent-Sender,
  1394.      and Resent-Reply-To fields.  The limitation is intentional.
  1395.  
  1396.      _4._4._1.  _F_r_o_m / _R_e_s_e_n_t-_F_r_o_m
  1397.  
  1398.         This field contains the identity of the person(s)  who  wished
  1399.         this  message to be sent.  The message-creation process should
  1400.         default this field  to  be  a  single,  authenticated  machine
  1401.         address,  indicating  the  _a_g_e_n_t  (person,  system or process)
  1402.         entering the message.  If this is not done, the "Sender" field
  1403.         _m_u_s_t  be  present.  If the "From" field _i_s defaulted this way,
  1404.         the "Sender" field is  optional  and  is  redundant  with  the
  1405.         "From"  field.   In  all  cases, addresses in the "From" field
  1406.         must be machine-usable (addr-specs) and may not contain  named
  1407.         lists (groups).
  1408.  
  1409.      _4._4._2.  _S_e_n_d_e_r / _R_e_s_e_n_t-_S_e_n_d_e_r
  1410.  
  1411.         This field contains the authenticated identity  of  the  _a_g_e_n_t
  1412.         (person,  system  or  process)  that sends the message.  It is
  1413.         intended for use when the sender is not the author of the mes-
  1414.         sage,  or  to  indicate  who among a group of authors actually
  1415.         sent the message.  If the contents of the "Sender" field would
  1416.         be  completely  redundant  with  the  "From"  field,  then the
  1417.         "Sender" field need not be present and its use is  discouraged
  1418.         (though  still legal).  In particular, the "Sender" field _m_u_s_t
  1419.         be present if it is _n_o_t the same as the "From" Field.
  1420.  
  1421.         The Sender mailbox  specification  includes  a  word  sequence
  1422.         which  must correspond to a specific agent (i.e., a human user
  1423.         or a computer program) rather than a standard  address.   This
  1424.         indicates  the  expectation  that  the field will identify the
  1425.         single _a_g_e_n_t (person,  system,  or  process)  responsible  for
  1426.  
  1427.  
  1428.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22221111 ----                      RRRRFFFFCCCC ####888822222222
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1441.  
  1442.  
  1443.         sending  the mail and not simply include the name of a mailbox
  1444.         from which the mail was sent.  For example in the  case  of  a
  1445.         shared login name, the name, by itself, would not be adequate.
  1446.         The local-part address unit, which refers to  this  agent,  is
  1447.         expected to be a computer system term, and not (for example) a
  1448.         generalized person reference which can  be  used  outside  the
  1449.         network text message context.
  1450.  
  1451.         Since the critical function served by the  "Sender"  field  is
  1452.         identification  of  the agent responsible for sending mail and
  1453.         since computer programs cannot be held accountable  for  their
  1454.         behavior, it is strongly recommended that when a computer pro-
  1455.         gram generates a message, the _h_u_m_a_n  who  is  responsible  for
  1456.         that program be referenced as part of the "Sender" field mail-
  1457.         box specification.
  1458.  
  1459.      _4._4._3.  _R_e_p_l_y-_T_o / _R_e_s_e_n_t-_R_e_p_l_y-_T_o
  1460.  
  1461.         This field provides a general  mechanism  for  indicating  any
  1462.         mailbox(es)  to which responses are to be sent.  Three typical
  1463.         uses for this feature can  be  distinguished.   In  the  first
  1464.         case,  the  author(s) may not have regular machine-based mail-
  1465.         boxes and therefore wish(es) to indicate an alternate  machine
  1466.         address.   In  the  second case, an author may wish additional
  1467.         persons to be made aware of, or responsible for,  replies.   A
  1468.         somewhat  different  use  may be of some help to "text message
  1469.         teleconferencing" groups equipped with automatic  distribution
  1470.         services:   include the address of that service in the "Reply-
  1471.         To" field of all messages  submitted  to  the  teleconference;
  1472.         then  participants  can  "reply"  to conference submissions to
  1473.         guarantee the correct distribution of any submission of  their
  1474.         own.
  1475.  
  1476.         Note:  The "Return-Path" field is added by the mail  transport
  1477.                service,  at the time of final deliver.  It is intended
  1478.                to identify a path back to the orginator  of  the  mes-
  1479.                sage.   The  "Reply-To"  field  is added by the message
  1480.                originator and is intended to direct replies.
  1481.  
  1482.      _4._4._4.  _A_u_t_o_m_a_t_i_c _U_s_e _o_f _F_r_o_m / _S_e_n_d_e_r / _R_e_p_l_y-_T_o
  1483.  
  1484.         For systems which automatically  generate  address  lists  for
  1485.         replies to messages, the following recommendations are made:
  1486.  
  1487.             o   The "Sender" field mailbox should be sent  notices  of
  1488.                 any  problems in transport or delivery of the original
  1489.                 messages.  If there is no  "Sender"  field,  then  the
  1490.                 "From" field mailbox should be used.
  1492.  
  1493.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22222222 ----                      RRRRFFFFCCCC ####888822222222
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1506.  
  1507.  
  1508.             o   The  "Sender"  field  mailbox  should  _n_e_v_e_r  be  used
  1509.                 automatically, in a recipient's reply message.
  1510.  
  1511.             o   If the "Reply-To" field exists, then the reply  should
  1512.                 go to the addresses indicated in that field and not to
  1513.                 the address(es) indicated in the "From" field.
  1514.  
  1515.             o   If there is a "From" field, but no  "Reply-To"  field,
  1516.                 the  reply should be sent to the address(es) indicated
  1517.                 in the "From" field.
  1518.  
  1519.         Sometimes, a recipient may actually wish to  communicate  with
  1520.         the  person  that  initiated  the  message  transfer.  In such
  1521.         cases, it is reasonable to use the "Sender" address.
  1522.  
  1523.         This recommendation is intended  only  for  automated  use  of
  1524.         originator-fields  and is not intended to suggest that replies
  1525.         may not also be sent to other recipients of messages.   It  is
  1526.         up  to  the  respective  mail-handling programs to decide what
  1527.         additional facilities will be provided.
  1528.  
  1529.         Examples are provided in Appendix A.
  1530.  
  1531.      _4._5.  _R_e_c_e_i_v_e_r _F_i_e_l_d_s
  1532.  
  1533.      _4._5._1.  _T_o / _R_e_s_e_n_t-_T_o
  1534.  
  1535.         This field contains the identity of the primary recipients  of
  1536.         the message.
  1537.  
  1538.      _4._5._2.  _c_c / _R_e_s_e_n_t-_c_c
  1539.  
  1540.         This field contains the identity of  the  secondary  (informa-
  1541.         tional) recipients of the message.
  1542.  
  1543.      _4._5._3.  _B_c_c / _R_e_s_e_n_t-_B_c_c
  1544.  
  1545.         This field contains the identity of additional  recipients  of
  1546.         the  message.   The contents of this field are not included in
  1547.         copies of the message sent to the primary and secondary  reci-
  1548.         pients.   Some  systems  may choose to include the text of the
  1549.         "Bcc" field only in the author(s)'s  copy,  while  others  may
  1550.         also include it in the text sent to all those indicated in the
  1551.         "Bcc" list.
  1552.  
  1553.      _4._6.  _R_e_f_e_r_e_n_c_e _F_i_e_l_d_s
  1554.  
  1555.  
  1557.  
  1558.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22223333 ----                      RRRRFFFFCCCC ####888822222222
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1571.  
  1572.  
  1573.      _4._6._1.  _M_e_s_s_a_g_e-_I_D / _R_e_s_e_n_t-_M_e_s_s_a_g_e-_I_D
  1574.  
  1575.              This field contains a unique identifier  (the  local-part
  1576.         address  unit)  which  refers to _t_h_i_s version of _t_h_i_s message.
  1577.         The uniqueness of the message identifier is guaranteed by  the
  1578.         host  which  generates  it.  This identifier is intended to be
  1579.         machine readable and not necessarily meaningful to humans.   A
  1580.         message  identifier pertains to exactly one instantiation of a
  1581.         particular message; subsequent revisions to the message should
  1582.         each receive new message identifiers.
  1583.  
  1584.      _4._6._2.  _I_n-_R_e_p_l_y-_T_o
  1585.  
  1586.              The contents of this field identify  previous  correspon-
  1587.         dence  which this message answers.  Note that if message iden-
  1588.         tifiers are used in this  field,  they  must  use  the  msg-id
  1589.         specification format.
  1590.  
  1591.      _4._6._3.  _R_e_f_e_r_e_n_c_e_s
  1592.  
  1593.              The contents of this field identify other  correspondence
  1594.         which  this message references.  Note that if message identif-
  1595.         iers are used, they must use the msg-id specification format.
  1596.  
  1597.      _4._6._4.  _K_e_y_w_o_r_d_s
  1598.  
  1599.              This field contains keywords  or  phrases,  separated  by
  1600.         commas.
  1601.  
  1602.      _4._7.  _O_t_h_e_r _F_i_e_l_d_s
  1603.  
  1604.      _4._7._1.  _S_u_b_j_e_c_t
  1605.  
  1606.              This is intended to provide a summary,  or  indicate  the
  1607.         nature, of the message.
  1608.  
  1609.      _4._7._2.  _C_o_m_m_e_n_t_s
  1610.  
  1611.              Permits adding text comments  onto  the  message  without
  1612.         disturbing the contents of the message's body.
  1613.  
  1614.      _4._7._3.  _E_n_c_r_y_p_t_e_d
  1615.  
  1616.              Sometimes,  data  encryption  is  used  to  increase  the
  1617.         privacy  of  message  contents.   If the body of a message has
  1618.         been encrypted, to keep its contents private, the  "Encrypted"
  1619.         field  can be used to note the fact and to indicate the nature
  1620.         of the encryption.  The first <word> parameter  indicates  the
  1621.         software  used  to  encrypt the body, and the second, optional
  1622.  
  1623.  
  1624.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22224444 ----                      RRRRFFFFCCCC ####888822222222
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1637.  
  1638.  
  1639.         <word> is intended to  aid  the  recipient  in  selecting  the
  1640.         proper  decryption  key.   This  code word may be viewed as an
  1641.         index to a table of keys held by the recipient.
  1642.  
  1643.         Note:  Unfortunately, headers must contain envelope,  as  well
  1644.                as  contents,  information.  Consequently, it is neces-
  1645.                sary that they remain unencrypted, so that  mail  tran-
  1646.                sport   services   may   access   them.   Since  names,
  1647.                addresses, and "Subject"  field  contents  may  contain
  1648.                sensitive  information,  this  requirement limits total
  1649.                message privacy.
  1650.  
  1651.              Names of encryption software are registered with the Net-
  1652.         work  Information Center, SRI International, Menlo Park, Cali-
  1653.         fornia.
  1654.  
  1655.      _4._7._4.  _E_x_t_e_n_s_i_o_n-_f_i_e_l_d
  1656.  
  1657.              A limited number of common fields have  been  defined  in
  1658.         this  document.   As  network mail requirements dictate, addi-
  1659.         tional fields may be standardized.   To  provide  user-defined
  1660.         fields  with  a  measure  of  safety,  in name selection, such
  1661.         extension-fields will never have names  that  begin  with  the
  1662.         string "X-".
  1663.  
  1664.              Names of Extension-fields are registered with the Network
  1665.         Information Center, SRI International, Menlo Park, California.
  1666.  
  1667.      _4._7._5.  _U_s_e_r-_d_e_f_i_n_e_d-_f_i_e_l_d
  1668.  
  1669.              Individual users of network mail are free to  define  and
  1670.         use  additional  header  fields.   Such fields must have names
  1671.         which are not already used in the current specification or  in
  1672.         any definitions of extension-fields, and the overall syntax of
  1673.         these user-defined-fields must conform to this specification's
  1674.         rules   for   delimiting  and  folding  fields.   Due  to  the
  1675.         extension-field  publishing  process,  the  name  of  a  user-
  1676.         defined-field may be pre-empted
  1677.  
  1678.         Note:  The prefatory string "X-" will never  be  used  in  the
  1679.                names  of Extension-fields.  This provides user-defined
  1680.                fields with a protected set of names.
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1688.  
  1689.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22225555 ----                      RRRRFFFFCCCC ####888822222222
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1702.  
  1703.  
  1704.      _5.  _D_A_T_E _A_N_D _T_I_M_E _S_P_E_C_I_F_I_C_A_T_I_O_N
  1705.  
  1706.      _5._1.  _S_y_n_t_a_x
  1707.  
  1708.      date-time   =  [ day "," ] date time        ; dd mm yy
  1709.                                                  ;  hh:mm:ss zzz
  1710.  
  1711.      day         =  "Mon"  / "Tue" /  "Wed"  / "Thu"
  1712.                  /  "Fri"  / "Sat" /  "Sun"
  1713.  
  1714.      date        =  1*2DIGIT month 2DIGIT        ; day month year
  1715.                                                  ;  e.g. 20 Jun 82
  1716.  
  1717.      month       =  "Jan"  /  "Feb" /  "Mar"  /  "Apr"
  1718.                  /  "May"  /  "Jun" /  "Jul"  /  "Aug"
  1719.                  /  "Sep"  /  "Oct" /  "Nov"  /  "Dec"
  1720.  
  1721.      time        =  hour zone                    ; ANSI and Military
  1722.  
  1723.      hour        =  2DIGIT ":" 2DIGIT [":" 2DIGIT]
  1724.                                                  ; 00:00:00 - 23:59:59
  1725.  
  1726.      zone        =  "UT"  / "GMT"                ; Universal Time
  1727.                                                  ; North American : UT
  1728.                  /  "EST" / "EDT"                ;  Eastern:  - 5/ - 4
  1729.                  /  "CST" / "CDT"                ;  Central:  - 6/ - 5
  1730.                  /  "MST" / "MDT"                ;  Mountain: - 7/ - 6
  1731.                  /  "PST" / "PDT"                ;  Pacific:  - 8/ - 7
  1732.                  /  1ALPHA                       ; Military: Z = UT;
  1733.                                                  ;  A:-1; (J not used)
  1734.                                                  ;  M:-12; N:+1; Y:+12
  1735.                  / ( ("+" / "-") 4DIGIT )        ; Local differential
  1736.                                                  ;  hours+min. (HHMM)
  1737.  
  1738.      _5._2.  _S_e_m_a_n_t_i_c_s
  1739.  
  1740.           If included, day-of-week must be the day implied by the date
  1741.      specification.
  1742.  
  1743.           Time zone may be indicated in several ways.  "UT" is Univer-
  1744.      sal  Time  (formerly called "Greenwich Mean Time"); "GMT" is per-
  1745.      mitted as a reference to Universal Time.  The  military  standard
  1746.      uses  a  single  character for each zone.  "Z" is Universal Time.
  1747.      "A" indicates one hour earlier, and "M" indicates 12  hours  ear-
  1748.      lier;  "N"  is  one  hour  later, and "Y" is 12 hours later.  The
  1749.      letter "J" is not used.  The other remaining two forms are  taken
  1750.      from ANSI standard X3.51-1975.  One allows explicit indication of
  1751.      the amount of offset from UT; the other uses  common  3-character
  1752.      strings for indicating time zones in North America.
  1753.  
  1754.  
  1755.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22226666 ----                      RRRRFFFFCCCC ####888822222222
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1768.  
  1769.  
  1770.      _6.  _A_D_D_R_E_S_S _S_P_E_C_I_F_I_C_A_T_I_O_N
  1771.  
  1772.      _6._1.  _S_y_n_t_a_x
  1773.  
  1774.      address     =  mailbox                      ; one addressee
  1775.                  /  group                        ; named list
  1776.  
  1777.      group       =  phrase ":" [#mailbox] ";"
  1778.  
  1779.      mailbox     =  addr-spec                    ; simple address
  1780.                  /  phrase route-addr            ; name & addr-spec
  1781.  
  1782.      route-addr  =  "<" [route] addr-spec ">"
  1783.  
  1784.      route       =  1#("@" domain) ":"           ; path-relative
  1785.  
  1786.      addr-spec   =  local-part "@" domain        ; global address
  1787.  
  1788.      local-part  =  word *("." word)             ; uninterpreted
  1789.                                                  ; case-preserved
  1790.  
  1791.      domain      =  sub-domain *("." sub-domain)
  1792.  
  1793.      sub-domain  =  domain-ref / domain-literal
  1794.  
  1795.      domain-ref  =  atom                         ; symbolic reference
  1796.  
  1797.      _6._2.  _S_e_m_a_n_t_i_c_s
  1798.  
  1799.           A mailbox receives mail.  It is a  conceptual  entity  which
  1800.      does  not necessarily pertain to file storage.  For example, some
  1801.      sites may choose to print mail on their line printer and  deliver
  1802.      the output to the addressee's desk.
  1803.  
  1804.           A mailbox specification comprises a person, system  or  pro-
  1805.      cess name reference, a domain-dependent string, and a name-domain
  1806.      reference.  The name reference is optional and is usually used to
  1807.      indicate  the  human name of a recipient.  The name-domain refer-
  1808.      ence specifies a sequence of sub-domains.   The  domain-dependent
  1809.      string is uninterpreted, except by the final sub-domain; the rest
  1810.      of the mail service merely transmits it as a literal string.
  1811.  
  1812.      _6._2._1.  _D_o_m_a_i_n_s
  1813.  
  1814.         A name-domain is a set of registered (mail)  names.   A  name-
  1815.         domain  specification  resolves  to  a subordinate name-domain
  1816.         specification  or  to  a  terminal  domain-dependent   string.
  1817.         Hence,  domain  specification  is  extensible,  permitting any
  1818.         number of registration levels.
  1819.  
  1820.  
  1821.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22227777 ----                      RRRRFFFFCCCC ####888822222222
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1834.  
  1835.  
  1836.         Name-domains model a global, logical, hierarchical  addressing
  1837.         scheme.   The  model is logical, in that an address specifica-
  1838.         tion is related to name registration and  is  not  necessarily
  1839.         tied  to  transmission  path.   The  model's  hierarchy  is  a
  1840.         directed graph, called an in-tree, such that there is a single
  1841.         path  from  the root of the tree to any node in the hierarchy.
  1842.         If more than one path actually exists, they are considered  to
  1843.         be different addresses.
  1844.  
  1845.         The root node is common to all addresses; consequently, it  is
  1846.         not  referenced.   Its  children  constitute "top-level" name-
  1847.         domains.  Usually, a service has access to its own full domain
  1848.         specification and to the names of all top-level name-domains.
  1849.  
  1850.         The "top" of the domain addressing hierarchy -- a child of the
  1851.         root  --  is  indicated  by  the right-most field, in a domain
  1852.         specification.  Its child is specified to the left, its  child
  1853.         to the left, and so on.
  1854.  
  1855.         Some groups provide formal registration services;  these  con-
  1856.         stitute   name-domains   that  are  independent  logically  of
  1857.         specific machines.  In addition, networks and machines  impli-
  1858.         citly  compose name-domains, since their membership usually is
  1859.         registered in name tables.
  1860.  
  1861.         In the case of formal registration, an organization implements
  1862.         a  (distributed)  data base which provides an address-to-route
  1863.         mapping service for addresses of the form:
  1864.  
  1865.                          person@registry.organization
  1866.  
  1867.         Note that "organization" is a logical  entity,  separate  from
  1868.         any particular communication network.
  1869.  
  1870.         A mechanism for accessing "organization" is universally avail-
  1871.         able.   That mechanism, in turn, seeks an instantiation of the
  1872.         registry; its location is not indicated in the address specif-
  1873.         ication.   It  is assumed that the system which operates under
  1874.         the name "organization" knows how to find a subordinate regis-
  1875.         try.  The registry will then use the "person" string to deter-
  1876.         mine where to send the mail specification.
  1877.  
  1878.         The latter,  network-oriented  case  permits  simple,  direct,
  1879.         attachment-related address specification, such as:
  1880.  
  1881.                               user@host.network
  1882.  
  1883.         Once the network is accessed, it is expected  that  a  message
  1884.         will  go  directly  to the host and that the host will resolve
  1885.  
  1886.  
  1887.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22228888 ----                      RRRRFFFFCCCC ####888822222222
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1900.  
  1901.  
  1902.         the user name, placing the message in the user's mailbox.
  1903.  
  1904.      _6._2._2.  _A_b_b_r_e_v_i_a_t_e_d _D_o_m_a_i_n _S_p_e_c_i_f_i_c_a_t_i_o_n
  1905.  
  1906.         Since any number of  levels  is  possible  within  the  domain
  1907.         hierarchy,  specification  of  a  fully  qualified address can
  1908.         become inconvenient.  This standard permits abbreviated domain
  1909.         specification, in a special case:
  1910.  
  1911.             For the address of  the  sender,  call  the  left-most
  1912.             sub-domain  Level  _n.   In a header address, if all of
  1913.             the sub-domains above (i.e., to the right of) Level  _n
  1914.             are  the same as those of the sender, then they do not
  1915.             have to appear in the specification.   Otherwise,  the
  1916.             address must be fully qualified.
  1917.  
  1918.             This feature is subject  to  approval  by  local  sub-
  1919.             domains.   Individual  sub-domains  may  require their
  1920.             member systems, which originate mail, to provide  full
  1921.             domain  specification only.  When permitted, abbrevia-
  1922.             tions may be present  only  while  the  message  stays
  1923.             within the sub-domain of the sender.
  1924.  
  1925.             Use of this mechanism requires the sender's sub-domain
  1926.             to reserve the names of all top-level domains, so that
  1927.             full specifications can be distinguished from abbrevi-
  1928.             ated specifications.
  1929.  
  1930.         For example, if a sender's address is:
  1931.  
  1932.                  sender@registry-A.registry-1.organization-X
  1933.  
  1934.         and one recipient's address is:
  1935.  
  1936.                 recipient@registry-B.registry-1.organization-X
  1937.  
  1938.         and another's is:
  1939.  
  1940.                 recipient@registry-C.registry-2.organization-X
  1941.  
  1942.         then ".registry-1.organization-X" need not be specified in the
  1943.         the  message,  but  "registry-C.registry-2"  _d_o_e_s  have  to be
  1944.         specified.  That is, the first two addresses may  be  abbrevi-
  1945.         ated, but the third address must be fully specified.
  1946.  
  1947.         When a message crosses a domain boundary, all  addresses  must
  1948.         be  specified  in  the  full format, ending with the top-level
  1949.         name-domain in the right-most field.  It is the responsibility
  1950.         of  mail  forwarding services to ensure that addresses conform
  1951.  
  1952.  
  1953.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 22229999 ----                      RRRRFFFFCCCC ####888822222222
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  1966.  
  1967.  
  1968.         with this requirement.  In the case of abbreviated  addresses,
  1969.         the  relaying  service must make the necessary expansions.  It
  1970.         should be noted that it often is difficult for such a  service
  1971.         to locate all occurrences of address abbreviations.  For exam-
  1972.         ple, it will not be possible to find such abbreviations within
  1973.         the  body  of  the  message.   The "Return-Path" field can aid
  1974.         recipients in recovering from these errors.
  1975.  
  1976.         Note:  When passing any portion of an addr-spec onto a process
  1977.                which  does  not interpret data according to this stan-
  1978.                dard (e.g., mail protocol servers).  There must  be  _n_o
  1979.                LWSP-chars  preceding  or  following the at-sign or any
  1980.                delimiting period ("."), such as  shown  in  the  above
  1981.                examples,   and   only  _o_n_e  SPACE  between  contiguous
  1982.                <word>s.
  1983.  
  1984.      _6._2._3.  _D_o_m_a_i_n _T_e_r_m_s
  1985.  
  1986.         A domain-ref must be _t_h_e official name of a registry, network,
  1987.         or  host.   It  is  a  symbolic  reference, within a name sub-
  1988.         domain.  At times, it is necessary to bypass standard  mechan-
  1989.         isms  for  resolving  such  references,  using  more primitive
  1990.         information, such as a network host address  rather  than  its
  1991.         associated host name.
  1992.  
  1993.         To permit such references, this standard provides the  domain-
  1994.         literal  construct.   Its contents must conform with the needs
  1995.         of the sub-domain in which it is interpreted.
  1996.  
  1997.         Domain-literals which refer to domains within the ARPA  Inter-
  1998.         net  specify  32-bit  Internet addresses, in four 8-bit fields
  1999.         noted in decimal, as described in Request for  Comments  #820,
  2000.         "Assigned Numbers."  For example:
  2001.  
  2002.                                  [10.0.3.19]
  2003.  
  2004.         Note:  _T_h_e _u_s_e _o_f _d_o_m_a_i_n-_l_i_t_e_r_a_l_s _i_s _s_t_r_o_n_g_l_y _d_i_s_c_o_u_r_a_g_e_d.  It
  2005.                is  permitted  only  as  a means of bypassing temporary
  2006.                system limitations, such as name tables which  are  not
  2007.                complete.
  2008.  
  2009.         The names of "top-level" domains, and  the  names  of  domains
  2010.         under  in  the  ARPA Internet, are registered with the Network
  2011.         Information Center, SRI International, Menlo Park, California.
  2012.  
  2013.      _6._2._4.  _D_o_m_a_i_n-_D_e_p_e_n_d_e_n_t _L_o_c_a_l _S_t_r_i_n_g
  2014.  
  2015.         The local-part of an  addr-spec  in  a  mailbox  specification
  2016.         (i.e.,  the  host's  name for the mailbox) is understood to be
  2017.  
  2018.  
  2019.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33330000 ----                      RRRRFFFFCCCC ####888822222222
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2032.  
  2033.  
  2034.         whatever the receiving mail protocol server allows.  For exam-
  2035.         ple,  some systems do not understand mailbox references of the
  2036.         form "P. D. Q. Bach", but others do.
  2037.  
  2038.         This specification treats periods (".") as lexical separators.
  2039.         Hence,  their  presence  in  local-parts which are not quoted-
  2040.         strings, is detected.   However,  such  occurrences  carry  _n_o
  2041.         semantics.  That is, if a local-part has periods within it, an
  2042.         address parser will divide the local-part into several tokens,
  2043.         but  the  sequence  of  tokens will be treated as one uninter-
  2044.         preted unit.  The sequence  will  be  re-assembled,  when  the
  2045.         address is passed outside of the system such as to a mail pro-
  2046.         tocol service.
  2047.  
  2048.         For example, the address:
  2049.  
  2050.                            First.Last@Registry.Org
  2051.  
  2052.         is legal and does not require the local-part to be  surrounded
  2053.         with  quotation-marks.   (However,  "First  Last" _d_o_e_s require
  2054.         quoting.)  The local-part of the address, when passed  outside
  2055.         of  the  mail  system,  within  the  Registry.Org  domain,  is
  2056.         "First.Last", again without quotation marks.
  2057.  
  2058.      _6._2._5.  _B_a_l_a_n_c_i_n_g _L_o_c_a_l-_P_a_r_t _a_n_d _D_o_m_a_i_n
  2059.  
  2060.         In some cases, the boundary between local-part and domain  can
  2061.         be  flexible.  The local-part may be a simple string, which is
  2062.         used for the final determination of the  recipient's  mailbox.
  2063.         All  other  levels  of  reference  are, therefore, part of the
  2064.         domain.
  2065.  
  2066.         For some systems, in the case of abbreviated reference to  the
  2067.         local  and  subordinate  sub-domains,  it  may  be possible to
  2068.         specify only one reference within the domain  part  and  place
  2069.         the  other,  subordinate  name-domain  references  within  the
  2070.         local-part.  This would appear as:
  2071.  
  2072.                         mailbox.sub1.sub2@this-domain
  2073.  
  2074.         Such a specification would be acceptable  to  address  parsers
  2075.         which  conform  to  RFC  #733,  but  do not support this newer
  2076.         Internet standard.  While contrary to the intent of this stan-
  2077.         dard, the form is legal.
  2078.  
  2079.         Also, some sub-domains have a specification syntax which  does
  2080.  
  2081.  
  2083.  
  2084.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33331111 ----                      RRRRFFFFCCCC ####888822222222
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2097.  
  2098.  
  2099.         not conform to this standard.  For example:
  2100.  
  2101.                       sub-net.mailbox@sub-domain.domain
  2102.  
  2103.         uses a different parsing  sequence  for  local-part  than  for
  2104.         domain.
  2105.  
  2106.         Note:  As a rule,  the  domain  specification  should  contain
  2107.                fields  which  are  encoded  according to the syntax of
  2108.                this standard and which contain  generally-standardized
  2109.                information.   The local-part specification should con-
  2110.                tain only that portion of the  address  which  deviates
  2111.                from the form or intention of the domain field.
  2112.  
  2113.      _6._2._6.  _M_u_l_t_i_p_l_e _M_a_i_l_b_o_x_e_s
  2114.  
  2115.         An individual may have several mailboxes and wish  to  receive
  2116.         mail  at  whatever  mailbox  is  convenient  for the sender to
  2117.         access.  This standard does not provide a means of  specifying
  2118.         "any member of" a list of mailboxes.
  2119.  
  2120.         A set of individuals may wish to receive mail as a single unit
  2121.         (i.e.,  a  distribution  list).  The <group> construct permits
  2122.         specification of such a list.  Recipient mailboxes are  speci-
  2123.         fied  within  the  bracketed  part (":" - ";").  A copy of the
  2124.         transmitted message is to be  sent  to  each  mailbox  listed.
  2125.         This  standard  does  not  permit  recursive  specification of
  2126.         groups within groups.
  2127.  
  2128.         While a list must be named, it is not required that  the  con-
  2129.         tents  of  the  list be included.  In this case, the <address>
  2130.         serves only as an indication of group distribution  and  would
  2131.         appear in the form:
  2132.  
  2133.                                     name:;
  2134.  
  2135.         Some mail  services  may  provide  a  group-list  distribution
  2136.         facility,  accepting  a single mailbox reference, expanding it
  2137.         to the full distribution list, and relaying the  mail  to  the
  2138.         list's  members.   This standard provides no additional syntax
  2139.         for indicating such a  service.   Using  the  <group>  address
  2140.         alternative,  while listing one mailbox in it, can mean either
  2141.         that the mailbox reference will be expanded to a list or  that
  2142.         there is a group with one member.
  2143.  
  2144.      _6._2._7.  _E_x_p_l_i_c_i_t _P_a_t_h _S_p_e_c_i_f_i_c_a_t_i_o_n
  2145.  
  2146.         At times, a  message  originator  may  wish  to  indicate  the
  2147.         transmission  path  that  a  message  should  follow.  This is
  2148.  
  2149.  
  2150.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33332222 ----                      RRRRFFFFCCCC ####888822222222
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2163.  
  2164.  
  2165.         called source routing.  The normal addressing scheme, used  in
  2166.         an  addr-spec,  is  carefully separated from such information;
  2167.         the <route> portion of a route-addr is provided for such occa-
  2168.         sions.  It specifies the sequence of hosts and/or transmission
  2169.         services that are  to  be  traversed.   Both  domain-refs  and
  2170.         domain-literals may be used.
  2171.  
  2172.         Note:  The use of source routing is discouraged.   Unless  the
  2173.                sender has special need of path restriction, the choice
  2174.                of transmission route should be left to the mail  tran-
  2175.                sport service.
  2176.  
  2177.      _6._3.  _R_e_s_e_r_v_e_d _A_d_d_r_e_s_s
  2178.  
  2179.           It often is necessary to send mail to a site, without  know-
  2180.      ing  any  of its valid addresses.  For example, there may be mail
  2181.      system dysfunctions, or a user may wish to find  out  a  person's
  2182.      correct address, at that site.
  2183.  
  2184.           This standard specifies a single, reserved  mailbox  address
  2185.      (local-part)  which  is  to  be valid at each site.  Mail sent to
  2186.      that address is to be routed to  a  person  responsible  for  the
  2187.      site's mail system or to a person with responsibility for general
  2188.      site operation.  The name of the reserved local-part address is:
  2189.  
  2190.                                 Postmaster
  2191.  
  2192.      so that "Postmaster@domain" is required to be valid.
  2193.  
  2194.      Note:  This reserved local-part must be  matched  without  sensi-
  2195.             tivity to alphabetic case, so that "POSTMASTER", "postmas-
  2196.             ter", and even "poStmASteR" is to be accepted.
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2214.  
  2215.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33333333 ----                      RRRRFFFFCCCC ####888822222222
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2228.  
  2229.  
  2230.      _7.  _B_I_B_L_I_O_G_R_A_P_H_Y
  2231.  
  2232.  
  2233.      ANSI.  "USA Standard Code  for  Information  Interchange,"  X3.4.
  2234.         American  National Standards Institute: New York (1968).  Also
  2235.         in:  Feinler, E.  and J. Postel, eds., "ARPANET Protocol Hand-
  2236.         book", NIC 7104.
  2237.  
  2238.      ANSI.  "Representations of Universal Time, Local  Time  Differen-
  2239.         tials,  and United States Time Zone References for Information
  2240.         Interchange," X3.51-1975.  American National Standards  Insti-
  2241.         tute:  New York (1975).
  2242.  
  2243.      Bemer, R.W., "Time and the Computer."  In:  Interface  Age  (Feb.
  2244.         1979).
  2245.  
  2246.      Bennett, C.J.  "JNT Mail Protocol".  Joint Network Team,  Ruther-
  2247.         ford and Appleton Laboratory:  Didcot, England.
  2248.  
  2249.      Bhushan, A.K., Pogran, K.T., Tomlinson,  R.S.,  and  White,  J.E.
  2250.         "Standardizing  Network  Mail  Headers,"   ARPANET Request for
  2251.         Comments No. 561, Network Information Center  No.  18516;  SRI
  2252.         International:  Menlo Park (September 1973).
  2253.  
  2254.      Birrell, A.D., Levin, R.,  Needham,  R.M.,  and  Schroeder,  M.D.
  2255.         "Grapevine:  An Exercise in Distributed Computing," Communica-
  2256.         tions of the ACM 25, 4 (April 1982), 260-274.
  2257.  
  2258.      Crocker,  D.H.,  Vittal,  J.J.,  Pogran,  K.T.,  Henderson,  D.A.
  2259.         "Standard  for  the  Format  of  ARPA  Network  Text Message,"
  2260.         ARPANET Request for  Comments  No.  733,  Network  Information
  2261.         Center  No.  41952.   SRI International:  Menlo Park (November
  2262.         1977).
  2263.  
  2264.      Feinler, E.J. and Postel, J.B.  ARPANET Protocol  Handbook,  Net-
  2265.         work  Information  Center  No.  7104   (NTIS AD A003890).  SRI
  2266.         International:  Menlo Park (April 1976).
  2267.  
  2268.      Harary, F.   "Graph  Theory".   Addison-Wesley:   Reading,  Mass.
  2269.         (1969).
  2270.  
  2271.      Levin, R. and Schroeder, M.  "Transport  of  Electronic  Messages
  2272.         through  a  Network,"   TeleInformatics  79, pp. 29-33.  North
  2273.         Holland (1979).  Also  as  Xerox  Palo  Alto  Research  Center
  2274.         Technical Report CSL-79-4.
  2275.  
  2276.      Myer, T.H. and Henderson, D.A.  "Message Transmission  Protocol,"
  2277.         ARPANET  Request  for  Comments,  No. 680, Network Information
  2278.         Center No. 32116.  SRI International:  Menlo Park (1975).
  2279.  
  2280.  
  2281.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33334444 ----                      RRRRFFFFCCCC ####888822222222
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2294.  
  2295.  
  2296.      NBS.  "Specification of Message Format for Computer Based Message
  2297.         Systems, Recommended Federal Information Processing Standard."
  2298.         National  Bureau   of   Standards:    Gaithersburg,   Maryland
  2299.         (October 1981).
  2300.  
  2301.      NIC.  Internet Protocol Transition Workbook.  Network Information
  2302.         Center,   SRI-International,  Menlo  Park,  California  (March
  2303.         1982).
  2304.  
  2305.      Oppen, D.C. and Dalal, Y.K.  "The Clearinghouse:  A Decentralized
  2306.         Agent  for  Locating  Named  Objects in a Distributed Environ-
  2307.         ment," OPD-T8103.  Xerox Office Products Division:  Palo Alto,
  2308.         CA. (October 1981).
  2309.  
  2310.      Postel, J.B.  "Assigned Numbers,"  ARPANET Request for  Comments,
  2311.         No. 820.  SRI International:  Menlo Park (August 1982).
  2312.  
  2313.      Postel, J.B.  "Simple Mail Transfer  Protocol,"  ARPANET  Request
  2314.         for Comments, No. 821.  SRI International:  Menlo Park (August
  2315.         1982).
  2316.  
  2317.      Shoch, J.F.  "Internetwork naming, addressing  and  routing,"  in
  2318.         Proc. 17th IEEE Computer Society International Conference, pp.
  2319.         72-79, Sept. 1978, IEEE Cat. No. 78 CH 1388-8C.
  2320.  
  2321.      Su, Z. and Postel, J.  "The Domain Naming Convention for Internet
  2322.         User  Applications,"  ARPANET  Request  for Comments, No. 819.
  2323.         SRI International:  Menlo Park (August 1982).
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2345.  
  2346.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33335555 ----                      RRRRFFFFCCCC ####888822222222
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2359.  
  2360.  
  2361.                                  APPENDIX
  2362.  
  2363.  
  2364.      _H.  _E_X_A_M_P_L_E_S
  2365.  
  2366.      _H._1.  _A_d_d_r_e_s_s_e_s
  2367.  
  2368.      _H._1._1.  Alfred Neuman <Neuman@BBN-TENEXA>
  2369.  
  2370.      _H._1._2.  Neuman@BBN-TENEXA
  2371.  
  2372.              These two "Alfred Neuman" examples have identical  seman-
  2373.         tics, as far as the operation of the local host's mail sending
  2374.         (distribution) program (also sometimes  called  its  "mailer")
  2375.         and  the remote host's mail protocol server are concerned.  In
  2376.         the first example, the  "Alfred  Neuman"  is  ignored  by  the
  2377.         mailer,  as "Neuman@BBN-TENEXA" completely specifies the reci-
  2378.         pient.  The second example contains  no  superfluous  informa-
  2379.         tion,  and,  again,  "Neuman@BBN-TENEXA" is the intended reci-
  2380.         pient.
  2381.  
  2382.         Note:  When the message crosses name-domain  boundaries,  then
  2383.                these specifications must be changed, so as to indicate
  2384.                the remainder of the hierarchy, starting with  the  top
  2385.                level.
  2386.  
  2387.      _H._1._3.  "George, Ted" <Shared@Group.Arpanet>
  2388.  
  2389.              This form might be used to indicate that a single mailbox
  2390.         is  shared  by several users.  The quoted string is ignored by
  2391.         the originating host's mailer, because  "Shared@Group.Arpanet"
  2392.         completely specifies the destination mailbox.
  2393.  
  2394.      _H._1._4.  Wilt . (the  Stilt) Chamberlain@NBA.US
  2395.  
  2396.              The "(the  Stilt)" is a comment, which is _n_o_t included in
  2397.         the  destination  mailbox  address  handed  to the originating
  2398.         system's mailer.  The local-part of the address is the  string
  2399.         "Wilt.Chamberlain", with _n_o space between the first and second
  2400.         words.
  2401.  
  2402.      _H._1._5.  Address Lists
  2403.  
  2404.      Gourmets:  Pompous Person <WhoZiWhatZit@Cordon-Bleu>,
  2405.                 Childs@WGBH.Boston, Galloping Gourmet@
  2406.                 ANT.Down-Under (Australian National Television),
  2407.                 Cheapie@Discount-Liquors;,
  2408.        Cruisers:  Port@Portugal, Jones@SEA;,
  2409.          Another@Somewhere.SomeOrg
  2410.  
  2411.  
  2412.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33336666 ----                      RRRRFFFFCCCC ####888822222222
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2425.  
  2426.  
  2427.         This group list example points out the use of comments and the
  2428.         mixing of addresses and groups.
  2429.  
  2430.      _H._2.  _O_r_i_g_i_n_a_t_o_r _I_t_e_m_s
  2431.  
  2432.      _H._2._1.  Author-sent
  2433.  
  2434.              George Jones logs into his host  as  "Jones".   He  sends
  2435.         mail himself.
  2436.  
  2437.             From:  Jones@Group.Org
  2438.  
  2439.         or
  2440.  
  2441.             From:  George Jones <Jones@Group.Org>
  2442.  
  2443.      _H._2._2.  Secretary-sent
  2444.  
  2445.              George Jones logs in as Jones on his  host.   His  secre-
  2446.         tary,  who logs in as Secy sends mail for him.  Replies to the
  2447.         mail should go to George.
  2448.  
  2449.             From:    George Jones <Jones@Group>
  2450.             Sender:  Secy@Other-Group
  2451.  
  2452.      _H._2._3.  Secretary-sent, for user of shared directory
  2453.  
  2454.              George Jones' secretary sends mail  for  George.  Replies
  2455.         should go to George.
  2456.  
  2457.             From:     George Jones<Shared@Group.Org>
  2458.             Sender:   Secy@Other-Group
  2459.  
  2460.         Note that there need not be a space between  "Jones"  and  the
  2461.         "<",  but  adding a space enhances readability (as is the case
  2462.         in other examples.
  2463.  
  2464.      _H._2._4.  Committee activity, with one author
  2465.  
  2466.              George is a member of a committee.  He wishes to have any
  2467.         replies to his message go to all committee members.
  2468.  
  2469.             From:     George Jones <Jones@Host.Net>
  2470.             Sender:   Jones@Host
  2471.             Reply-To: The Committee: Jones@Host.Net,
  2472.                                      Smith@Other.Org,
  2473.                                      Doe@Somewhere-Else;
  2474.  
  2475.         Note  that  if  George  had  not  included  himself   in   the
  2476.  
  2477.  
  2478.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33337777 ----                      RRRRFFFFCCCC ####888822222222
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2491.  
  2492.  
  2493.         enumeration  of  The  Committee,  he  would not have gotten an
  2494.         implicit reply; the presence of the  "Reply-to"  field  _s_u_p_e_r_-
  2495.         _s_e_d_e_s the sending of a reply to the person named in the "From"
  2496.         field.
  2497.  
  2498.      _H._2._5.  Secretary acting as full agent of author
  2499.  
  2500.              George Jones asks his secretary  (Secy@Host)  to  send  a
  2501.         message for him in his capacity as Group.  He wants his secre-
  2502.         tary to handle all replies.
  2503.  
  2504.             From:     George Jones <Group@Host>
  2505.             Sender:   Secy@Host
  2506.             Reply-To: Secy@Host
  2507.  
  2508.      _H._2._6.  Agent for user without online mailbox
  2509.  
  2510.              A friend  of  George's,  Sarah,  is  visiting.   George's
  2511.         secretary  sends  some  mail to a friend of Sarah in computer-
  2512.         land.  Replies should go to George, whose mailbox is Jones  at
  2513.         Registry.
  2514.  
  2515.             From:     Sarah Friendly <Secy@Registry>
  2516.             Sender:   Secy-Name <Secy@Registry>
  2517.             Reply-To: Jones@Registry.
  2518.  
  2519.      _H._2._7.  Agent for member of a committee
  2520.  
  2521.              George's secretary sends out a message which was authored
  2522.         jointly by all the members of a committee.  Note that the name
  2523.         of the committee cannot be specified, since <group> names  are
  2524.         not permitted in the From field.
  2525.  
  2526.             From:   Jones@Host,
  2527.                     Smith@Other-Host,
  2528.                     Doe@Somewhere-Else
  2529.             Sender: Secy@SHost
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2542.  
  2543.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33338888 ----                      RRRRFFFFCCCC ####888822222222
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2556.  
  2557.  
  2558.      _H._3.  _C_o_m_p_l_e_t_e _H_e_a_d_e_r_s
  2559.  
  2560.      _H._3._1.  Minimum required
  2561.  
  2562.      Date:     26 Aug 76 1429 EDT        Date:     26 Aug 76 1429 EDT
  2563.      From:     Jones@Registry.Org   or   From:     Jones@Registry.Org
  2564.      Bcc:                                To:       Smith@Registry.Org
  2565.  
  2566.         Note that the "Bcc" field may be empty, while the  "To"  field
  2567.         is required to have at least one address.
  2568.  
  2569.      _H._3._2.  Using some of the additional fields
  2570.  
  2571.      Date:     26 Aug 76 1430 EDT
  2572.      From:     George Jones<Group@Host>
  2573.      Sender:   Secy@SHOST
  2574.      To:       "Al Neuman"@Mad-Host,
  2575.                Sam.Irving@Other-Host
  2576.      Message-ID:  <some.string@SHOST>
  2577.  
  2578.      _H._3._3.  About as complex as you're going to get
  2579.  
  2580.      Date     :  27 Aug 76 0932 PDT
  2581.      >From     :  Ken Davis <KDavis@This-Host.This-net>
  2582.      Subject  :  Re: The Syntax in the RFC
  2583.      Sender   :  KSecy@Other-Host
  2584.      Reply-To :  Sam.Irving@Reg.Organization
  2585.      To       :  George Jones <Group@Some-Reg.An-Org>,
  2586.                  Al.Neuman@MAD.Publisher
  2587.      cc       :  Important folk:
  2588.                    Tom Softwood <Balsa@Tree.Root>,
  2589.                    "Sam Irving"@Other-Host;,
  2590.                  Standard Distribution:
  2591.                    /main/davis/people/standard@Other-Host,
  2592.                    "<Jones>standard.dist.3"@Tops-20-Host>;
  2593.      Comment  :  Sam is away on business. He asked me to handle
  2594.                  his mail for him.  He'll be able to provide  a
  2595.                  more  accurate  explanation  when  he  returns
  2596.                  next week.
  2597.      In-Reply-To: <some.string@DBM.Group>, George's message
  2598.      X-Special-action:  This is a sample of user-defined field-
  2599.                  names.  There could also be a field-name
  2600.                  "Special-action", but its name might later be
  2601.                  preempted
  2602.      Message-ID: <4231.629.XYzi-What@Other-Host>
  2603.  
  2604.  
  2605.  
  2607.  
  2608.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 33339999 ----                      RRRRFFFFCCCC ####888822222222
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2621.  
  2622.  
  2623.      _I.  _S_I_M_P_L_E _F_I_E_L_D _P_A_R_S_I_N_G
  2624.  
  2625.           Some mail-reading software systems may wish to perform  only
  2626.      minimal  processing,  ignoring  the internal syntax of structured
  2627.      field-bodies and treating them the  same  as  unstructured-field-
  2628.      bodies.  Such software will need only to distinguish:
  2629.  
  2630.          o   Header fields from the message body,
  2631.  
  2632.          o   Beginnings of fields from lines which continue fields,
  2633.  
  2634.          o   Field-names from field-contents.
  2635.  
  2636.           The abbreviated set of syntactic rules  which  follows  will
  2637.      suffice  for  this  purpose.  It describes a limited view of mes-
  2638.      sages and is a subset of the syntactic rules provided in the main
  2639.      part of this specification.  One small exception is that the con-
  2640.      tents of field-bodies consist only of text:
  2641.  
  2642.      _I._1.  _S_y_n_t_a_x
  2643.  
  2644.  
  2645.      message         =   *field *(CRLF *text)
  2646.  
  2647.      field           =    field-name ":" [field-body] CRLF
  2648.  
  2649.      field-name      =  1*<any CHAR, excluding CTLs, SPACE, and ":">
  2650.  
  2651.      field-body      =   *text [CRLF LWSP-char field-body]
  2652.  
  2653.  
  2654.      _I._2.  _S_e_m_a_n_t_i_c_s
  2655.  
  2656.           Headers occur before the message body and are terminated  by
  2657.      a null line (i.e., two contiguous CRLFs).
  2658.  
  2659.           A line which continues a header field begins with a SPACE or
  2660.      HTAB  character,  while  a  line  beginning a field starts with a
  2661.      printable character which is not a colon.
  2662.  
  2663.           A field-name consists of one or  more  printable  characters
  2664.      (excluding  colon,  space, and control-characters).  A field-name
  2665.      _m_u_s_t be contained on one line.  Upper and lower case are not dis-
  2666.      tinguished when comparing field-names.
  2667.  
  2668.  
  2669.  
  2670.  
  2672.  
  2673.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 44440000 ----                      RRRRFFFFCCCC ####888822222222
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2686.  
  2687.  
  2688.      _J.  _D_I_F_F_E_R_E_N_C_E_S _F_R_O_M _R_F_C #_7_3_3
  2689.  
  2690.           The following summarizes the differences between this  stan-
  2691.      dard  and the one specified in Arpanet Request for Comments #733,
  2692.      "Standard for the Format of ARPA  Network  Text  Messages".   The
  2693.      differences  are  listed  in the order of their occurrence in the
  2694.      current specification.
  2695.  
  2696.      _J._1.  _F_i_e_l_d _D_e_f_i_n_i_t_i_o_n_s
  2697.  
  2698.      _J._1._1.  _F_i_e_l_d _n_a_m_e_s
  2699.  
  2700.         These now must be a sequence of  printable  characters.   They
  2701.         may not contain any LWSP-chars.
  2702.  
  2703.      _J._2.  _L_e_x_i_c_a_l _T_o_k_e_n_s
  2704.  
  2705.      _J._2._1.  _S_p_e_c_i_a_l_s
  2706.  
  2707.         The characters period ("."), left-square  bracket  ("["),  and
  2708.         right-square  bracket ("]") have been added.  For presentation
  2709.         purposes, and when passing a specification to  a  system  that
  2710.         does  not conform to this standard, periods are to be contigu-
  2711.         ous with their surrounding lexical tokens.   No  linear-white-
  2712.         space  is  permitted  between them.  The presence of one LWSP-
  2713.         char between other tokens is still directed.
  2714.  
  2715.      _J._2._2.  _A_t_o_m
  2716.  
  2717.         Atoms may not contain SPACE.
  2718.  
  2719.      _J._2._3.  _S_p_e_c_i_a_l _t_e_x_t
  2720.  
  2721.         ctext and qtext have had backslash ("\") added to the list  of
  2722.         prohibited characters.
  2723.  
  2724.      _J._2._4.  _D_o_m_a_i_n_s
  2725.  
  2726.         The lexical tokens  <domain-literal>  and  <dtext>  have  been
  2727.         added.
  2728.  
  2729.      _J._3.  _M_e_s_s_a_g_e _S_p_e_c_i_f_i_c_a_t_i_o_n
  2730.  
  2731.      _J._3._1.  _T_r_a_c_e
  2732.  
  2733.         The "Return-path:" and "Received:" fields have been specified.
  2734.  
  2735.  
  2737.  
  2738.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 44441111 ----                      RRRRFFFFCCCC ####888822222222
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2751.  
  2752.  
  2753.      _J._3._2.  _F_r_o_m
  2754.  
  2755.         The "From" field must contain machine-usable addresses  (addr-
  2756.         spec).   Multiple  addresses may be specified, but named-lists
  2757.         (groups) may not.
  2758.  
  2759.      _J._3._3.  _R_e_s_e_n_t
  2760.  
  2761.         The meta-construct of prefacing field names  with  the  string
  2762.         "Resent-"  has been added, to indicate that a message has been
  2763.         forwarded by an intermediate recipient.
  2764.  
  2765.      _J._3._4.  _D_e_s_t_i_n_a_t_i_o_n
  2766.  
  2767.         A message must contain at least one destination address field.
  2768.         "To" and "CC" are required to contain at least one address.
  2769.  
  2770.      _J._3._5.  _I_n-_R_e_p_l_y-_T_o
  2771.  
  2772.         The field-body is no longer a comma-separated list, although a
  2773.         sequence is still permitted.
  2774.  
  2775.      _J._3._6.  _R_e_f_e_r_e_n_c_e
  2776.  
  2777.         The field-body is no longer a comma-separated list, although a
  2778.         sequence is still permitted.
  2779.  
  2780.      _J._3._7.  _E_n_c_r_y_p_t_e_d
  2781.  
  2782.         A field has been specified that permits  senders  to  indicate
  2783.         that the body of a message has been encrypted.
  2784.  
  2785.      _J._3._8.  _E_x_t_e_n_s_i_o_n-_f_i_e_l_d
  2786.  
  2787.         Extension fields are prohibited from beginning with the  char-
  2788.         acters "X-".
  2789.  
  2790.      _J._4.  _D_a_t_e _a_n_d _T_i_m_e _S_p_e_c_i_f_i_c_a_t_i_o_n
  2791.  
  2792.      _J._4._1.  _S_i_m_p_l_i_f_i_c_a_t_i_o_n
  2793.  
  2794.         Fewer optional forms are permitted  and  the  list  of  three-
  2795.         letter time zones has been shortened.
  2796.  
  2797.      _J._5.  _A_d_d_r_e_s_s _S_p_e_c_i_f_i_c_a_t_i_o_n
  2798.  
  2799.  
  2800.  
  2802.  
  2803.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 44442222 ----                      RRRRFFFFCCCC ####888822222222
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2816.  
  2817.  
  2818.      _J._5._1.  _A_d_d_r_e_s_s
  2819.  
  2820.         The use of quoted-string, and the ":"-atom-":" construct, have
  2821.         been  removed.   An  address  now  is  either a single mailbox
  2822.         reference or is a named list of addresses.  The  latter  indi-
  2823.         cates a group distribution.
  2824.  
  2825.      _J._5._2.  _G_r_o_u_p_s
  2826.  
  2827.         Group lists are now required to to have a name.   Group  lists
  2828.         may not be nested.
  2829.  
  2830.      _J._5._3.  _M_a_i_l_b_o_x
  2831.  
  2832.         A mailbox specification  may  indicate  a  person's  name,  as
  2833.         before.   Such  a  named  list  no longer may specify multiple
  2834.         mailboxes and may not be nested.
  2835.  
  2836.      _J._5._4.  _R_o_u_t_e _a_d_d_r_e_s_s_i_n_g
  2837.  
  2838.         Addresses now are taken to be absolute, global specifications,
  2839.         independent  of transmission paths.  The <route> construct has
  2840.         been provided, to permit explicit specification  of  transmis-
  2841.         sion  path.   RFC  #733's  use  of multiple at-signs ("@") was
  2842.         intended as a general syntax  for  indicating  routing  and/or
  2843.         hierarchical addressing.  The current standard separates these
  2844.         specifications and only one at-sign is permitted.
  2845.  
  2846.      _J._5._5.  _A_t-_s_i_g_n
  2847.  
  2848.         The string " at " no longer is used as an  address  delimiter.
  2849.         Only at-sign ("@") serves the function.
  2850.  
  2851.      _J._5._6.  _D_o_m_a_i_n_s
  2852.  
  2853.         Hierarchical, logical name-domains have been added.
  2854.  
  2855.      _J._6.  _R_e_s_e_r_v_e_d _A_d_d_r_e_s_s
  2856.  
  2857.      The local-part "Postmaster" has been reserved, so that users  can
  2858.      be guaranteed at least one valid address at a site.
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2867.  
  2868.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 44443333 ----                      RRRRFFFFCCCC ####888822222222
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2881.  
  2882.  
  2883.      _K.  _A_L_P_H_A_B_E_T_I_C_A_L _L_I_S_T_I_N_G _O_F _S_Y_N_T_A_X _R_U_L_E_S
  2884.  
  2885.      address     =  mailbox                      ; one addressee
  2886.                  /  group                        ; named list
  2887.      addr-spec   =  local-part "@" domain        ; global address
  2888.      ALPHA       =  <any ASCII alphabetic character>
  2889.                                                  ; (101-132, 65.- 90.)
  2890.                                                  ; (141-172, 97.-122.)
  2891.      atom        =  1*<any CHAR except specials, SPACE and CTLs>
  2892.      authentic   =   "From"       ":"   mailbox  ; Single author
  2893.                  / ( "Sender"     ":"   mailbox  ; Actual submittor
  2894.                      "From"       ":" 1#mailbox) ; Multiple authors
  2895.                                                  ;  or not sender
  2896.      CHAR        =  <any ASCII character>        ; (  0-177,  0.-127.)
  2897.      comment     =  "(" *(ctext / quoted-pair / comment) ")"
  2898.      CR          =  <ASCII CR, carriage return>  ; (     15,      13.)
  2899.      CRLF        =  CR LF
  2900.      ctext       =  <any CHAR excluding "(",     ; => may be folded
  2901.                      ")", "\" & CR, & including
  2902.                      linear-white-space>
  2903.      CTL         =  <any ASCII control           ; (  0- 37,  0.- 31.)
  2904.                      character and DEL>          ; (    177,     127.)
  2905.      date        =  1*2DIGIT month 2DIGIT        ; day month year
  2906.                                                  ;  e.g. 20 Jun 82
  2907.      dates       =   orig-date                   ; Original
  2908.                    [ resent-date ]               ; Forwarded
  2909.      date-time   =  [ day "," ] date time        ; dd mm yy
  2910.                                                  ;  hh:mm:ss zzz
  2911.      day         =  "Mon"  / "Tue" /  "Wed"  / "Thu"
  2912.                  /  "Fri"  / "Sat" /  "Sun"
  2913.      delimiters  =  specials / linear-white-space / comment
  2914.      destination =  "To"          ":" 1#address  ; Primary
  2915.                  /  "Resent-To"   ":" 1#address
  2916.                  /  "cc"          ":" 1#address  ; Secondary
  2917.                  /  "Resent-cc"   ":" 1#address
  2918.                  /  "bcc"         ":"  #address  ; Blind carbon
  2919.                  /  "Resent-bcc"  ":"  #address
  2920.      DIGIT       =  <any ASCII decimal digit>    ; ( 60- 71, 48.- 57.)
  2921.      domain      =  sub-domain *("." sub-domain)
  2922.      domain-literal =  "[" *(dtext / quoted-pair) "]"
  2923.      domain-ref  =  atom                         ; symbolic reference
  2924.      dtext       =  <any CHAR excluding "[",     ; => may be folded
  2925.                      "]", "\" & CR, & including
  2926.                      linear-white-space>
  2927.  
  2928.  
  2929.  
  2930.  
  2932.  
  2933.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 44444444 ----                      RRRRFFFFCCCC ####888822222222
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  2946.  
  2947.  
  2948.      extension-field =
  2949.                    <Any field which is defined in a document
  2950.                     published as a formal extension to this
  2951.                     specification; none will have names beginning
  2952.                     with the string "X-">
  2953.      field       =  field-name ":" [ field-body ] CRLF
  2954.      fields      =    dates                      ; Creation time,
  2955.                       source                     ;  author id & one
  2956.                     1*destination                ;  address required
  2957.                      *optional-field             ;  others optional
  2958.      field-body  =  field-body-contents
  2959.                     [CRLF LWSP-char field-body]
  2960.      field-body-contents =
  2961.                    <the ASCII characters making up the field-body, as
  2962.                     defined in the following sections, and consisting
  2963.                     of combinations of atom, quoted-string, and
  2964.                     specials tokens, or else consisting of texts>
  2965.      field-name  =  1*<any CHAR, excluding CTLs, SPACE, and ":">
  2966.      group       =  phrase ":" [#mailbox] ";"
  2967.      hour        =  2DIGIT ":" 2DIGIT [":" 2DIGIT]
  2968.                                                  ; 00:00:00 - 23:59:59
  2969.      HTAB        =  <ASCII HT, horizontal-tab>   ; (     11,       9.)
  2970.      LF          =  <ASCII LF, linefeed>         ; (     12,      10.)
  2971.      linear-white-space =  1*([CRLF] LWSP-char)  ; semantics = SPACE
  2972.                                                  ; CRLF => folding
  2973.      local-part  =  word *("." word)             ; uninterpreted
  2974.                                                  ; case-preserved
  2975.      LWSP-char   =  SPACE / HTAB                 ; semantics = SPACE
  2976.      mailbox     =  addr-spec                    ; simple address
  2977.                  /  phrase route-addr            ; name & addr-spec
  2978.      message     =  fields *( CRLF *text )       ; Everything after
  2979.                                                  ;  first null line
  2980.                                                  ;  is message body
  2981.      month       =  "Jan"  /  "Feb" /  "Mar"  /  "Apr"
  2982.                  /  "May"  /  "Jun" /  "Jul"  /  "Aug"
  2983.                  /  "Sep"  /  "Oct" /  "Nov"  /  "Dec"
  2984.      msg-id      =  "<" addr-spec ">"            ; Unique message id
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2997.  
  2998.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 44445555 ----                      RRRRFFFFCCCC ####888822222222
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  3011.  
  3012.  
  3013.      optional-field =
  3014.                  /  "Message-ID"        ":"   msg-id
  3015.                  /  "Resent-Message-ID" ":"   msg-id
  3016.                  /  "In-Reply-To"       ":"  *(phrase / msg-id)
  3017.                  /  "References"        ":"  *(phrase / msg-id)
  3018.                  /  "Keywords"          ":"  #phrase
  3019.                  /  "Subject"           ":"  *text
  3020.                  /  "Comments"          ":"  *text
  3021.                  /  "Encrypted"         ":" 1#2word
  3022.                  /  extension-field              ; To be defined
  3023.                  /  user-defined-field           ; May be pre-empted
  3024.      orig-date   =  "Date"        ":"   date-time
  3025.      originator  =   authentic                   ; authenticated addr
  3026.                    [ "Reply-To"   ":" 1#address] )
  3027.      phrase      =  1*word                       ; Sequence of words
  3028.      qtext       =  <any CHAR excepting <">,     ; => may be folded
  3029.                      "\" & CR, and including
  3030.                      linear-white-space>
  3031.      quoted-pair =  "\" CHAR                     ; may quote any char
  3032.      quoted-string = <"> *(qtext/quoted-pair) <">; Regular qtext or
  3033.                                                  ;   quoted chars.
  3034.      received    =  "Received"    ":"            ; one per relay
  3035.                        ["from" domain]           ; sending host
  3036.                        ["by"   domain]           ; receiving host
  3037.                        ["via"  atom]             ; physical path
  3038.                       *("with" atom)             ; link/mail protocol
  3039.                        ["id"   msg-id]           ; receiver msg id
  3040.                        ["for"  addr-spec]        ; initial form
  3041.                         ";"    date-time         ; time received
  3042.  
  3043.      resent      =   resent-authentic
  3044.                    [ "Resent-Reply-To"  ":" 1#address] )
  3045.      resent-authentic =
  3046.                  =   "Resent-From"      ":"   mailbox
  3047.                  / ( "Resent-Sender"    ":"   mailbox
  3048.                      "Resent-From"      ":" 1#mailbox  )
  3049.      resent-date =  "Resent-Date" ":"   date-time
  3050.      return      =  "Return-path" ":" route-addr ; return address
  3051.      route       =  1#("@" domain) ":"           ; path-relative
  3052.      route-addr  =  "<" [route] addr-spec ">"
  3053.      source      = [  trace ]                    ; net traversals
  3054.                       originator                 ; original mail
  3055.                    [  resent ]                   ; forwarded
  3056.      SPACE       =  <ASCII SP, space>            ; (     40,      32.)
  3057.      specials    =  "(" / ")" / "<" / ">" / "@"  ; Must be in quoted-
  3058.                  /  "," / ";" / ":" / "\" / <">  ;  string, to use
  3059.                  /  "." / "[" / "]"              ;  within a word.
  3060.      sub-domain  =  domain-ref / domain-literal
  3062.  
  3063.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 44446666 ----                      RRRRFFFFCCCC ####888822222222
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  3076.  
  3077.  
  3078.      text        =  <any CHAR, including bare    ; => atoms, specials,
  3079.                      CR & bare LF, but NOT       ;  comments and
  3080.                      including CRLF>             ;  quoted-strings are
  3081.                                                  ;  NOT recognized.
  3082.      time        =  hour zone                    ; ANSI and Military
  3083.      trace       =    return                     ; path to sender
  3084.                     1*received                   ; receipt tags
  3085.      user-defined-field =
  3086.                    <Any field which has not been defined
  3087.                     in this specification or published as an
  3088.                     extension to this specification; names for
  3089.                     such fields must be unique and may be
  3090.                     pre-empted by published extensions>
  3091.      word        =  atom / quoted-string
  3092.      zone        =  "UT"  / "GMT"                ; Universal Time
  3093.                                                  ; North American : UT
  3094.                  /  "EST" / "EDT"                ;  Eastern:  - 5/ - 4
  3095.                  /  "CST" / "CDT"                ;  Central:  - 6/ - 5
  3096.                  /  "MST" / "MDT"                ;  Mountain: - 7/ - 6
  3097.                  /  "PST" / "PDT"                ;  Pacific:  - 8/ - 7
  3098.                  /  1ALPHA                       ; Military: Z = UT;
  3099.      <">         =  <ASCII quote mark>           ; (     42,      34.)
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3127.  
  3128.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- 44447777 ----                      RRRRFFFFCCCC ####888822222222
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.      RFC #  822
  3145.  
  3146.      Obsoletes:  RFC #733  (NIC #41952)
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.                         STANDARD FOR THE FORMAT OF
  3160.  
  3161.                         ARPA INTERNET TEXT MESSAGES
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.                              January 13, 1983
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.                                 Revised by
  3176.  
  3177.                              David H. Crocker
  3178.  
  3179.  
  3180.                       Dept. of Electrical Engineering
  3181.                  University of Delaware, Newark, DE  19711
  3182.                       Network:  DCrocker @ UDel-Relay
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3192.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  3206.  
  3207.  
  3208.                              TABLE OF CONTENTS
  3209.  
  3210.  
  3211.      PREFACE ....................................................   ii
  3212.  
  3213.      1.  INTRODUCTION ...........................................    1
  3214.  
  3215.          1.1.  Scope ............................................    1
  3216.          1.2.  Communication Framework ..........................    2
  3217.  
  3218.      2.  NOTATIONAL CONVENTIONS .................................    3
  3219.  
  3220.      3.  LEXICAL ANALYSIS OF MESSAGES ...........................    5
  3221.  
  3222.          3.1.  General Description ..............................    5
  3223.          3.2.  Header Field Definitions .........................    9
  3224.          3.3.  Lexical Tokens ...................................   10
  3225.          3.4.  Clarifications ...................................   11
  3226.  
  3227.      4.  MESSAGE SPECIFICATION ..................................   17
  3228.  
  3229.          4.1.  Syntax ...........................................   17
  3230.          4.2.  Forwarding .......................................   19
  3231.          4.3.  Trace Fields .....................................   20
  3232.          4.4.  Originator Fields ................................   21
  3233.          4.5.  Receiver Fields ..................................   23
  3234.          4.6.  Reference Fields .................................   23
  3235.          4.7.  Other Fields .....................................   24
  3236.  
  3237.      5.  DATE AND TIME SPECIFICATION ............................   26
  3238.  
  3239.          5.1.  Syntax ...........................................   26
  3240.          5.2.  Semantics ........................................   26
  3241.  
  3242.      6.  ADDRESS SPECIFICATION ..................................   27
  3243.  
  3244.          6.1.  Syntax ...........................................   27
  3245.          6.2.  Semantics ........................................   27
  3246.          6.3.  Reserved Address .................................   33
  3247.  
  3248.      7.  BIBLIOGRAPHY ...........................................   34
  3249.  
  3250.  
  3251.                              APPENDIX
  3252.  
  3253.      H.  EXAMPLES ...............................................   36
  3254.      I.  SIMPLE FIELD PARSING ...................................   40
  3255.      J.  DIFFERENCES FROM RFC #733 ..............................   41
  3256.      K.  ALPHABETICAL LISTING OF SYNTAX RULES ...................   44
  3257.  
  3258.  
  3259.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333              ---- iiii ----                      RRRRFFFFCCCC ####888822222222
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.      SSSSttttaaaannnnddddaaaarrrrdddd ffffoooorrrr AAAARRRRPPPPAAAA IIIInnnntttteeeerrrrnnnneeeetttt TTTTeeeexxxxtttt MMMMeeeessssssssaaaaggggeeeessss
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.  
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3323.  
  3324.      JJJJaaaannnnuuuuaaaarrrryyyy 11113333,,,, 1111999988883333             ---- iiiiiiii ----                      RRRRFFFFCCCC ####888822222222
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.