qlist - handle mailing list subscription requests


SYNOPSIS

       in .qmail-list-request:
       |qlist user-list@host user-list-request@host
       .qmail-list .qmail-list-request .qtemp-list
       owner [ moreinfo ]
       (all on one line)


DESCRIPTION

       qlist manages a qmail mailing list.

       When  qlist  receives a message, it looks through the body
       of the message for commands.  WARNING: qlist looks  for  a
       command only at the beginning of a line.  Exception: qlist
       also looks at Subject lines.

       qlist supports two commands.  SUBSCRIBE adds  a  new  sub-
       scription  to the mailing list; UNSUBSCRIBE removes a sub-
       scription.  qlist looks for the  subscription  address  in
       the  Reply-To, From, or Return-Path fields in the message.

       qlist inserts an acknowledgment of each  action  it  took,
       along  with  general  help instructions, into the message.
       It then forwards the message to the subscription  address,
       with a copy to owner.

       qlist's  general help instructions identify user-list@host
       as the address of the mailing list, user-list-request@host
       as  the  address of qlist itself, and owner as the address
       of the mailing list owner.  If moreinfo is supplied, it is
       inserted  into  the middle of the instructions, surrounded
       by blank lines.

       qlist maintains its address list in .qmail-list,  so  mail
       to  user-list  will  be  forwarded  to  each  subscription
       address.  While qlist is  editing  .qmail-list,  it  locks
       .qmail-list-request.   It  uses .qtemp-list as a temporary
       file.

       Note that qlist only manipulates lines beginning  with  an
       ampersand;  if  you  manually  add  an  address without an
       ampersand, it cannot be removed by qlist.

       qlist automatically sets the execute bit on qmail-list, so
       qmail-alias  will  ignore any program or file instructions
       in qmail-list.


SEE ALSO

       dot-qmail(5), envelopes(5), qmail-queue(8)