This is free software.  See the file COPYING for copying permission.

The file INSTALL contains copies of the installation information
as plain text.

Usage:

   qmail-listfile <[-]listfile> <program> [ args ]

The program will read <listfile>, which should be a list of regex(7)-
style Regular Expressions, with one expression per line.  If the
SENDER env-var matches any of the lines, then <program> is run with
the specified [args].  If the <listfile> name is prepended with a dash
'-', then the inverse is done: that is, <program> is run if the SENDER
is NOT found in the file.

Example:

In your .qmail file, you can use this utility to blacklist or whitelist
certain addresses, and optionally run bogofilter for non-whitelist addrs:

.qmail for user 'mattro':

   |qmail-listfile /etc/mail/blacklist bouncesaying 'Invalid sender address or sender rejected by user'
   |qmail-listfile -/etc/mail/whitelist condredirect mattro-spam bogofilter
   |qmail-listfile -/etc/mail/whitelist condredirect mattro-spam except spamc -c
   ./Maildir/

.qmail-spam (premade maildir subfolder called 'Blocked Messages'):

   ./Maildir/.Blocked Messages/

This is how I use it.  The 'Blocked Messages' folder is an IMAP subfolder,
where SpamAssassin and/or bogofilter put suspect SPAM.

Matt Roberts
March 2003
