summaryrefslogtreecommitdiff
path: root/man/newinclude.1
blob: 44edb9d42b564a9e1ab016fa68d99e6aaa0b341e (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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
.TH s/qmail: newinclude 1
.SH NAME
newinclude \- create a binary mailing list from an :include: file
.SH SYNOPSIS
.B newinclude
.I list
.SH DESCRIPTION
.B newinclude
reads a
sendmail-style
.B :include:
file,
.IR list ,
and converts it into a binary format in
.I list\fB.bin
for use by
.BR fastforward .

.B newinclude
first writes the mailing list to
.IR list\fB.tmp ,
and then moves it to
.IR list\fB.bin .
If there is any problem creating
.IR list\fB.tmp ,
.B newinclude
leaves
.I list\fB.bin
alone.

.B newinclude
always creates
.I list\fB.bin
world-readable.

.B COMPATIBILITY WARNING:
sendmail
reads
.I list
directly;
.B fastforward
needs
.IR list\fB.bin .
sendmail's strategy is a disaster if you save
.I list
to disk at the same moment that
sendmail
reads it;
the list will be truncated at a random spot,
perhaps in the middle of an address.
Furthermore, if the system crashes while you are writing
.IR list ,
.I list
could be filled with all sorts of garbage.
.SH "LIST FORMAT"
.I list
may contain any number of lines;
each line may contain any number of addresses
or further
.B :include:
files.
See
.BR newaliases (1)
for details on the address format.
Any line in
.I file
beginning with # is ignored.

.B COMPATIBILITY WARNING:
.B newinclude
does not support file or program deliveries in
.B :include:
files.
You can use the secure delivery mechanisms described in
.B dot-qmail(5)
instead.

.B COMPATIBILITY WARNING:
Versions of
sendmail
before V8 did not allow comments in
.B :include:
files.
.SH "SEE ALSO"
fastforward(1),
newaliases(1),
setmaillist(1),
dot-qmail(5)