file is read by
Blacklists are lists of addresses of likely spammers.
Mail from these addresses never reaches the actual mail server,
but is instead redirected to
follows the syntax of configuration databases as documented in
Here is an example:
:msg="SPAM. Your address %A is in the spews\
level 1 database\nsee http://www.spews.org/ask.cgi?x=%A\n":\
The default configuration file must include the entry
which specifies the order in which lists
are to be applied.
Lists are constructed by name:
blacklists are identified by the capability
If a list is instead given the
addresses in it will not be blacklisted.
The addresses in such a list are removed from the preceding blacklist.
In the above example,
if an address was present in all three lists,
as well as the exceptions list
the address would be removed from list
by the subsequent
However, the address would not be removed from the
To remove all the addresses in
the following configuration
would be used instead:
The source of the addresses for lists is
specified using the
specifies the method by which to retrieve a file containing a list of
addresses and may be one of
methods will make
retrieve the file from the location specified by the
method will make
spawn the program with arguments indicated in the
capability for the list, and reads a list of addresses
from the output of the program.
The format of the list of addresses is expected to consist of one
network block or address per line (optionally followed by a space and
text that is ignored).
Comment lines beginning with
Network blocks may be specified in any of the formats as in
the following example:
# CIDR format
# A start - end range
192.168.21.0 - 192.168.21.255
# As a single IP address
Each blacklist must include a message, specified in the
capability as a string.
string is enclosed in double quotes, the characters in the quoted string
are escaped as specified in
with the exception that a colon (:) is allowed in the quoted string.
The resulting string is used as the message.
Alternatively, if the
string is not specified in quotes, it is assumed to be a local filename
from which the message text may be read.
The message is configured in
to be displayed in the SMTP dialogue to any connections that match
addresses in the blacklist.
The sequence \" in the message will produce a double quote in the output.
The sequence %% will produce a single % in the output,
and the sequence %A will be expanded in the message by
to display the connecting IP address in the output.