qlist(1)

NAME
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
(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. It does not look for commands in the middle of lines or in Subject lines. qlist supports two commands. SUBSCRIBE adds a new subscription to the mailing list; UNSUBSCRIBE removes a subscription. 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. 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.

EXIT CODES
0 if the request is completely successful; nonzero if anything went wrong. Exit code 111 indicates a temporary failure.

SEE ALSO
envelopes(5), qmail-alias(8), qmail-queue(8)