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

NAME
       ezmlm-reject - reject messages unsuitable for distribution

SYNOPSIS
       ezmlm-reject [ -cChHqQsStT ][ dir ]

DESCRIPTION
       ezmlm-reject reads a mail message from its standard input.
       It  rejects  the  message  if it sees something it doesn't
       like.

       If dir is specified, ezmlm-reject reads dir/msgsize for  a
       maximum:minimum  message body size in bytes. Either number
       will be ignored if 0 or omitted.  ezmlm-reject  will  also
       look    for   dir/mimereject   and   dir/mimeremove.    if
       dir/mimereject exists, Messages of the Content-Types spec-
       ified  or with MIME parts of these types will be rejected.
       If dir/mimeremove exists, ezmlm-reject  will  reject  mes-
       sages  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 ezmlm-send(1).

       ezmlm-reject  will  exit  100 (permanent error) for rejec-
       tions. If the list address is not in the  message  ``To:''
       or  ``Cc:''  headers and the -t switch is active, the exit
       code is 100 or 99, depending on the -q switch (see below).
       If you would like to forward messages instead of rejecting
       them, you can add ``||  exit  100''  to  the  ezmlm-reject
       line.  Before  that  line,  add  an  address,  pointing to
       another .qmail file,  e.g.  ``list-rej@host''.  Into  that
       file, put (all on one line):

            |{ /path/ezmlm-reject DIR && exit 99 ; } ; exit 0

       Followed  by  the  address  of  e.g.  the  list owner. Now
       rejected posts will go to this address, and the list owner
       can take appropriate action.

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

       -C     Commands are permitted in the subject line.

       -h     Reject message if any of the headers in dir/header-
              reject occur in the header. Mailing-List headers of
              other mailing list managers can be  put  into  this
              file,  one  per line, to prevent processing of mes-
              sages from other mailing lists.  dir must be speci-
              fied.

              A  reasonable  set  of headers would be: ``Mailing-

                                                                1

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

              List'', ``X-ml-name'',  ``ml-name'',``X-loop'',``X-
              listprocessor-version'',``X-mailing-list''. Case is
              not important.

       -H     (Default.)  Ignore dir/headerreject.  -q Quiet.  If
              the  message  due  to  the lack of the list address
              (see -t) is not accepted, this  is  logged  but  no
              error message is sent to the sender.

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

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

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

       -S     A Subject line is not required.

       -t     (Default.)   Reject  messages  that do not have the
              list address in the ``To:'' or  ``Cc:''  header(s).
              ezmlm-reject   needs   access  to  dir/outhost  and
              dir/outlocal to check this. This check is  silently
              omitted  if  dir  is not specified, to assure back-
              wards compatibility with existing ezmlm lists.

       -T     Do not require the list address in the  ``To:''  or
              ``Cc:'' header(s).

BUGS
       ezmlm-reject 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.

SEE ALSO
       ezmlm-send(1), qmail-command(8)

                                                                2