ezmlm-confirm(1) process user actions for message

SYNOPSIS

ezmlm-confirm [-cCrRvV] dir [ /path/program args ]

DESCRIPTION

ezmlm-confirm reads a mail message, expecting it to contain an -confirm or -discard action request for the mailing list stored in dir.

ezmlm-confirm verifies the cookie sent as part of the action request, and if correct attempts to find the corresponding message in dir/mod/unconfirmed/. If the message is found, it is either discarded or posted to the list, depending on the action request.

Posts to the list are handled by piping the message to ezmlm-send(1) located in the ezmlm binary directory, as set at compile time. This is usually the directory that ezmlm-moderate resides in. ezmlm-send(1) is provided with dir as the first argument.

If the optional second argument is given, ezmlm-confirm pipes the message to that program. No additional parameters are supplied.

dir is passed as an argument to ezmlm-send(1), but NOT to any program specified as the optional ezmlm-confirm command line argument.

ezmlm-confirm does not bother to correctly set sender. ezmlm-send(1) doesn't care, and any other program that might be used can parse the sender from the first line of the message, which is always Return-Path: <[email protected]> as build from SENDER originally passed to ezmlm-store(1).

Once the message has been successfully accepted or discarded, it is removed from dir/mod/unconfirmed/.

If the message is not found in dir/mod/unconfirmed/, it has timed out and the message or the message stub has been removed by ezmlm-clean(1). In this case, ezmlm-confirm notifies the sender of the failure. Notification is in the form of a fatal error from qmail.

At the beginning of the message, ezmlm-confirm prints a new Mailing-List field with the contents of the TXT_MAILING_LIST message. It rejects the message if there is already a Mailing-List field.

ezmlm-confirm does not distribute bounce messages: if the environment variable SENDER is set, and is either empty or #@[], ezmlm-confirm rejects the message.

OPTIONS

-cCrR
Passed on to ezmlm-send(1).
-v
Display ezmlm-confirm version information.
-V
Display ezmlm-confirm version information.

CHARACTER SETS

If dir/charset exists, ezmlm-confirm will use the character set listed for all messages. Otherwise, the default ``us-ascii'' will be used. The character set can be suffixed by ``:'' followed by a code. If the code is ``Q'', outgoing messages are sent as ``Quoted-Printable'', if it is ``B'' they are sent ``base64'' encoded. Otherwise, text is sent as is.