ezmlm-reject(1)                                                ezmlm-reject(1)



NNAAMMEE
       ezmlm-reject - reject messages unsuitable for distribution

SSYYNNOOPPSSIISS
       eezzmmllmm--rreejjeecctt [ --bbBBccCChhHHqqQQssSSttTT ][ _d_i_r ]

DDEESSCCRRIIPPTTIIOONN
       eezzmmllmm--rreejjeecctt  reads a mail message from its standard input.  It rejects
       the message if it sees something it doesn’t like.

       If the message has a ‘‘Precedence: junk’’ header, eezzmmllmm--rreejjeecctt exits 99
       causing  the  message  to  be  ignored. This causes replies from (some)
       vacation programs to be ignored.

       If _d_i_r is specified, eezzmmllmm--rreejjeecctt reads _d_i_r//mmssggssiizzee for a maximum:mini-
       mum  message  body size in bytes. Either number will be ignored if 0 or
       omitted.  eezzmmllmm--rreejjeecctt will also look for _d_i_r//mmiimmeerreejjeecctt and _d_i_r//mmiimmeerr--
       eemmoovvee.   if _d_i_r//mmiimmeerreejjeecctt exists, Messages of the Content-Types speci-
       fied or with MIME parts of these types will be rejected.  If _d_i_r//mmiimmeerr--
       eemmoovvee  exists,  eezzmmllmm--rreejjeecctt  will reject messages of the Content-Types
       specified. These content-types will be accepted as parts of a composite
       MIME message. They will be stripped out later by eezzmmllmm--sseenndd((11)).

       eezzmmllmm--rreejjeecctt  will  exit  100  (permanent error) for rejections. If the
       list address is not in the message ‘‘To:’’ or ‘‘Cc:’’ headers  and  the
       --tt  switch  is  active, the exit code is 100 or 99, depending on the --qq
       switch (see below).  If you would like to forward messages  instead  of
       rejecting them, you can into the appropriate .qmail file put:

            |condredirect newaddress except /path/ezmlm-reject DIR

       Now  rejected posts will go to this address, and the recipient can take
       appropriate action.

OOPPTTIIOONNSS
       --bb     Reject the message if the message body starts  ‘‘subscribe’’  or
              ‘‘unsubscribe’’.  If  the  --cc switch is specified, messages will
              also be rejected if the subject starts  with  these  words.   --BB
              (Default.)   Do  not  reject  messages starting ‘‘subscribe’’ or
              ‘‘unsubscribe’’.

       --cc     (Default.)  Commands are not permitted in the Subject  line.   A
              Subject  line  consisting  solely of HELP, REMOVE, SUBSCRIBE, or
              UNSUBSCRIBE is rejected.

       --CC     Commands are permitted in the subject line.

       --hh     Reject message if any of the headers in  _d_i_r//hheeaaddeerrrreejjeecctt  occur
              in  the  header. Mailing-List headers of other mailing list man-
              agers can be put into this file, one per line, to  prevent  pro-
              cessing of messages from other mailing lists.  _d_i_r must be spec-
              ified.

              A reasonable set of headers would be: ‘‘Mailing-List’’,  ‘‘X-ml-
              name’’,  `‘ml-name’’,‘‘X-loop’’,‘‘X-listprocessor-version’’,‘‘X-
              mailing-list’’. Case is not important.

       --HH     (Default.)  Ignore _d_i_r//hheeaaddeerrrreejjeecctt.  --qq Quiet. If  the  message
              due  to  the  lack of the list address (see --tt) is not accepted,
              this is logged but no error message is sent to the sender.

       --qq     Quiet. If a message due to the lack of the list address (see --tt)
              is not accepted, the message is silently ignored.

       --QQ     (Default.)   Not quiet. If a message due to the lack of the list
              address (see --tt) is not accepted, the sender is notified  by  an
              error message.

       --ss     (Default.)  A nonempty Subject line is required.

       --SS     A Subject line is not required.

       --tt     (Default.)  Reject messages that do not have the list address in
              the ‘‘To:’’ or ‘‘Cc:’’ header(s).  eezzmmllmm--rreejjeecctt needs access  to
              _d_i_r//oouutthhoosstt  and  _d_i_r//oouuttllooccaall  to  check  this.  This  check is
              silently omitted if _d_i_r is not specified,  to  assure  backwards
              compatibility with existing ezmlm lists.

       --TT     Do  not  require  the  list  address  in  the ‘‘To:’’ or ‘‘Cc:’’
              header(s).

BBUUGGSS
       eezzmmllmm--rreejjeecctt does not handle rfc822 comments in ‘‘Content-Type:’’ lines
       if  present  before the type or boundary.  This could be used to defeat
       the MIME rejection function.  OTOH, this function is intended to reduce
       garbage, not guarantee its elimination.

SSEEEE AALLSSOO
       ezmlm-send(1), qmail-command(8)



                                                               ezmlm-reject(1)