spasm - the anti-spam milter
============================

Requirements:
- sendmail 8.12.0 or greater (with libmilter support)
- linux (or, possibly, other unices)
- Berkeley DB4 

Tested on:
sendmail 8.12.9
linux 2.4.19

Compiling spasm (bare minimum):

1. Unpack the distribution
2. Edit Makefile
   Set LIBMILTER_INCLUDE to the base location of libmilter/mfapi.h
   Set LIBMILTER_LIB to the location of libmilter.a
   Set LIBSM_LIB to the location of libsm.a
   Set LIBDB to the location of your BerkeleyDB 4 library
   Set SPASM_USER to the user as whom to run
3. Edit spasm.h
   Set SPASM_USER as in the Makefile
   Set DEFAULT_DOMAIN to your server's domain (no hostname)
   Set SENDMAIL_PATH to the location of the sendmail binary
4. Create the spasm user account
5. Create the spasm directories, chown to spasm user, chmod to 700
6. make

Installing spasm:

1. make install
2. Modify /etc/mail/sendmail.cf
   In sendmail.m4, add:

   INPUT_MAIL_FILTER(`spasm', `S=unix:/etc/mail/spasm/spasm.sock, T=C:10m;S:5m;R:5m;E:5m')
   define(`confINPUT_MAIL_FILTERS', `spasm')

   then rebuild your sendmail.cf file. You can also modify your sendmail.cf
   directly by adding:

   O InputMailFilters=spasm
   Xspasm, S=unix:/etc/mail/spasm/spasm.sock, T=C:10m;S:5m;R:5m;E:5m
3. Start spasmd by installing the spasm.init to your init.d directory and activating it, or
   start directly by, eg, "/usr/local/sbin/spasmd -p unix:/etc/mail/spasm/spasm.sock"
4. Send a HUP to sendmail (or restart)

Configuring spasm:

1. Create a textfile with local blacklist entries, if desired, according to
   the spasmdb(1) manpage, and run spasmdb to load local blacklist.
2. Read the spasm(1) manpage, then run spasm(1) to set initial filter options,
   whitelists, individual blacklists, and any spamtraps.

See manpages for spasm(1), spasmdb(1), and spasmd(1)
