1SA-AWL(1)             User Contributed Perl Documentation            SA-AWL(1)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

12       Check or clean a SpamAssassin auto-whitelist (AWL) database file.
13
14       The name of the file is specified after any options, as "dbfile".  The
15       default is "$HOME/.spamassassin/auto-whitelist".
16

OPTIONS

18       --clean
19           Clean out infrequently-used AWL entries.  The "--min" switch can be
20           used to select the threshold at which entries are kept or deleted.
21
22       --min n
23           Select the threshold at which entries are kept or deleted when
24           "--clean" is used.  The default is 2, so entries that have only
25           been seen once are deleted.
26

OUTPUT

28       The output looks like this:
29
30            AVG  (TOTSCORE/COUNT)  --  EMAIL|ip=IPBASE
31
32       For example:
33
34            0.0         (0.0/7)  --  dawson@example.com|ip=208.192
35           21.8        (43.7/2)  --  mcdaniel_2s2000@example.com|ip=200.106
36
37       "AVG" is the average score;  "TOTSCORE" is the total score of all mails
38       seen so far;  "COUNT" is the number of messages seen from that sender;
39       "EMAIL" is the sender's email address, and "IPBASE" is the AWL base IP
40       address.
41
42       AWL base IP address is a way to identify the sender's IP address they
43       frequently send from, in an approximate way, but remaining hard for
44       spammers to spoof.  The algorithm is as follows:
45
46         - take the last Received header that contains a public IP address -- namely
47           one which is not in private, unrouted IP space.
48
49         - chop off the last two octets, assuming that the user may be in an ISP's
50           dynamic address pool.
51
52
53
54perl v5.32.1                      2021-03-25                         SA-AWL(1)
Impressum