nullmailer-queue(8)

📦
version 2.2+10~g7ed88a0 · 3 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

nullmailer-queue — bestie, this is the little icon that takes your mail messages and safely tucks them into the outgoing queue 🎀 (it lives in section 8 of the System Manager's Manual, iykyk)

🌸 SYNOPSIS 🌸

nullmailer-queue

That's it. No flags, no args, no drama. She just reads from stdin and goes 💅

🦋 DESCRIPTION 🦋

Okay so here's the vibe: this program reads a formatted mail message from standard input and safely injects it into the outgoing mail queue. No cap, that's the whole job. 👑

The data you pipe into standard input is expected to have this exact format, in this exact order:

  1. one line containing the envelope sender
  2. one or more lines containing the recipients
  3. a single blank line
  4. then the contents of the message, exactly as it is to be transmitted to the destination

All lines are terminated with a single line-feed character. Periodt. 🫶

And listen — all addresses must contain a fully-qualified domain name. Not optional. Not a suggestion. FQDN or nothing, bestie 😭

💖 RETURN VALUE 💖

  • 0 — slay! It successfully queued the message ✨
  • 1 — it failed to queue the message, and it prints an error message to standard output 💀

🎀 CONTROL FILES 🎀

These are the little config cuties that change how the queue behaves. Both of them: if the file is not empty, stuff happens. If it's empty, nothing happens. Simple as.

adminaddr

If this file is not empty, all recipients to users at either "localhost" (the literal string, okay, not a resolved hostname) or the canonical host name (from /etc/mailname) are remapped to this address. 📬

This is provided to allow local daemons to be able to send email to "somebody@localhost" and have it go somewhere sensible instead of being bounced by your relay host. The way that local daemons just want to talk to localhost… relatable honestly 🙈

To send to multiple addresses, put them all on one line separated by a comma.

allmailfrom

If this file is not empty, its contents will override the envelope sender on all messages. Every single one. Main character energy, fr fr 👑

🌈 OTHER FILES 🌈

  • /var/spool/nullmailer/queue — the directory into which the completed messages are moved
  • /var/spool/nullmailer/tmp — the directory in which messages are formed temporarily
  • /var/spool/nullmailer/trigger — a pipe used to trigger nullmailer-send to immediately start sending the message from the queue
⚠️ Bestie, read this one twice: due to nullmailer-queue using hard links to manage emails, both /var/spool/nullmailer/queue and /var/spool/nullmailer/tmp MUST reside on the same filesystem. Not a drill. Same filesystem or it's over 😭

🔥 SEE ALSO 🔥

💀 LIMITATIONS 💀

This program should enforce system-wide configurable message length limits.

(Yes, that's it. She's got no limits. Literally. That's the limitation. 🍓)

That's the whole page, bestie — nullmailer-queue, section 8, from the System Manager's Manual. Go forth and queue responsibly 🧚✨💜

📦 where this page comes from