Mail::S...hitelist(3)

💅 NAME

Okay so bestie, this is Mail::SpamAssassin::AutoWhitelist — the auto-whitelist handler for SpamAssassin. That's it, that's the whole name. (And yes, the page title up top is literally rendered as Mail::S...hitelist(3) — the manual system truncated it, not me, don't come for me 🫶)

---

✨ SYNOPSIS ✨

  (see Mail::SpamAssassin)

That's the whole vibe, she's not giving us anything else here. Go read the other page, iykyk.

---

🦋 DESCRIPTION 🦋

So Mail::SpamAssassin is a module that identifies spam using text analysis and several internet-based realtime blacklists. Iconic behavior, truly.

This class is used internally by SpamAssassin to handle the automatic whitelisting functionality. So like — it's the behind-the-scenes main character, not the one on stage 💅 If you're looking for the public interfaces, please refer to the Mail::SpamAssassin documentation. This one's a backstage pass, not a front-row ticket.

---

🎀 METHODS 🎀

🌸 $meanscore = awl->check_address($addr, $originating_ip, $signedby);

This method returns the mean score of all the messages associated with the given address. If the address hasn't been seen before, you get undef back — no history, no data, ghosted 😭

If $originating_ip is supplied, it gets used in the lookup. Simple as that.

🧚 awl->count();

Returns the count of messages that were used in determining the whitelist correction. It's giving receipts 📊

🔥 awl->add_score($score);

This one adds half the score to the current entry. And why only half, you ask? Because using half the score means that repeated use of the same From and IP address combination will gradually reduce the score. Slow burn, on purpose, periodt.

👑 awl->add_known_good_address($addr);

Adds a score of -100 to the given address — effectively "bootstrapping" that address as one that should be whitelisted. Instant good-vibes certification ✨

💀 awl->add_known_bad_address($addr);

Adds a score of 100 to the given address — effectively "bootstrapping" that address as one that should be blacklisted. Blocked, reported, unfollowed 🙈

---

Heads up bestie: these are internal methods. If you're reaching for a public interface, that's Mail::SpamAssassin's whole thing, not this page. 🫶

---

That's the whole page, fr fr. This little beauty is perl v5.32.1, dated 2024-07-12, and it goes out as Mail::S...hitelist(3) — truncated name and all, but honestly she ate anyway 💖 ✨ 🎀