nullmailer-dsn(1)

💖 nullmailer-dsn 💖

okay bestie, welcome to the glow-up station for sad failed mail ✨ this one lives in the General Commands Manual section (section 1, iykyk), and it's basically the makeover montage for a bounced message 💅

🌸 NAME 🌸

nullmailer-dsn — take a queued message and ✨reformat✨ it into a delivery status notification (DSN), no cap

🎀 SYNOPSIS 🎀

nullmailer-dsn [ options ] status-code < message

🦋 DESCRIPTION 🦋

So here's the vibe: this program reads a nullmailer queue message from standard input, transforms it into a delivery status notification, and writes the result to standard output. The output is formatted to be fed straight into nullmailer-queue, like it's passing the baton in a relay 🏃♀️✨

Heads up bestie: all times in the options are expressed as seconds since midnight GMT January 1, 1970 — that's the UNIX epoch, the moment the universe (or at least UNIX) woke up 🌅

💅 OPTIONS 💅

• --diagnostic-code=STRING — sets the actual diagnostic code issued by the mail transport. It must be in the form of "type; text", where type would typically be the protocol name, such as SMTP. This adds a Diagnostic-Code header for each recipient 📮
• --envelope-id=STRING — the original envelope ID. Setting this adds an Original-Envelope-Id header to the delivery status section 🎁
• --last-attempt=TIME — sets the time of the last attempted delivery. Defaults to the access time of the input message. This sets the date in the Last-Attempt-Date header for each recipient ⏰
• --max-lines=COUNT — sets the maximum number of lines of the original message to copy into the generated message. A value of zero copies only the original header. Negative values copy the whole message. Defaults to bouncelines below, or zero if that is empty ✂️
• --orig-timestamp=TIME — sets the time of the original message. Defaults to the change time of the input message. This sets the date in the Arrival-Date header in the delivery status section 📅
• --remote=STRING — sets the name of the remote MTA server. This adds a Remote-MTA header for each recipient 🌐
• --retry-until=TIME — sets the time of the (future) final delivery attempt. No default. This adds a Will-Retry-Until header for each recipient 🔁

⭐ RETURN VALUE ⭐

Exits 0 if it was successful 😌 otherwise it prints a diagnostic message to standard error and exits 1 😭

🌈 CONTROL FILES 🌈

• adminaddr — if doublebounceto is empty, double bounces are delivered to this address instead. If no address is configured, double bounces are not generated 🚫
• bouncelines — sets the maximum number of lines of the original message to copy. May be overridden by --max-lines as above 📏
• bounceto — the address to which all bounces should be sent. If it is empty, the original sender address is used 🏠
• defaultdomain — the content of this file is appended to any host name that does not contain a period (except localhost), including defaulthost and idhost. Defaults to the value of the me control file, if it exists, otherwise the literal name defaultdomain 🏷️
• defaulthost — the content of this file is appended to any address that is missing a host name. Defaults to the value of the me control file, if it exists, otherwise the literal name defaulthost 🏷️
• doublebounceto — if the original sender was empty (the original message was a delivery status or disposition notification), the double bounce is sent to the address in this file 📬
• idhost — the content of this file is used when building the message-id string for the message. Defaults to the canonicalized value of defaulthost 🆔
• me — the fully-qualified host name of the computer running nullmailer. Defaults to the literal name me 👑

👀 SEE ALSO 👀

nullmailer-queue(8), nullmailer-send(8) — go read those too bestie, they're part of the same friend group 🫶

okay that's the whole page!! 💖 this was nullmailer-dsn(1) from the General Commands Manual, and honestly? iconic. slay, stay queued, and may all your bounces be properly formatted ✨🎀🦋 periodt 💅