diff options
Diffstat (limited to 'html/bounce.8.html')
| -rw-r--r-- | html/bounce.8.html | 185 |
1 files changed, 185 insertions, 0 deletions
diff --git a/html/bounce.8.html b/html/bounce.8.html new file mode 100644 index 0000000..6780121 --- /dev/null +++ b/html/bounce.8.html @@ -0,0 +1,185 @@ +<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html> <head> +<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> +<title> Postfix manual - bounce(8) </title> +</head> <body> <pre> +BOUNCE(8) BOUNCE(8) + +<b>NAME</b> + bounce - Postfix delivery status reports + +<b>SYNOPSIS</b> + <b>bounce</b> [generic Postfix daemon options] + +<b>DESCRIPTION</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>STANDARDS</b> + <a href="http://tools.ietf.org/html/rfc822">RFC 822</a> (ARPA Internet Text Messages) + <a href="http://tools.ietf.org/html/rfc2045">RFC 2045</a> (Format of Internet Message Bodies) + <a href="http://tools.ietf.org/html/rfc2822">RFC 2822</a> (Internet Message Format) + <a href="http://tools.ietf.org/html/rfc3462">RFC 3462</a> (Delivery Status Notifications) + <a href="http://tools.ietf.org/html/rfc3464">RFC 3464</a> (Delivery Status Notifications) + <a href="http://tools.ietf.org/html/rfc3834">RFC 3834</a> (Auto-Submitted: message header) + <a href="http://tools.ietf.org/html/rfc5322">RFC 5322</a> (Internet Message Format) + <a href="http://tools.ietf.org/html/rfc6531">RFC 6531</a> (Internationalized SMTP) + <a href="http://tools.ietf.org/html/rfc6532">RFC 6532</a> (Internationalized Message Format) + <a href="http://tools.ietf.org/html/rfc6533">RFC 6533</a> (Internationalized Delivery Status Notifications) + +<b>DIAGNOSTICS</b> + Problems and transactions are logged to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>. + +<b>CONFIGURATION PARAMETERS</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. + +<b>FILES</b> + /var/spool/postfix/bounce/* non-delivery records + /var/spool/postfix/defer/* non-delivery records + /var/spool/postfix/trace/* delivery status records + +<b>SEE ALSO</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>LICENSE</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 + + BOUNCE(8) +</pre> </body> </html> |