ezmlm-manage(1)

NAME
ezmlm-manage - automatically manage a mailing list

SYNOPSIS
ezmlm-manage dir

DESCRIPTION
ezmlm-manage handles administrative requests for the mailing list stored in dir. ezmlm-manage 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-manage expects LOCAL to be of the form list-action-box=domain. Here list is the first line of dir/inlocal, action is a request, and box@domain is the target of the request. ezmlm-manage sends a response to the target. It attaches the original message to the end of its response. LOCAL may instead be of the form list-action. Then the envelope sender is used as the target. ezmlm-manage expects HOST to match the first line of dir/inhost. ezmlm-manage copies dir/mailinglist into a Mailing-List field in its response. If the incoming message has a Mailing-List field, ezmlm-manage refuses to respond. ezmlm-manage also refuses to respond to bounce messages.

SUBSCRIPTIONS
If action is sc.cookie, where cookie is an appropriate code (depending on the target, the approximate time, and other factors), ezmlm-manage adds the target to the mailing list. If action is subscribe, ezmlm-manage does not subscribe the target, but it identifies the right sc.cookie address in its response. This confirmation mechanism (1) verifies that the target is reachable and (2) protects the target against forged subscription requests. Actions of uc.cookie and unsubscribe are used in the same way to delete the target from the mailing list. If dir/public does not exist, ezmlm-manage rejects all subscription and unsubscription attempts.

ARCHIVE RETRIEVALS
If action is get.num, ezmlm-manage sends back message num from dir/archive. If dir/public does not exist, ezmlm-manage rejects all archive retrieval attempts.

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