ezmlm-receipt(1)                                 ezmlm-receipt(1)

NAME
       ezmlm-receipt - handle sublist replies at the main list

SYNOPSIS
       ezmlm-receipt [ -dD ] dir

DESCRIPTION
       ezmlm-receipt  handles mail from sublists of the main list
       stored in dir and,  if  it  exists,  the  associated  main
       digest  list.   ezmlm-receipt  is  used for main list with
       only sublists as subscribers. It is not useful for  normal
       mailing lists.

       ezmlm-receipt  is normally invoked from a .qmail file.  It
       reads a mail message from its standard input, and  a  mail
       envelope  from  the  SENDER,  LOCAL,  and HOST environment
       variables.

       ezmlm-receipt has two functions. It  takes  the  place  of
       ezmlm-receipt(1) for main lists that have only sublists as
       subscribers.  Bounces do not lead to removal of the bounc-
       ing address.  emzlm-receipt saves the bounce, and logs the
       event to the  mail  log.   ezmlm-receipt  also  saves  the
       bounce  to  dir/bounce/dnnn.ppp  where nnn is a time stamp
       and ppp the PID of the process. A maximum  of  50  bounces
       are  saved.  Further  bounces  are discarded until room is
       made in the bounce directory by manually  removing  files.
       If  the  list uses and SQL database, the even is logged to
       the _mlog table instead,  and  only  if  the  distribution
       cookie  matches. The bounce is still saved, but only if it
       contained a matching distribution cookie.

       ezmlm-receipt also handles feedback messages from the sub-
       list.  These  are used to monitor that the sublist is able
       to send out messages.  Receipt  of  feedback  messages  is
       logged  to  the  mail  log.   If  the  list  uses  and SQL
       database, the even is logged to the _mlog  table  instead,
       and only if the distribution cookie matches.

OPTIONS
       -d     ezmlm-receipt  will  assume  the  message  is for a
              digest list.  Normally, ezmlm-receipt will  autode-
              tect  this  from  the bounce address. Autodetection
              makes  ezmlm-receipt  less  flexible  and  will  be
              removed in future versions.

       -D     ezmlm-receipt  will assume that the bounce is for a
              normal (non-digest) list.  Normally,  ezmlm-receipt
              will  autodetect  this  from  the  bounce  address.
              Autodetection makes ezmlm-receipt less flexible and
              will be removed in future versions.  -D will become
              the default.

                                                                1

ezmlm-receipt(1)                                 ezmlm-receipt(1)

ADDRESSES
       ezmlm-receipt handles mail sent to any  of  the  following
       addresses:

       local-return-
              Trash.   A help message or subscription acknowledg-
              ment bounced.

       local-return-msg-box=domain
              Distribution bounce.  Message number msg  was  lost
              on the way to the sublist box@domain.

       local-return-msg-
              Pre-VERP  distribution  bounce,  in  QSBMF  format.
              Message number msg was lost on the way  to  one  or
              more  sublists; ezmlm-receipt will parse the bounce
              to figure out the addresses.

       local-return-receipt
              Feedback message  from  a  sublist.   ezmlm-receipt
              will  figure out message number and sublist address
              from the envelope sender.

              For all the above addresses if, local  is  followed
              by  -digest,  messages are assumed to relate to the
              digest list, and are  stored  in  dir/digest/bounce
              rather than in dir /bounce .

SEE ALSO
       ezmlm-manage(1),  ezmlm-make(1),  ezmlm-return(1),  ezmlmsend(1)
       ,  ezmlm-sub(1),   ezmlm-unsub(1),   ezmlm-weed(1),
       ezmlm(5), qmail-command(8)

                                                                2