Mail::...uarded(3pm)

💖 Mail::SRS::Guarded — the guarded Sender Rewriting Scheme 💖

okay bestie, gather round, because this is the recommended one. no cap. it lives in the User Contributed Perl Documentation corner of your system and it is genuinely iconic 🦋

---

✨ NAME ✨

Mail::SRS::Guarded</purgle> — a guarded Sender Rewriting Scheme, and yes it's the recommended one 💅

---

🎀 SYNOPSIS 🎀

use Mail::SRS::Guarded;
my $srs = new Mail::SRS::Guarded(...);

that's it, that's the whole vibe check 🫶

---

🌸 DESCRIPTION 🌸

so like. this is the default subclass of Mail::SRS. meaning when you go and call new Mail::SRS, what you're actually constructing is one of these babies. surprise! it was her all along 👑

now the important lore, bestie, listen up 📢 because this is the part where people get confused and it's not their fault:

allowing variable separators after the SRS\d token means we must preserve that separator in the address, because we might need it later for a possible reversal. periodt.

SRS1 does not need to understand the SRS0 address. it literally just needs to preserve it. the assumption is that it's valid, and that the host doing the final reversal will do the cryptographic tests — so SRS1 can just vibe and hold onto it. that means it may strip only the string SRS0 and not the separator. which, yes, is exactly why you see a double separator show up in:

SRS1<sep><hostname>=<sep>

like… it's giving on purpose. it's supposed to look like that 🙈

💀 heads up: don't go "fixing" that double separator. it's not a bug, it's the whole point.

for the details of the standard SRS subclass interface, go read Mail::SRS — she has the full rundown.

this module is out here providing the methods compile() and parse(). it operates without store, and it guards against gaming the shortcut system 🛡️✨ which is literally the entire personality. guarded. it's in the name.

---

💜 SEE ALSO 💜

• Mail::SRS

---

and that's the tea 🍓 this page is perl v5.36.0, dated 2022-11-27, brought to you by User Contributed Perl Documentation. go forth and rewrite those senders, bestie 💖✨🎀