| 1 | .TH ezmlm-return 1 |
| 2 | .SH NAME |
| 3 | ezmlm-return \- handle mailing list bounces |
| 4 | .SH SYNOPSIS |
| 5 | .B ezmlm-return |
| 6 | [ |
| 7 | .B \-dD |
| 8 | ] |
| 9 | .I dir |
| 10 | .SH DESCRIPTION |
| 11 | .B ezmlm-return |
| 12 | handles bounces for the mailing list |
| 13 | stored in |
| 14 | .I dir |
| 15 | and, if it exists, the associated digest list. |
| 16 | |
| 17 | .B ezmlm-return |
| 18 | is normally invoked from a |
| 19 | .B .qmail |
| 20 | file. |
| 21 | It reads a mail message from its standard input, |
| 22 | and a mail envelope from the |
| 23 | .BR SENDER , |
| 24 | .BR LOCAL , |
| 25 | and |
| 26 | .BR HOST |
| 27 | environment variables. |
| 28 | |
| 29 | .B ezmlm-return |
| 30 | exits 99, not 0, upon success. |
| 31 | .SH OPTIONS |
| 32 | .TP |
| 33 | .B \-d |
| 34 | .B ezmlm-return |
| 35 | will assume the bounce is for a digest list. |
| 36 | Normally, |
| 37 | .B ezmlm-return |
| 38 | will autodetect this from the bounce address. Autodetection makes |
| 39 | .B ezmlm-return |
| 40 | less flexible and will be removed in future versions. |
| 41 | .TP |
| 42 | .B \-D |
| 43 | .B ezmlm-return |
| 44 | will assume that the bounce is for a normal (non-digest) list. |
| 45 | Normally, |
| 46 | .B ezmlm-return |
| 47 | will autodetect this from the bounce address. Autodetection makes |
| 48 | .B ezmlm-return |
| 49 | less flexible and will be removed in future versions. |
| 50 | .B \-D |
| 51 | will become the default. |
| 52 | .SH ADDRESSES |
| 53 | .B ezmlm-return |
| 54 | handles mail sent to any of the following addresses: |
| 55 | .TP |
| 56 | .I local\fB\-return\- |
| 57 | Trash. |
| 58 | A help message or subscription acknowledgment bounced. |
| 59 | .TP |
| 60 | .I local\fB\-return\-\fImsg\fB\-\fIbox\fB=\fIdomain |
| 61 | Distribution bounce. |
| 62 | Message number |
| 63 | .I msg |
| 64 | was lost on the way to |
| 65 | .IR box\fB@\fIdomain . |
| 66 | .TP |
| 67 | .I local\fB\-return\-\fImsg\fB\- |
| 68 | Pre-VERP distribution bounce, in QSBMF format. |
| 69 | Message number |
| 70 | .I msg |
| 71 | was lost on the way to one or more addresses; |
| 72 | .B ezmlm-return |
| 73 | will parse the bounce to figure out the addresses. |
| 74 | .TP |
| 75 | .I local\fB\-return\-warn\-\fIcookie\fB-\fIbox\fB=\fIdomain |
| 76 | Warning bounce. |
| 77 | A warning message from |
| 78 | .B ezmlm-warn |
| 79 | bounced. |
| 80 | .TP |
| 81 | .I local\fB\-return\-probe\-\fIcookie\fB-\fIbox\fB=\fIdomain |
| 82 | Probe bounce. |
| 83 | A probe from |
| 84 | .B ezmlm-warn |
| 85 | bounced. |
| 86 | .B ezmlm-return |
| 87 | will remove |
| 88 | .I box\fB@\fIdomain |
| 89 | from the mailing list. |
| 90 | .TP |
| 91 | .I local\fB\-return\-receipt\-\fIcookie\-fImsg\- |
| 92 | A receipt from the list. This is logged. For SQL supporting lists, |
| 93 | .I cookie |
| 94 | is verified and receipt logged only if the cookie is correct. The arrival |
| 95 | of the receipt shows that qmail at the sending host is running. |
| 96 | |
| 97 | For all the above addresses if, |
| 98 | .I local |
| 99 | is followed by |
| 100 | .IR \-digest , |
| 101 | bounces are assumed to be from the digest list, and are stored in |
| 102 | .I dir\fB/digest/bounce |
| 103 | rather than in |
| 104 | .I dir \fB/bounce . |
| 105 | .SH "SEE ALSO" |
| 106 | ezmlm-manage(1), |
| 107 | ezmlm-make(1), |
| 108 | ezmlm-send(1), |
| 109 | ezmlm-sub(1), |
| 110 | ezmlm-unsub(1), |
| 111 | ezmlm-warn(1), |
| 112 | ezmlm-weed(1), |
| 113 | ezmlm(5), |
| 114 | qmail-command(8) |