usr.bin/mail/USD.doc/mail7.nr

   1 .\" Copyright (c) 1980, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the University nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\"     @(#)mail7.nr    8.1 (Berkeley) 6/8/93
  29 .\"
  30 .sh 1 "Format of messages"
  31 .pp
  32 This section describes the format of messages.
  33 Messages begin with a
  34 .i from
  35 line, which consists of the word
  36 .q From
  37 followed by a user name, followed by anything, followed by
  38 a date in the format returned by the
  39 .i ctime
  40 library routine described in section 3 of the Unix Programmer's
  41 Manual.  A possible
  42 .i ctime
  43 format date is:
  44 .(l
  45 Tue Dec  1 10:58:23 1981
  46 .)l
  47 The
  48 .i ctime
  49 date may be optionally followed by a single space and a
  50 time zone indication, which
  51 should be three capital letters, such as PDT.
  52 .pp
  53 Following the
  54 .i from
  55 line are zero or more
  56 .i "header field"
  57 lines.
  58 Each header field line is of the form:
  59 .(l
  60 name: information
  61 .)l
  62 .i Name
  63 can be anything, but only certain header fields are recognized as
  64 having any meaning.  The recognized header fields are:
  65 .i article-id ,
  66 .i bcc ,
  67 .i cc ,
  68 .i from ,
  69 .i reply-to ,
  70 .i sender ,
  71 .i subject ,
  72 and
  73 .i to .
  74 Other header fields are also significant to other systems; see,
  75 for example, the current Arpanet message standard for much more
  76 information on this topic.
  77 A header field can be continued onto following lines by making the
  78 first character on the following line a space or tab character.
  79 .pp
  80 If any headers are present, they must be followed by a blank line.
  81 The part that follows is called the
  82 .i body
  83 of the message, and must be ASCII text, not containing null characters.
  84 Each line in the message body must be no longer than 512 characters and
  85 terminated with an ASCII newline character.
  86 If binary data must be passed through the mail system, it is suggested
  87 that this data be encoded in a system which encodes six bits into
  88 a printable character (i.e.: uuencode).
  89 For example, one could use the upper and lower case letters, the digits,
  90 and the characters comma and period to make up the 64 characters.
  91 Then, one can send a 16-bit binary number
  92 as three characters.  These characters should be packed into lines,
  93 preferably lines about 70 characters long as long lines are transmitted
  94 more efficiently.
  95 .pp
  96 The message delivery system always adds a blank line to the end of
  97 each message.  This blank line must not be deleted.
  98 .pp
  99 The UUCP message delivery system sometimes adds a blank line to
 100 the end of a message each time it is forwarded through a machine.
 101 .pp
 102 It should be noted that some network transport protocols enforce
 103 limits to the lengths of messages.