mdw@git.distorted.org.uk Git - fastforward/blob - setmaillist.1

   1 .TH setmaillist 1
   2 .SH NAME
   3 setmaillist \- create a binary mailing list
   4 .SH SYNOPSIS
   5 .B setmaillist
   6 .I bin
   7 .I tmp
   8 .SH DESCRIPTION
   9 .B setmaillist
  10 reads a mailing list from its standard input.
  11
  12 .B setmaillist
  13 writes the mailing list in a binary format to
  14 .IR tmp ;
  15 it then moves
  16 .I tmp
  17 to
  18 .IR bin .
  19 .I tmp
  20 and
  21 .I bin
  22 must be on the same filesystem.
  23
  24 If there is a problem creating
  25 .IR tmp ,
  26 .B setmaillist
  27 complains and leaves
  28 .I bin
  29 alone.
  30
  31 The binary mailing list format is portable across machines.
  32
  33 .B setmaillist
  34 always creates
  35 .I bin
  36 world-readable.
  37 .SH "MAILING LIST FORMAT"
  38 The mailing list read by
  39 .B setmaillist
  40 is a series of lines.
  41 NUL bytes are not allowed.
  42
  43 If a line begins with a dot or slash,
  44 .B setmaillist
  45 takes the entire line as an include file name.
  46
  47 If a line begins with an ampersand,
  48 .B setmaillist
  49 takes the rest of the line as a recipient address.
  50 If a line begins with a letter or number,
  51 .B setmaillist
  52 takes the entire line as a recipient address.
  53 Each recipient address must include a fully qualified domain name.
  54 Recipient addresses longer than 800 bytes are not allowed.
  55
  56 .B setmaillist
  57 ignores blank lines
  58 and lines beginning with #.
  59 It also ignores spaces and tabs at the ends of lines.
  60
  61 For example,
  62
  63 .EX
  64    god@heaven.af.mil
  65    djb@silverton.berkeley.edu
  66 .EE
  67
  68 is a mailing list with two addresses.
  69 .SH "SEE ALSO"
  70 setforward(1),
  71 newinclude(1),
  72 printmaillist(1)