Mail::...exList(3pm)

πŸ’– Mail::...exList(3pm) πŸ’–

okay bestie, you found the manual page for Mail::MtPolicyd::Plugin::RegexList β€” it lives in the User Contributed Perl Documentation section, and it's about to be your new fave. it's a regex-matching plugin for mtpolicyd and honestly? it ate. let's go πŸ¦‹


✨ NAME ✨

Mail::MtPolicyd::Plugin::RegexList β€” mtpolicyd plugin for regex matching. that's it, that's the whole name, she's lowkey self-explanatory but we love her anyway πŸ’…


🌸 VERSION 🌸

version 2.05. yes queen, 2.05, write it down. ✨


πŸŽ€ SYNOPSIS πŸŽ€

here's the vibe, literally just copy-paste this into your config and thank me later:

<Plugin regex-whitelist>
  module = "RegexList"
  key = "request:client_name"
  regex = "^mail-[a-z][a-z]0-f[0-9]*\.google\.com$"
  regex = "\.bofh-noc\.de$"
  # file = "/etc/mtpolicyd/regex-whitelist.txt"
  action = "accept"
</Plugin>

see how there's a commented-out file line? that's a choose your own adventure moment, bestie. regex inline OR from a file. iconic. πŸ”₯


πŸ’œ DESCRIPTION πŸ’œ

so here's the tea: this plugin takes a value, matches it against a whole list of regular expressions, and if it matches β€” it runs an action. it's giving bouncer at the club, but for regexes. πŸ‘‘


🌈 PARAMETERS 🌈

the module takes these parameters, and ngl every single one matters so don't skip:

  • (uc_)enabled (default: "on") β€” set it to 'off' to deactivate the check. super handy when you wanna toggle the check per user, no cap. 🫢
  • key (default: "request:client_address") β€” the field you wanna query. that's the thing being matched, bestie.
  • invert (default: 0) β€” set it to 1 and the whole logic flips. uno reverse card energy. πŸ™ˆ
  • regex (default: empty) β€” one or more regular expressions. you can stack these, one per regex line. ✨
  • file (default: empty) β€” a file to load regular expressions from. one regex per line. and listen β€” empty lines and lines starting with # get ignored, so go ahead and leave yourself lil notes. πŸ’…
okay so heads up bestie: by default the plugin will do nothing. like, nothing nothing. so you gotta specify at least ONE of the following actions or it's just gonna sit there looking pretty. 😭
  • action (default: empty) β€” if you give it one, this action gets returned to the MTA when the SQL query matched. πŸ’–
  • score (default: empty) β€” if you give it one, this score gets applied to the session. πŸ“ˆ
  • Plugin (default: empty) β€” execute this plugin when the condition matched. yes, she runs other plugins. main character energy fr fr. πŸ‘‘

🧚 AUTHOR 🧚

Markus Benning <ich@markusbenning.de> β€” the icon, the legend, the one who wrote this. 🫢


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

it's free software, licensed under:

The GNU General Public License, Version 2, June 1991

periodt. πŸ’œ


okay that's the whole page bestie, you're officially regex-list-pilled ✨. this version was served up by perl v5.38.2 and dated 2024-05-26 β€” so yeah, she's a lil vintage but she's still slaying. mwah, go match some regexes πŸ’–πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from