207 lines
11 KiB
HTML
207 lines
11 KiB
HTML
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
"https://www.w3.org/TR/html4/loose.dtd">
|
|
<html> <head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
|
|
<title> Postfix manual - bounce(8) </title>
|
|
</head> <body> <pre>
|
|
BOUNCE(8) BOUNCE(8)
|
|
|
|
<b><a name="name">NAME</a></b>
|
|
bounce - Postfix delivery status reports
|
|
|
|
<b><a name="synopsis">SYNOPSIS</a></b>
|
|
<b>bounce</b> [generic Postfix daemon options]
|
|
|
|
<b><a name="description">DESCRIPTION</a></b>
|
|
The <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon maintains per-message log files with delivery sta-
|
|
tus information. Each log file is named after the queue file that it
|
|
corresponds to, and is kept in a queue subdirectory named after the
|
|
service name in the <a href="master.5.html"><b>master.cf</b></a> file (either <b>bounce</b>, <b>defer</b> or <b>trace</b>).
|
|
This program expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
|
|
|
|
The <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon processes two types of service requests:
|
|
|
|
<b>o</b> Append a recipient (non-)delivery status record to a per-message
|
|
log file.
|
|
|
|
<b>o</b> Enqueue a delivery status notification message, with a copy of a
|
|
per-message log file and of the corresponding message. When the
|
|
delivery status notification message is enqueued successfully,
|
|
the per-message log file is deleted.
|
|
|
|
The software does a best notification effort. A non-delivery notifica-
|
|
tion is sent even when the log file or the original message cannot be
|
|
read.
|
|
|
|
Optionally, a bounce (defer, trace) client can request that the
|
|
per-message log file be deleted when the requested operation fails.
|
|
This is used by clients that cannot retry transactions by themselves,
|
|
and that depend on retry logic in their own client.
|
|
|
|
<b><a name="standards">STANDARDS</a></b>
|
|
<a href="https://tools.ietf.org/html/rfc822">RFC 822</a> (ARPA Internet Text Messages)
|
|
<a href="https://tools.ietf.org/html/rfc2045">RFC 2045</a> (Format of Internet Message Bodies)
|
|
<a href="https://tools.ietf.org/html/rfc2822">RFC 2822</a> (Internet Message Format)
|
|
<a href="https://tools.ietf.org/html/rfc3462">RFC 3462</a> (Delivery Status Notifications)
|
|
<a href="https://tools.ietf.org/html/rfc3464">RFC 3464</a> (Delivery Status Notifications)
|
|
<a href="https://tools.ietf.org/html/rfc3834">RFC 3834</a> (Auto-Submitted: message header)
|
|
<a href="https://tools.ietf.org/html/rfc5322">RFC 5322</a> (Internet Message Format)
|
|
<a href="https://tools.ietf.org/html/rfc6531">RFC 6531</a> (Internationalized SMTP)
|
|
<a href="https://tools.ietf.org/html/rfc6532">RFC 6532</a> (Internationalized Message Format)
|
|
<a href="https://tools.ietf.org/html/rfc6533">RFC 6533</a> (Internationalized Delivery Status Notifications)
|
|
|
|
<b><a name="diagnostics">DIAGNOSTICS</a></b>
|
|
Problems and transactions are logged to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>.
|
|
|
|
<b><a name="configuration_parameters">CONFIGURATION PARAMETERS</a></b>
|
|
Changes to <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically, as <a href="bounce.8.html"><b>bounce</b>(8)</a> processes
|
|
run for only a limited amount of time. Use the command "<b>postfix reload</b>"
|
|
to speed up a change.
|
|
|
|
The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
|
|
more details including examples.
|
|
|
|
<b><a href="postconf.5.html#2bounce_notice_recipient">2bounce_notice_recipient</a> (postmaster)</b>
|
|
The recipient of undeliverable mail that cannot be returned to
|
|
the sender.
|
|
|
|
<b><a href="postconf.5.html#backwards_bounce_logfile_compatibility">backwards_bounce_logfile_compatibility</a> (yes)</b>
|
|
Produce additional <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile records that can be read by
|
|
Postfix versions before 2.0.
|
|
|
|
<b><a href="postconf.5.html#bounce_notice_recipient">bounce_notice_recipient</a> (postmaster)</b>
|
|
The recipient of postmaster notifications with the message head-
|
|
ers of mail that Postfix did not deliver and of SMTP conversa-
|
|
tion transcripts of mail that Postfix did not receive.
|
|
|
|
<b><a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a> (50000)</b>
|
|
The maximal amount of original message text that is sent in a
|
|
non-delivery notification.
|
|
|
|
<b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a> (empty)</b>
|
|
Pathname of a configuration file with bounce message templates.
|
|
|
|
<b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
|
|
The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
|
|
figuration files.
|
|
|
|
<b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
|
|
How much time a Postfix daemon process may take to handle a
|
|
request before it is terminated by a built-in watchdog timer.
|
|
|
|
<b><a href="postconf.5.html#delay_notice_recipient">delay_notice_recipient</a> (postmaster)</b>
|
|
The recipient of postmaster notifications with the message head-
|
|
ers of mail that cannot be delivered within $<a href="postconf.5.html#delay_warning_time">delay_warning_time</a>
|
|
time units.
|
|
|
|
<b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b>
|
|
The maximal number of attempts to acquire an exclusive lock on a
|
|
mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.
|
|
|
|
<b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b>
|
|
The time between attempts to acquire an exclusive lock on a
|
|
mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.
|
|
|
|
<b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
|
|
The time limit for sending or receiving information over an
|
|
internal communication channel.
|
|
|
|
<b><a href="postconf.5.html#internal_mail_filter_classes">internal_mail_filter_classes</a> (empty)</b>
|
|
What categories of Postfix-generated mail are subject to
|
|
before-queue content inspection by <a href="postconf.5.html#non_smtpd_milters">non_smtpd_milters</a>,
|
|
<a href="postconf.5.html#header_checks">header_checks</a> and <a href="postconf.5.html#body_checks">body_checks</a>.
|
|
|
|
<b><a href="postconf.5.html#mail_name">mail_name</a> (Postfix)</b>
|
|
The mail system name that is displayed in Received: headers, in
|
|
the SMTP greeting banner, and in bounced mail.
|
|
|
|
<b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
|
|
The maximum amount of time that an idle Postfix daemon process
|
|
waits for an incoming connection before terminating voluntarily.
|
|
|
|
<b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
|
|
The maximal number of incoming connections that a Postfix daemon
|
|
process will service before terminating voluntarily.
|
|
|
|
<b><a href="postconf.5.html#notify_classes">notify_classes</a> (resource, software)</b>
|
|
The list of error classes that are reported to the postmaster.
|
|
|
|
<b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
|
|
The process ID of a Postfix command or daemon process.
|
|
|
|
<b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
|
|
The process name of a Postfix command or daemon process.
|
|
|
|
<b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
|
|
The location of the Postfix top-level queue directory.
|
|
|
|
<b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
|
|
The syslog facility of Postfix logging.
|
|
|
|
<b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
|
|
A prefix that is prepended to the process name in syslog
|
|
records, so that, for example, "smtpd" becomes "prefix/smtpd".
|
|
|
|
Available in Postfix 3.0 and later:
|
|
|
|
<b><a href="postconf.5.html#smtputf8_autodetect_classes">smtputf8_autodetect_classes</a> (sendmail, verify)</b>
|
|
Detect that a message requires SMTPUTF8 support for the speci-
|
|
fied mail origin classes.
|
|
|
|
Available in Postfix 3.3 and later:
|
|
|
|
<b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b>
|
|
The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process.
|
|
|
|
Available in Postfix 3.6 and later:
|
|
|
|
<b><a href="postconf.5.html#enable_threaded_bounces">enable_threaded_bounces</a> (no)</b>
|
|
Enable non-delivery, success, and delay notifications that link
|
|
to the original message by including a References: and
|
|
In-Reply-To: header with the original Message-ID value.
|
|
|
|
Available in Postfix 3.7 and later:
|
|
|
|
<b><a href="postconf.5.html#header_from_format">header_from_format</a> (standard)</b>
|
|
The format of the Postfix-generated <b>From:</b> header.
|
|
|
|
Available in Postfix 3.10 and later:
|
|
|
|
<b><a href="postconf.5.html#tls_required_enable">tls_required_enable</a> (yes)</b>
|
|
Enable support for the "TLS-Required: no" message header,
|
|
defined in <a href="https://tools.ietf.org/html/rfc8689">RFC 8689</a>.
|
|
|
|
<b><a name="files">FILES</a></b>
|
|
/var/spool/postfix/bounce/* non-delivery records
|
|
/var/spool/postfix/defer/* non-delivery records
|
|
/var/spool/postfix/trace/* delivery status records
|
|
|
|
<b><a name="see_also">SEE ALSO</a></b>
|
|
<a href="bounce.5.html">bounce(5)</a>, bounce message template format
|
|
<a href="qmgr.8.html">qmgr(8)</a>, queue manager
|
|
<a href="postconf.5.html">postconf(5)</a>, configuration parameters
|
|
<a href="master.5.html">master(5)</a>, generic daemon options
|
|
<a href="master.8.html">master(8)</a>, process manager
|
|
<a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
|
|
syslogd(8), system logging
|
|
|
|
<b><a name="license">LICENSE</a></b>
|
|
The Secure Mailer license must be distributed with this software.
|
|
|
|
<b>AUTHOR(S)</b>
|
|
Wietse Venema
|
|
IBM T.J. Watson Research
|
|
P.O. Box 704
|
|
Yorktown Heights, NY 10598, USA
|
|
|
|
Wietse Venema
|
|
Google, Inc.
|
|
111 8th Avenue
|
|
New York, NY 10011, USA
|
|
|
|
Wietse Venema
|
|
porcupine.org
|
|
|
|
BOUNCE(8)
|
|
</pre> </body> </html>
|