Sendmail::Milter(3pm)

📦
version 1.00 · 7 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

✨ Sendmail::Milter ✨

okay so bestie, welcome to Sendmail::Milter — the compatibility interface for Sendmail::PMilter 🫶 it lives in the User Contributed Perl Documentation corner of your man pages and it's literally just here to make your old scripts feel seen 💅

🌸 SYNOPSIS 🌸

use Sendmail::Milter;

Sendmail::Milter::auto_setconn(NAME);
Sendmail::Milter::register(NAME, { CALLBACKS }, FLAGS);
Sendmail::Milter::main();

that's the whole vibe. three lines, iconic behavior, no notes ✨

🦋 DESCRIPTION 🦋

so this is a compatibility interface that emulates the "standard" Sendmail::Milter API. that's it, that's the job. it's giving "I'm the translator at the group hang so everyone gets along" 😌

👑 FUNCTIONS 👑

here's what you get, bestie. and listen — unlike Sendmail::PMilter, this interface involves a single, global instance of milter data, so you call these functions without an object reference. no $self, no ->, just raw function calls. periodt.

for each function, go read the description of its object-based counterpart in Sendmail::PMilter — that's where the real lore is 📖

  • Sendmail::Milter::auto_getconn(NAME[, CONFIG])
  • Sendmail::Milter::auto_setconn(NAME[, CONFIG])
  • Sendmail::Milter::main([MAXCHILDREN[, MAXREQ]])
  • Sendmail::Milter::register(NAME, CALLBACKS[, FLAGS])
  • Sendmail::Milter::setconn(DESC)

🎀 One extension function is provided by this implementation 🎀

like, this implementation went above and beyond, and honestly? we love that for it 💖

  • Sendmail::Milter::get_milter() — returns the Sendmail::PMilter instance underlying this emulation layer. this lets mostly-unmodified milter scripts set PMilter extensions (such as dispatcher and sendmail.cf values).
⚠️ but real talk bestie: it is recommended, however, that new code use the object instance methods described in Sendmail::PMilter. the compat layer is a nostalgia tour, not a new build 🫶

🌈 EXPORTS 🌈

to preserve compatibility with the standard Sendmail::Milter interface, all SMFI* constants described in Sendmail::PMilter are exported into the caller's namespace by default. you didn't ask, they just showed up, and they're staying 💅

🙈 (note that Sendmail::PMilter itself does not export these symbols by default. so like… yeah. different house rules, different house.)

and that's the page, bestie!! 🦋🌸✨ this was Sendmail::Milter(3pm) from the User Contributed Perl Documentation, shipped with perl v5.32.1 and dated 2021-12-26 — go forth, set those connections, and slay 💖🎀👑

📦 where this page comes from