Commit | Line | Data |
---|---|---|
8d5530c4 MW |
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) |