Mail::...loRegex(3pm)

✨ NAME ✨

This is the page for Mail::...loRegex(3pm) (the header trims it, but bestie, you know her 💅), and her whole government name is Mail::Milter::Module::HeloRegex — a milter that accepts or rejects connections based on certain HELO values. 🎀

---

🌸 SYNOPSIS 🌸

use Mail::Milter::Module::HeloRegex;

my $milter = new Mail::Milter::Module::HeloRegex('^foo\.com$');

my $milter2 = &HeloRegex('^foo\.com$'); # convenience

---

🦋 DESCRIPTION 🦋

Okay so here's the vibe: this milter module will reject entire SMTP connections if the connecting client sends a HELO command that matches any of the regular expressions you hand it. Not a soft little nudge — the whole connection, gone. 😭

But wait, lowkey important: only the initial word of the HELO string gets tested. Any EHLO parameters? Not checked by the regexes. Periodt. So don't come for her about the params, she literally does not look at them. 🙈

---

💖 METHODS 💖

new(REGEX[, ...])

Takes one or more regular expressions — you can pass them as plain strings or as qr// precompiled regexes, whatever fits your main character energy ✨. They get tested in sequence, and the first match terminates checking — she's not out here doing extra credit, bestie. First hit and she's done. 💅

set_message(MESSAGE)

Sets the message that gets used when rejecting messages. This string can contain the substring %H, which will be replaced by the matching HELO parameter. Cute, right? 🍓

And plot twist — this method returns a reference to the object itself, which means you can chain the method call. So smooth. 🫶

---

👑 AUTHOR 👑

Todd Vierling, <tv@duh.org> <tv@pobox.com>

(an icon, fr fr 🌈)

---

⭐ SEE ALSO ⭐

• Mail::Milter::Object

---

💀 POD ERRORS 💀

Hey! Not me catching the doc having some coding errors 😭 — here's what went down, explained below:

Around line 69:

You can't have =items (as at line 81) unless the first thing after
the =over is an =item

ngl, that's a real one. The =over needs an =item right after it. She's a little messy but we love her anyway. 🙈

---

Okay bestie, that's the whole page!! Written by perl v5.36.0 on 2023-01-22 — mwah, kiss the doc, go protect your milter 💖🧚💜