SPAM Control Files for Magic SMTPD
----------------------------------

For system users, spam checking can be configured with these files located
in a directory contained in thier home directory.  The directory name
matching follows the same rules as for .qmail files, but with the prefix
.magicspam. ie:

	~/.magicspam/         - matches as ~/.qmail
	~/.magicspam-default  - matches as ~/.qmail-default
	~/.magicspam-anything - matches as ~/.qmail-anything

User spam control files will be automatically used if present, unless
the superuser has specified per user authorization and the user has
not been included in the spam_users control directory.

The following is a summary of the spam control files that are recognized
by Magic SMTPD:


Rule / Control File Name        Type
------------------------        ----
all_global_rules                BOOLEAN
block_mail_from_self            BOOLEAN
block_ip_in_addr                BOOLEAN
check_ip_reverse_dns            BOOLEAN
country_blacklist               LIST
country_whitelist               LIST
from_blacklist                  LIST
from_whitelist                  LIST
helo_blacklist                  LIST
helo_whitelist                  LIST
ip_whitelist                    LIST
ip_blacklist                    LIST
mail_from_strict_addr_parse     BOOLEAN
require_full_addr               BOOLEAN
require_helo                    BOOLEAN
smtp_check                      BOOLEAN
spam_check                      BOOLEAN
use_global_country_blacklist    BOOLEAN
use_global_helo_blacklist       BOOLEAN
use_global_helo_whitelist       BOOLEAN
use_global_from_blacklist       BOOLEAN
use_global_from_whitelist       BOOLEAN
use_global_ip_blacklist         BOOLEAN
use_global_ip_whitelist         BOOLEAN
valid_bounce                    BOOLEAN
valid_from_domain               BOOLEAN
valid_helo_domain               BOOLEAN


Rules of type boolean can have values of either 1 or 0.  To set these you
would do something like "echo 1 > ~/.magicspam/spam_check"  to enable
spam_checking.  Rules which are of type list should contain a newline separated
list of values.  

For more information about what each of these rules do, and to see their
dependancies, please see the comments in the spam_rules.in file.  Keep in mind
that only the spam rules listed above have been implimented.  There are rules
in the spam_rules.in file which have not yet been implimented.

