Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ezmlm-moderate(1)	    General Commands Manual	     ezmlm-moderate(1)

NAME
       ezmlm-moderate  -  process moderator actions for	message	acceptance and
       rejection

SYNOPSIS
       ezmlm-moderate [-cCmMrRvV] [-t reply-to@host] dir [ /path/program  args
       ... ]

DESCRIPTION
       ezmlm-moderate reads a mail message, expecting it to contain 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  corresponding	  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 mes-
       sage 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-moderate	command	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:
       <address@host.domain>  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  appropriately  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
       -r reply-to@host.

       Once  the message has been successfully accepted	or rejected, it	is re-
       moved 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
       the message.

       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 mod-
       erator.	Therefore,  ezmlm-moderate  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 logged.

       If the message is not found, it has timed out and the  message  or  the
       message	stub has been removed by ezmlm-clean(1).  In this case,	ezmlm-
       moderate	notifies the moderator of the failure, but can no longer  dis-
       cern  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 the TXT_MAILING_LIST message.	It re-
       jects the message if there is already a Mailing-List field.

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

       If  dir/qmqpservers  exists,  ezmlm-moderate  will use qmail-qmqp(1) to
       send messages.

OPTIONS
       -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.

       -t reply-to@host
	      A	``Reply-To: reply-to@host'' header will	be added to the	moder-
	      ation request.

       -v     Display ezmlm-moderate version information.

       -V     Display ezmlm-moderate version information.

CHARACTER SETS
       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.	Otherwise, text	is sent	as is.

SEE ALSO
       ezmlm-clean(1), ezmlm-make(1), ezmlm-send(1), ezmlm-store(1), ezmlm(5)

							     ezmlm-moderate(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ezmlm-moderate&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help