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

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

Tested on:
sendmail 8.12.1
sendmail 8.12.5
linux 2.4.16
linux 2.4.18-ac3


Compiling spasm (bare minimum):

1. Unpack the distribution
2. Edit Makefile
   Set SENDMAILDIR to your sendmail source directory
   Set SENDMAILOBJDIR to the obj.* directory under the sendmail directory
   Set SPASM_USER to the user as whom to run
3. Edit spasm.h
   Set SPASM_USER as in the Makefile
   Set syslog facility
   Set directories and db filenames to taste
4. Create the spasm user account
5. Create the spasm directories, chown to spasm user
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. /usr/local/sbin/spasm -p unix:/etc/mail/spasm/spasm.sock (or use spasm.init)
4. Send a HUP to sendmail (or restart)


Configuring spasm:

See manpages for spasmbl(1), spasmwl(1), spasmdb(1), and spasmtrap(1).
