sa-awl - Man Page

examine and manipulate SpamAssassin's auto-welcomelist db


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


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

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



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.


The output looks like this:


For example:

     0.0         (0.0/7)  --|ip=208.192
    21.8        (43.7/2)  --|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 AWL base IP address.

AWL base IP address is a way to identify the sender's IP 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.


2024-01-27 perl v5.38.2 User Contributed Perl Documentation