home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / rfc / 700s / rfc785.txt < prev    next >
Text File  |  1992-10-14  |  7KB  |  175 lines
  1.  
  2.                                                                         
  3. Network Working Group                                         S. Sluizer
  4. Request for Comments: 785                                      J. Postel
  5.                                                                      ISI
  6.                                                                July 1981
  7.  
  8.                         MAIL TRANSFER PROTOCOL:
  9.                       ISI TOPS20 FILE DEFINITIONS
  10.  
  11.  
  12. INTRODUCTION
  13.  
  14.    This document defines the ISI TOPS20s interface between the Mail
  15.    Transfer Protocol (MTP) and a mail creation system (e.g., MM, HERMES,
  16.    etc.) in terms of the files which implement it.  The internal
  17.    structure and name of each file is described below.
  18.  
  19.    For a complete understanding of the MTP protocol as well as the terms
  20.    used within this document, see RFC 780, "Mail Transfer Protocol".
  21.  
  22. DESCRIPTION
  23.  
  24.    For each piece of mail, the TOPS20 interface between a mail creation
  25.    system and MTP is comprised of two files.  The first file must be
  26.    named "^V[--UNSENT-MAIL-CONTROL--^V].MTP.-1", where "^V" represents
  27.    the character "control V" (ASCII code 026) and the generation number
  28.    "-1" indicates the next higher generation number (at the time of the
  29.    file's creation).  It is strongly suggested that the second file be
  30.    named "^V[--UNSENT-MAIL-FILE--^V].MTP.-1", where "^V" and "-1" are as
  31.    defined before.  (However, the actual file name may be chosen by the
  32.    mail creation system.)  Both these files reside in the directory of
  33.    the user who created the mail (as is currently the case with the
  34.    MAILER-based system).
  35.  
  36.    "^V[--UNSENT-MAIL-CONTROL--^V].MTP.-1" is the control file.  It is an
  37.    ASCIZ file and contains all information necessary to relay the mail
  38.    through MTP.  It consists of a pointer to the mail text, the
  39.    source-path, and all destination-paths.
  40.  
  41.    First is "FILE:" followed by the FULL mail text file name (which must
  42.    include directory name and generation number) followed by <CRLF>
  43.    (ASCII code 15 followed by ASCII code 12).  Note that a structure
  44.    name is allowed; if not given "PS:" will be assumed.  Also note that
  45.    for each character that must be quoted in a file name the quote
  46.    character (^V) must be present in the string following "FILE:".  Next
  47.    is "FROM:" followed by the <FROM-path> followed by <CRLF>.  Finally,
  48.    each destination is given in the form "TO:" followed by the <TO-path>
  49.    followed by <CRLF>.  The FROM- and TO-paths include surrounding angle
  50.    brackets (i.e., <...>) and are identical respectively to the source-
  51.    and destination-paths described in RFC 780.
  52.  
  53.  
  54.  
  55.  
  56.  
  57. Sluizer & Postel                                                Page [1]
  58.  
  59.  
  60.                                                                         
  61. July 1981                                                        RFC 785
  62. ISI TOPS20 File Definitions                                             
  63.  
  64.  
  65.  
  66.   ---------------------------------------------------------------------
  67.                        +------------------------+
  68.                        |FILE: <File name> <CRLF>|
  69.                        +------------------------+
  70.                        |FROM: <FROM-path> <CRLF>|
  71.                        +------------------------+
  72.                        |  TO: <TO-path> <CRLF>  |
  73.                        +------------------------+
  74.                        |           ...          |
  75.                        +------------------------+
  76.                        |  TO: <TO-path> <CRLF>  |
  77.                        +------------------------+
  78.  
  79.         File structure for ^V[--UNSENT-MAIL-CONTROL--^V].MTP.-1
  80.                                 Figure 1
  81.   ---------------------------------------------------------------------
  82.  
  83.    "^V[--UNSENT-MAIL-FILE--^V].MTP.-1" is the mail text file.  (Note
  84.    that this is the file to which <File name> in the control file
  85.    refers.)  It is mail which conforms to the standard described in RFC
  86.    733, "Standard for the Format of ARPA Network Text Messages".
  87.  
  88. DISCUSSION
  89.  
  90.    The older mail creation systems create N copies of a mail text file,
  91.    one for each of the N addresses in the TO, CC, and BCC fields.  Each
  92.    file is named "^V[--UNSENT-MAIL--^V].<mailbox>^V@<host>.-1", where
  93.    <mailbox> and <host> are as defined in MTP, and "^V" and "-1" are as
  94.    defined above.
  95.  
  96.    The interface between the mail creation system and MTP requires only
  97.    the creation of two files, regardless of the number of addresses in
  98.    the TO, CC, and BCC fields.  The control file contains the
  99.    source-path and destination-paths information as well as a pointer to
  100.    the mail text file.  The mail text file contains the the RFC 733
  101.    header and body.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115. Page [2]                                                Sluizer & Postel
  116.  
  117.  
  118.                                                                         
  119. RFC 785                                                        July 1981
  120.                                                   Mail Transfer Protocol
  121.  
  122.  
  123.  
  124. EXAMPLE
  125.  
  126.    In this example, there were no previously existing versions of either
  127.    the control file or the mail text file in directory <LINDA> where the
  128.    message was created.  Figure 2 shows the mail text file and figure 3
  129.    shows the control file.
  130.  
  131.    ------------------------------------------------------------------
  132.       DATE: April 6, 1981
  133.       Sender: Linda at ISIF
  134.       From: Jon Postel <postel@isif>
  135.       To: DCrocker at UDel, Cerf at ISIA
  136.       Cc: postel@ISIF
  137.       Bcc: sluizer@isif
  138.       Subject: MTP discussion
  139.       
  140.       Your comments on the MTP document were most helpful.  A revised
  141.       version will be forthcoming shortly.
  142.       
  143.       Thanks again,
  144.       --jon
  145.  
  146.         File contents of <LINDA>^V[--UNSENT-MAIL-FILE--^V].MTP.1
  147.                                 Figure 2
  148.    ------------------------------------------------------------------
  149.  
  150.    ------------------------------------------------------------------
  151.           +--------------------------------------------------+
  152.           |FILE:<LINDA>^V[--UNSENT-MAIL-FILE--^V].MTP.1<CRLF>|
  153.           +--------------------------------------------------+
  154.           |FROM:<Linda@ISIF><CRLF>                           |
  155.           +--------------------------------------------------+
  156.           |TO:<DCrocker@UDel><CRLF>                          |
  157.           +--------------------------------------------------+
  158.           |TO:<Cerf@ISIA><CRLF>                              |
  159.           +--------------------------------------------------+
  160.           |TO:<postel@ISIF><CRLF>                            |
  161.           +--------------------------------------------------+
  162.           |TO:<sluizer@isif><CRLF>                           |
  163.           +--------------------------------------------------+
  164.  
  165.           File contents of ^V[--UNSENT-MAIL-CONTROL--^V].MTP.1
  166.                                 Figure 3
  167.    ------------------------------------------------------------------
  168.  
  169.  
  170.  
  171.  
  172.  
  173. Sluizer & Postel                                                Page [3]
  174.  
  175.