SuperScript::Software::qtools

The replier-config Program

Interface

  replier-config dir dot local host [ outlocal [ outhost ]]
where dir is a directory, dot is a .qmail file, local is the local portion of an email address, and host is a host name, outlocal is either the local portion of an email address or the empty string, and outhost is a host name. 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.

Typical usage

To configure a replier at the address joe-replier-help@example.com, the user joe issues the command 
  replier-config  /replier  /.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  /replier  /.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  /replier  /.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.