Mail::...Action(3pm)

💖 Mail::...Action(3pm) — the whole vibe 💖

okay bestie, so this is a User Contributed Perl Documentation page for Mail::MtPolicyd::Plugin::RBLAction, living in section 3pm of the manual. Yes the header says Mail::...Action(3pm) and no, it's not hiding anything from you, that's just the truncated name. Let's get into it 🫶

---

✨ NAME ✨

Mail::MtPolicyd::Plugin::RBLAction — it's an mtpolicyd plugin that checks the client-address against an RBL. 🕵️♀️

---

🌸 VERSION 🌸

version 2.05 — that's the one, periodt.

---

🦋 DESCRIPTION 🦋

So here's the tea: this plugin is for when you need a more complex evaluation of an RBL result than just the plain old match / not-match situation. Like, the basic RBL plugin is fine, but sometimes you want nuance, you know?

With this plugin you can take the exact same actions as with the RBL plugin — same energy — but it can match the result with a regular expression. Which means you can take action based on the category inside combined blacklists. It's giving ✨sophisticated✨. It's giving iykyk. 💅

---

🎀 PARAMETERS 🎀

• result_from (required) — Use the query result of this RBL check. Like, whose results are we even judging here? This one. 👑
• (uc_)enabled (default: on) — Enable/disable this check. On by default, because obviously.
• (uc_)mode (default: reject) — pick your fighter:
  • reject — Reject the message. (reject)
  • accept — Stop processing an accept this message. (dunno)
  • passive — Only apply the score if one is given.
• re_match (required) — An regular expression to check the RBL result. This is the whole main character of the plugin fr fr.
• reject_message (default: delivery from %IP% rejected %INFO%) — A pattern for the reject message if mode is set to 'reject'. Only shows up when you're actually rejecting, so don't stress otherwise. 😌
• score (default: empty) — Apply this score if the check matched. Nothing applied if you leave it empty, no cap.

---

🌈 EXAMPLE 🌈

Here's the actual config, verbatim, because copy-paste is a love language:

<Plugin spamhaus-rbl>
  module = "RBL"
  mode = "passive"
  domain="zen.spamhaus.org"
</Plugin>
<Plugin spamhaus-rbl-sbl>
  module = "RBLAction"
  result_from = "spamhaus-rbl"
  mode = "passive"
  re_match = "^127\.0\.0\.[23]$"
  score = 5
</Plugin>
<Plugin spamhaus-rbl-xbl>
  module = "RBLAction"
  result_from = "spamhaus-rbl"
  mode = "passive"
  re_match = "^127\.0\.0\.[4-7]$"
  score = 5
</Plugin>
<Plugin spamhaus-rbl-pbl>
  module = "RBLAction"
  result_from = "spamhaus-rbl"
  mode = "passive"
  re_match = "^127\.0\.0\.1[01]$"
  score = 3
</Plugin>

See what's happening? One RBL check pulls the result, then three RBLAction plugins each regex-match a different slice of that same result and slap a different score on it. Obsessed with the efficiency honestly. 🔥

---

👑 AUTHOR 👑

Markus Benning <ich@markusbenning.de> — the icon who made this happen. 🙌

---

💜 COPYRIGHT AND LICENSE 💜

This software is Copyright (c) 2014 by Markus Benning <ich@markusbenning.de>.

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991

---

⭐ little sign-off for you bestie: this was written by the perl people at perl v5.38.2, dated 2024-05-26, and the page itself is Mail::...Action(3pm). go forth and regex responsibly, mwah 💋