1SA-AWL(1) User Contributed Perl Documentation SA-AWL(1)
2
3
4
6 sa-awl - examine and manipulate SpamAssassin's auto-whitelist db
7
9 sa-awl [--clean] [--min n] [dbfile]
10
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
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
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.16.3 2018-10-15 SA-AWL(1)