ezmlm-moderate - process moderator actions for message
acceptance and rejection
ezmlm-moderate [-cCmMrRvV] [-t reply-to@host] dir
ezmlm-moderate reads a mail message, expecting it to con-
tain an -accept or -reject action request for the mailing
list stored in dir.
ezmlm-moderate verifies the cookie sent as part of the
action request, and if correct attempts to find the corre-
sponding message in dir/mod/pending/. If the message is
found, it is either rejected 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-moderate
pipes the message to that program, as executed by sh. No
parameters are supplied.
dir is passed as an argument to ezmlm-send(1), but NOT to
any program specified as the optional ezmlm-moderate com-
mand line argument.
ezmlm-moderate 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:
<firstname.lastname@example.org> as build from SENDER originally
passed to ezmlm-store(1).
If the message is rejected, an optional moderator comment
is copied into the notification to the message sender. A
moderator comment is any text in the -reject request found
between two lines with ``%%%'' starting in one of the
first 5 positions of the line. The easiest is to use lines
consisting of ``%%%'' only. If the characters preceeding
the ``%%%'' are found at the beginning of any lines within
the comment, the characters are removed. This is to appro-
priately ignore any ``quote marks'' that you mail program
might place at the beginning of lines in a reply.
ezmlm-moderate messages are sent ``From:'' list-
owner@listhost. This allows the poster to easily complain
to the owner of the list, in case s/he objects. An
optional ``Reply-To:'' header can be added via the
Once the message has been successfully accepted or
rejected, it is removed from dir/mod/pending/ and a stub
is created in dir/mod/accepted/ or dir/mod/rejected/,
respectively. This is done in order to be able to notify
the senders of later moderation requests about the fate of
A failure to find the message in dir/mod/pending/ is most
often caused by the message already having been accepted
or rejected by another moderator. Therefore, ezmlm-moder-
ate looks in dir/mod/accepted/ and dir/mod/rejected/ for a
message stub. If found, ezmlm-moderate notifies the sender
in the form of a fatal error if the fate of the message
was different from that intended by the current action
request. Otherwise, the fate of the message is silently
If the message is not found, it has timed out and the mes-
sage or the message stub has been removed by ezmlm-
clean(1). In this case, ezmlm-moderate notifies the mod-
erator of the failure, but can no longer discern the fate
of the original message. Again, notification is in the
form of a fatal error from qmail.
At the beginning of the message, ezmlm-moderate prints a
new Mailing-List field with the contents of dir/mail-
inglist. It rejects the message if there is already a
ezmlm-moderate does not distribute bounce messages: if the
environment variable SENDER is set, and is either empty or
#@, ezmlm-moderate rejects the message.
-cCrR Passed on to ezmlm-send(1). -m (Default.) The
rejected post is sent as a MIME enclosure.
-M The rejected post is appended to the message.
A ``Reply-To: reply-to@host'' header will be added
to the moderation request.
-v Display ezmlm-moderate version information.
-V Display ezmlm-moderate version information.
If dir/charset exists, ezmlm-moderate 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. Other-
wise, text is sent as is.
ezmlm-clean(1), ezmlm-make(1), ezmlm-send(1), ezmlmstore(1)
© 1994 Man-cgi 1.15, Panagiotis Christias <email@example.com>