sa-awl (1)

Leading comments

Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man1/sa-awl.1".)

NAME

sa-awl - examine and manipulate SpamAssassin's auto-whitelist db

SYNOPSIS

sa-awl [--clean] [--min n] [dbfile]

DESCRIPTION

Check or clean a SpamAssassin auto-whitelist () database file.

The name of the file is specified after any options, as "dbfile". The default is "$HOME/.spamassassin/auto-whitelist".

OPTIONS

--clean

Clean out infrequently-used

AWL

entries. The "--min" switch can be used to select the threshold at which entries are kept or deleted.

--min n

Select the threshold at which entries are kept or deleted when "--clean" is used. The default is 2, so entries that have only been seen once are deleted.

OUTPUT

The output looks like this:

     AVG  (TOTSCORE/COUNT)  --  EMAIL|ip=IPBASE

For example:

     0.0         (0.0/7)  --  dawson@example.com|ip=208.192
    21.8        (43.7/2)  --  mcdaniel_2s2000@example.com|ip=200.106

"AVG" is the average score; "TOTSCORE" is the total score of all mails seen so far; "COUNT" is the number of messages seen from that sender; "EMAIL" is the sender's email address, and "IPBASE" is the

base address.

base address is a way to identify the sender's address they frequently send from, in an approximate way, but remaining hard for spammers to spoof. The algorithm is as follows:

  - take the last Received header that contains a public IP address -- namely
    one which is not in private, unrouted IP space.

  - chop off the last two octets, assuming that the user may be in an ISP's
    dynamic address pool.