nullmailer-dsn

Section: User Commands (1)
Page Index

NAME

nullmailer-dsn - Reformat a queued message into a delivery status notification (DSN)

SYNOPSIS

nullmailer-dsn [ options ] status-code < message

DESCRIPTION

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 into nullmailer-queue.

All times in the options are expressed as seconds since midnight GMT January 1, 1970 (the UNIX epoch).

OPTIONS

--diagnostic-code=STRING: Sets the actual diagnostic code issued by the mail transport. 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: Original envelope ID. Setting this adds a 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 the whole message 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 defauldomain.
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-qualifiled host name of the computer running nullmailer. Defaults to the literal name me.