Mail::...omelist(3pm)

💖 NAME 💖

Mail::...omelist(3pm) — ok so the full name of this thing is Mail::SpamAssassin::AutoWelcomelist, and bestie, it's the auto-welcomelist handler for SpamAssassin. That's it, that's the whole vibe. ✨

---

🦋 SYNOPSIS 🦋

Lowkey there's no big flashy synopsis here, it's just:

(see Mail::SpamAssassin)

so like, go read that one if you want the whole picture, okay? 🫶

---

🌸 DESCRIPTION 🌸

So first things first: Mail::SpamAssassin is a module that identifies spam using text analysis and several internet-based realtime blocklists. Iconic behavior honestly. 👑

Now, this class — Mail::SpamAssassin::AutoWelcomelist — is used internally by SpamAssassin to handle the automatic welcomelisting functionality. So it's not the main character you call directly, it's the backstage crew making the magic happen. 🧚

If you want the public interfaces, please refer to the "Mail::SpamAssassin" documentation. That's the one you actually talk to. Not me. I'm internal. 💅

---

⭐ METHODS ⭐

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

This one returns the mean score of all the messages associated with the given address you passed in.

If the address hasn't been seen before? It returns undef. Brand new, never heard of her. 😭

And if $originating_ip is supplied, it will be used in the lookup. Give it the IP, it uses the IP. Simple. 🎀

awl->count();

Returns the count of messages used in determining the welcomelist correction. Just a lil number, doing lil number things. ✨

awl->add_score($score);

This method adds half the score to the current entry.

And why only half, you ask? Because half the score is used so that repeated use of the same From and IP address combination will gradually reduce the score. It's slow-burn correction, no cap. 🔥

awl->add_known_good_address($addr);

Adds a score of -100 to the given address — effectively "bootstrapping" the address as being one that should be welcomelisted. Certified good girl energy. 🫶💚

awl->add_known_bad_address($addr);

Adds a score of 100 to the given address — effectively "bootstrapping" the address as being one that should be blocklisted. Not her. Blocked. 🚫💀

---

Heads up bestie: these are internal methods, so if you're poking at them directly, that's between you and Mail::SpamAssassin. I said what the docs said, nothing more. 🙈

---

perl v5.40.1 · 2026-07-23

and that's the whole page bestie, mwah 💖 slay, go read Mail::SpamAssassin if you need the actual public API, love u bye ✨🎀🦋