BLACKMAIL(3) blackmail 0.29 BLACKMAIL(3)
Antispam Mailer Proxy Antispam Mailer Proxy
5 Oct 1998
NAME
blackmail - Antispam Mailer Proxy
SYNOPSIS
blackmail [ -c | -h | -t ]
-c runs blackmail in command line mode, testing the program and letting
you interact with the server without having to telnet to the mail port.
-h requests help.
-t makes BlackMail report back what it believes your local hostname and
domain names are. Use this for testing to see if LOCHOST is required.
-o reports what Makefile options BlackMail was built with.
DESCRIPTION
BLACKMAIL is an Anti-spam mailer proxy that wraps around your existing
mailer, adding security from allowing users to get lists of users on
your system, using your site as a mail forwarding agent and allows
customisable system level spam blocking.
CONFIGURING
In order to configure BlackMail, you must edit the /etc/blackmail.conf
file. This file contains a listing of all the matching rulesets that
each process of BlackMail receives. Some basic configuration is still
performed at build time using the Makefile.
The INTERNAL section defines a few critical site-dependant items. The
format is typically as follows
MAILFILE:/usr/sbin/rsmtp -bs
SMTP_TIMEOUT:300
i.e. a keyword, a colon and then the the definition. MAILFILE is
mandatory and defines the mailer program the Blackmail will call. As
above for smail or /usr/lib/sendmail -bs for sendmail. SMTP_TIMEOUT
is mandatory, only change the value if you know why. LOCHOST is an
optional item used to define your local fully qualified hostname if
your system doesn't report it correctly. Test with blackmail -t and
only use LOCHOST if that fails. If the IGNORE_OUTBOUND keyword is
present then no checks will be made on any mail sent from a
'localhost'. Only use if you trust everyone locally. ALLOW_VRFY is
optional and enables (remote) sites to use the SMTP VRFY command on
your system. By default Blackmail disables it.
HEADERS describe the list of headers that are filtered and used to
reject incoming mail. Any headers you include in this section will be
checked for in each mail message that comes in. If any headers match
those listed in this section, the mail is rejected with a bogus error.
Be especially careful when using substrings that you do not reject
- 1 - Formatted: April 20, 2024
BLACKMAIL(3) blackmail 0.29 BLACKMAIL(3)
Antispam Mailer Proxy Antispam Mailer Proxy
5 Oct 1998
normal email e.g. '*sex*' will of course match and reject 'sexist'
etc. in the Subject line as well.
The TREAT_AS_LOCALHOST section describes which sites are treated as a
local system upon connection. These sites must be numeric IP. (This
is checked at connection time and used for the anti-relaying check.)
The ALLOWED_MAIL_SITES section describes which (local) addresses your
mailer will accept mail for. If you have multiple domains or aliases,
you should put the names of the aliases in this list. e.g.
*mydomain1.com
*mydomain2.ac.uk
The REJECTED_ADDRESSES section lists those sites that are not allowed
to send your mail site any E-Mail.
e.g. *known.spamsite.com*
When Blackmail senses a site connection from any sites matching this
list, BlackMail will immediately close the connection with a bogus
error message.
The TLD section used to list valid top-level domains. These are now
in the source as they should not need modification, being conformant
to ISO-3166. It is possible to add extra TLDs in this section should
the need arise.
BUGS
There is a hard limit of 1000 spamsites, 1000 headers, 1000 top-level
domains, 1000 localhost entries, and 1000 mail aliases allowed. This
may change once the linked list library is included. This limit is set
in the source code with the MAX_LINES definition.
PLANS
See "TODO" in the distribution.
CONTACTING
Please write to the maintainer James Murray <jsm@jsm-net.demon.co.uk>
SEE ALSO
mail(1), smail(3), majordomo(8).
If you have installed Blackmail you should hopefully have read the
documents that came with the source e.g. README, INSTALL, FAQ and the
Makefile. Also see
http://www.bitgate.com/spam/ and
- 2 - Formatted: April 20, 2024
BLACKMAIL(3) blackmail 0.29 BLACKMAIL(3)
Antispam Mailer Proxy Antispam Mailer Proxy
5 Oct 1998
http://www.jsm-net.demon.co.uk/blackmail/blackmail.html
for more information regarding internet Spam and BlackMail updates.
- 3 - Formatted: April 20, 2024
