nullmailer-dsn(1)

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.

SEE ALSO
nullmailer-queue(8), nullmailer-send(8)