replier-config(1)

NAME

replier-config - configure an instance of replier

SYNOPSIS

    replier-config _dir_ _dot_ _local_ _host_ [ _outlocal_ [ _outhost_ ]]

DESCRIPTION

The replier-config program configures an instance of replier ⟨replier.html⟩, the qtools auto-responder. It creates _dir_ and populates it with configuration files. It creates two qmail files called _dot_ -help and _dot_ -return-default. The _local_, _host_ arguments together determine the local delivery address configured for auto-response. The _outlocal_, _outhost_ arguments are used in the responses.

The directory _dir_ must begin with a slash. If _outlocal_ is not present, replier-config sets it to _local_. If _outhost_ is not present, replier-config sets it to _host_.

If _outlocal_ is not empty, replier-config creates a new email replier at the address

    _outlocal_ -help@ _outhost_

If _outlocal_ is empty, replier-config creates a new email replier at the address

    help@ _outhost_

In either case, replier-config sets up two .qmail files to control the help-address replier: _dot_ -help and _dot_ -return-default. These files should control messages to the addresses _outlocal_ -help@ _outhost_ and _outlocal_ -return-@ _outhost_, respectively (or help@ _outhost_ and return-@ _outhost_ if _outlocal_ is empty).

Within _dir_, replier-config creates several configuration files for replier.

The first line of _dir_ /inlocal consists of _local_.

The first line of _dir_ /inhost consists of _host_.

The first line of _dir_ /outlocal consists of _outlocal_.

The first line of _dir_ /outhost consists of _outhost_.

The first line of _dir_ /mailinglist consists of contact _helpaddress_ ; run by replier, where _helpaddress_ is the help address created by replier-config as described above.

The _dir_ /headerremove file contains

    return-path
    return-receipt-to
    content-length

The _dir_ /headeradd file contains

    Precedence: bulk

The _dir_ /text/help file contains text sent in response to messages received at the help address.

EXAMPLES

To configure a replier at the address joe-replier-help@example.com, the user joe issues the command

    replier-config $HOME/replier $HOME/.qmail-replier joe-replier example.com

If email to joe@example.com is delivered to joe@joehost.example.com, the following command may be appropriate to configure a replier at joe-replier- help@example.com:

    replier-config $HOME/replier $HOME/.qmail-replier joe-replier joehost.example.com joe-replier example.com

If the user replier handles mail for the virtual domain replier.example.com, then the following command creates a replier at help@replier.example.com:

    replier-config $HOME/replier $HOME/.qmail replier example.com ""

  Adding replier addresses

To add a new replier address that filters only the body of a message, edit the _dir_ /bodyfilter shell script and add a new case corresponding to the new address. Then create a symbolic link from _dir_ /qmail-bodyfilter to the .qmail file that controls the new address. That's it!

Adding a command to filter the message header is entirely analagous, but use _dir_ /headerfilter and _dir_ /qmail-headerfilter, while entire-message filters use _dir_ /msgfilter and _dir_ /qmail-msgfilter.

  Bounce handling

By default, a replier created with replier-config silently throws away bounce messages. The .qmail file controlling bounces is a symbolic link pointing to _dir_ /bouncer. Edit _dir_ /bouncer to change the treatment of bounce messages.

BUGS

The very existence of this program is a bug.

AUTHOR

William Baxter <sst@superscript.com>

Version 0.56
Last updated 2015-08-23 23:24:43 CDT