3f849893d80675d13eec97db3be2f8c6e0f7fd3e
[ezmlm] / ezmlm-return.1
1 .TH ezmlm-return 1
2 .SH NAME
3 ezmlm-return \- handle mailing list bounces
4 .SH SYNOPSIS
5 .B ezmlm-return
6 .I dir
7 .SH DESCRIPTION
8 .B ezmlm-return
9 handles bounces for the mailing list
10 stored in
11 .IR dir .
12
13 .B ezmlm-return
14 is normally invoked from a
15 .B .qmail
16 file.
17 It reads a mail message from its standard input,
18 and a mail envelope from the
19 .BR SENDER ,
20 .BR LOCAL ,
21 and
22 .BR HOST
23 environment variables.
24 .SH ADDRESSES
25 .B ezmlm-return
26 handles mail sent to any of the following addresses:
27 .TP
28 .I local\fB\-return\-
29 Trash.
30 A help message or subscription acknowledgment bounced.
31 .TP
32 .I local\fB\-return\-\fImsg\fB\-\fIbox\fB=\fIdomain
33 Distribution bounce.
34 Message number
35 .I msg
36 was lost on the way to
37 .IR box\fB@\fIdomain .
38 .TP
39 .I local\fB\-return\-\fImsg\fB\-
40 Pre-VERP distribution bounce, in QSBMF format.
41 Message number
42 .I msg
43 was lost on the way to one or more addresses;
44 .B ezmlm-return
45 will parse the bounce to figure out the addresses.
46 .TP
47 .I local\fB\-return\-warn\-\fIcookie\fB-\fIbox\fB=\fIdomain
48 Warning bounce.
49 A warning message from
50 .B ezmlm-warn
51 bounced.
52 .TP
53 .I local\fB\-return\-probe\-\fIcookie\fB-\fIbox\fB=\fIdomain
54 Probe bounce.
55 A probe from
56 .B ezmlm-warn
57 bounced.
58 .B ezmlm-return
59 will remove
60 .I box\fB@\fIdomain
61 from the mailing list.
62 .SH "SEE ALSO"
63 ezmlm-manage(1),
64 ezmlm-make(1),
65 ezmlm-send(1),
66 ezmlm-sub(1),
67 ezmlm-unsub(1),
68 ezmlm-warn(1),
69 ezmlm-weed(1),
70 ezmlm(5),
71 qmail-command(8)