summaryrefslogtreecommitdiff
path: root/man/setmaillist.1
blob: 59fbf7dcaf82b1900e3acff525c12e4671fc2573 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
.TH s/qmail: setmaillist 1
.SH NAME
setmaillist \- create a binary mailing list
.SH SYNOPSIS
.B setmaillist
.I bin
.I tmp
.SH DESCRIPTION
.B setmaillist
reads a mailing list from its standard input.

.B setmaillist
writes the mailing list in a binary format to
.IR tmp ;
it then moves
.I tmp
to
.IR bin .
.I tmp
and
.I bin
must be on the same filesystem.

If there is a problem creating
.IR tmp ,
.B setmaillist
complains and leaves
.I bin
alone.

The binary mailing list format is portable across machines.

.B setmaillist
always creates
.I bin
world-readable.
.SH "MAILING LIST FORMAT"
The mailing list read by
.B setmaillist
is a series of lines.
NUL bytes are not allowed.

If a line begins with a dot or slash,
.B setmaillist
takes the entire line as an include file name.

If a line begins with an ampersand,
.B setmaillist
takes the rest of the line as a recipient address.
If a line begins with a letter or number,
.B setmaillist
takes the entire line as a recipient address.
Each recipient address must include a fully qualified domain name.
Recipient addresses longer than 800 bytes are not allowed.

.B setmaillist
ignores blank lines
and lines beginning with #.
It also ignores spaces and tabs at the ends of lines.

For example,

.EX
   god@heaven.af.mil
   djb@silverton.berkeley.edu
.EE

is a mailing list with two addresses.
.SH "SEE ALSO"
setforward(1),
newinclude(1),
printmaillist(1)