Sympa::Mailer(3Sympa)

💌 Sympa::Mailer — girl help, it's the sendmail whisperer

okay so bestie, welcome to Sympa::Mailer(3Sympa) — the part of sympa 6.2.80 that takes your cute little messages and hands them off to sendmail. yes, it's giving postal worker but make it Perl. let's get into it 💅

---

✨ NAME ✨

Sympa::Mailer — stores messages so they can go to sendmail 📮

---

🦋 SYNOPSIS 🦋

use Sympa::Mailer;
use Sympa::Process;
my $mailer = Sympa::Mailer->instance;
my $process = Sympa::Process->instance;

$mailer->store($message, ['user1@dom.ain', user2@other.dom.ain']);

see how easy that was?? main character energy fr fr ✨

---

💖 DESCRIPTION 💖

so basically, Sympa::Mailer implements the class that invokes sendmail processes and stores messages into them. it's the go-between. the middlewoman. the bestie who knows a girl who knows a girl at the post office 🫶

🌸 Methods 🌸

• instance ( ) — the constructor, babes! creates a singleton instance of the Sympa::Mailer object. one of her, only her, periodt 👑

Returns:

• a brand new Sympa::Mailer instance, or undef if it didn't work out 😭

• reaper ( [ blocking => 1 ] ) — 💀 DEPRECATED, girl. use "reap_child" in Sympa::Process instead.

Instance method. a non-blocking function that gets called by the main loop of sympa, task_manager, bounced etc., just to clean up the defuncts list by waiting on any processes and decrementing the counter. janitorial realness 🧹

Parameter:

• blocking => 1 — operation would block.

Returns:

• PID.

• store ( $message, $rcpt, [ envid => $envid ], [ tag => $tag ] ) — the moment we've all been waiting for ✨

Instance method. makes a sendmail ready for the recipients given as an argument, and uses a file descriptor in the smtp table which can be imported by other parties. and before all that? she waits for number of children process < number allowed by sympa.conf. patience is a virtue bestie 💅

Parameters:

• $message — the message to be sent.

the {envelope_sender} attribute of the message gets used as the SMTP "MAIL FROM:" field. no cap.

• $rcpt — scalar, scalarref or arrayref, for the SMTP "RCPT TO:" field. she's flexible like that 💁
• envid => $envid — an envelope ID of this message submission in the notification table. see also Sympa::Tracking.
• tag => $tag — TBD 🙈 (yes, literally just "TBD". iconic honestly.)

Returns:

• filehandle on an opened pipe to output the SMTP "DATA" field. otherwise "undef" 💀

🎀 Attributes 🎀

a Sympa::Mailer instance may have the following attributes, babes:

• {log_smtp} — if a true value is set, every single invocation of the sendmail process will be logged. she's documenting everything, like a true diary keeper 📓
• {redundancy} — a positive integer. if set, the maximum number of invocations of sendmail is divided by this value. math girlie behavior 🔥

---

👀 SEE ALSO 👀

you're gonna wanna check out her friends too, they're all iconic:

• Sympa::Message
• Sympa::Process
• Sympa::Spool::Listmaster
• Sympa::Spool::Outgoing

---

🌈 HISTORY 🌈

Sympa::Mailer, the rewrite of mail.pm, appeared on Sympa 6.2. glow-up of the century honestly 💖

---

and that's the whole thing bestie!! Sympa::Mailer from sympa 6.2.80, dated 2026-10-19 — she's stable, she's gorgeous, she's sending your mail. slay, no cap, periodt 🎀✨🦋💅