[fastforward] / newinclude.1

.TH 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)
Commit	Line	Data
8d5530c4 MW	1	.TH newinclude 1
	2	.SH NAME
	3	newinclude \- create a binary mailing list from an :include: file
	4	.SH SYNOPSIS
	5	.B newinclude
	6	.I list
	7	.SH DESCRIPTION
	8	.B newinclude
	9	reads a
	10	sendmail-style
	11	.B :include:
	12	file,
	13	.IR list ,
	14	and converts it into a binary format in
	15	.I list\fB.bin
	16	for use by
	17	.BR fastforward .
	18
	19	.B newinclude
	20	first writes the mailing list to
	21	.IR list\fB.tmp ,
	22	and then moves it to
	23	.IR list\fB.bin .
	24	If there is any problem creating
	25	.IR list\fB.tmp ,
	26	.B newinclude
	27	leaves
	28	.I list\fB.bin
	29	alone.
	30
	31	.B newinclude
	32	always creates
	33	.I list\fB.bin
	34	world-readable.
	35
	36	.B COMPATIBILITY WARNING:
	37	sendmail
	38	reads
	39	.I list
	40	directly;
	41	.B fastforward
	42	needs
	43	.IR list\fB.bin .
	44	sendmail's strategy is a disaster if you save
	45	.I list
	46	to disk at the same moment that
	47	sendmail
	48	reads it;
	49	the list will be truncated at a random spot,
	50	perhaps in the middle of an address.
	51	Furthermore, if the system crashes while you are writing
	52	.IR list ,
	53	.I list
	54	could be filled with all sorts of garbage.
	55	.SH "LIST FORMAT"
	56	.I list
	57	may contain any number of lines;
	58	each line may contain any number of addresses
	59	or further
	60	.B :include:
	61	files.
	62	See
	63	.BR newaliases (1)
	64	for details on the address format.
65	Any line in
66	.I file
67	beginning with # is ignored.
68
69	.B COMPATIBILITY WARNING:
70	.B newinclude
71	does not support file or program deliveries in
72	.B :include:
73	files.
74	You can use the secure delivery mechanisms described in
75	.B dot-qmail(5)
76	instead.
77
78	.B COMPATIBILITY WARNING:
79	Versions of
80	sendmail
81	before V8 did not allow comments in
82	.B :include:
83	files.
84	.SH "SEE ALSO"
85	fastforward(1),
86	newaliases(1),
87	setmaillist(1),
88	dot-qmail(5)