1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" 2 "http://www.w3.org/TR/html4/loose.dtd"> 3<html> <head> 4<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> 5<title> Postfix manual - bounce(8) </title> 6</head> <body> <pre> 7BOUNCE(8) BOUNCE(8) 8 9<b>NAME</b> 10 bounce - Postfix delivery status reports 11 12<b>SYNOPSIS</b> 13 <b>bounce</b> [generic Postfix daemon options] 14 15<b>DESCRIPTION</b> 16 The <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon maintains per-message log files with 17 delivery status information. Each log file is named after 18 the queue file that it corresponds to, and is kept in a 19 queue subdirectory named after the service name in the 20 <a href="master.5.html"><b>master.cf</b></a> file (either <b>bounce</b>, <b>defer</b> or <b>trace</b>). This pro- 21 gram expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager. 22 23 The <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon processes two types of service 24 requests: 25 26 <b>o</b> Append a recipient (non-)delivery status record to 27 a per-message log file. 28 29 <b>o</b> Enqueue a delivery status notification message, 30 with a copy of a per-message log file and of the 31 corresponding message. When the delivery status 32 notification message is enqueued successfully, the 33 per-message log file is deleted. 34 35 The software does a best notification effort. A non-deliv- 36 ery notification is sent even when the log file or the 37 original message cannot be read. 38 39 Optionally, a bounce (defer, trace) client can request 40 that the per-message log file be deleted when the 41 requested operation fails. This is used by clients that 42 cannot retry transactions by themselves, and that depend 43 on retry logic in their own client. 44 45<b>STANDARDS</b> 46 <a href="http://tools.ietf.org/html/rfc822">RFC 822</a> (ARPA Internet Text Messages) 47 <a href="http://tools.ietf.org/html/rfc2045">RFC 2045</a> (Format of Internet Message Bodies) 48 <a href="http://tools.ietf.org/html/rfc2822">RFC 2822</a> (ARPA Internet Text Messages) 49 <a href="http://tools.ietf.org/html/rfc3462">RFC 3462</a> (Delivery Status Notifications) 50 <a href="http://tools.ietf.org/html/rfc3464">RFC 3464</a> (Delivery Status Notifications) 51 <a href="http://tools.ietf.org/html/rfc3834">RFC 3834</a> (Auto-Submitted: message header) 52 53<b>DIAGNOSTICS</b> 54 Problems and transactions are logged to <b>syslogd</b>(8). 55 56<b>CONFIGURATION PARAMETERS</b> 57 Changes to <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically, as 58 <a href="bounce.8.html"><b>bounce</b>(8)</a> processes run for only a limited amount of time. 59 Use the command "<b>postfix reload</b>" to speed up a change. 60 61 The text below provides only a parameter summary. See 62 <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples. 63 64 <b><a href="postconf.5.html#2bounce_notice_recipient">2bounce_notice_recipient</a> (postmaster)</b> 65 The recipient of undeliverable mail that cannot be 66 returned to the sender. 67 68 <b><a href="postconf.5.html#backwards_bounce_logfile_compatibility">backwards_bounce_logfile_compatibility</a> (yes)</b> 69 Produce additional <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile records that 70 can be read by Postfix versions before 2.0. 71 72 <b><a href="postconf.5.html#bounce_notice_recipient">bounce_notice_recipient</a> (postmaster)</b> 73 The recipient of postmaster notifications with the 74 message headers of mail that Postfix did not 75 deliver and of SMTP conversation transcripts of 76 mail that Postfix did not receive. 77 78 <b><a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a> (50000)</b> 79 The maximal amount of original message text that is 80 sent in a non-delivery notification. 81 82 <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a> (empty)</b> 83 Pathname of a configuration file with bounce mes- 84 sage templates. 85 86 <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> 87 The default location of the Postfix <a href="postconf.5.html">main.cf</a> and 88 <a href="master.5.html">master.cf</a> configuration files. 89 90 <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b> 91 How much time a Postfix daemon process may take to 92 handle a request before it is terminated by a 93 built-in watchdog timer. 94 95 <b><a href="postconf.5.html#delay_notice_recipient">delay_notice_recipient</a> (postmaster)</b> 96 The recipient of postmaster notifications with the 97 message headers of mail that cannot be delivered 98 within $<a href="postconf.5.html#delay_warning_time">delay_warning_time</a> time units. 99 100 <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b> 101 The maximal number of attempts to acquire an exclu- 102 sive lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 103 104 <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b> 105 The time between attempts to acquire an exclusive 106 lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 107 108 <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b> 109 The time limit for sending or receiving information 110 over an internal communication channel. 111 112 <b><a href="postconf.5.html#internal_mail_filter_classes">internal_mail_filter_classes</a> (empty)</b> 113 What categories of Postfix-generated mail are sub- 114 ject to before-queue content inspection by 115 <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>. 116 117 <b><a href="postconf.5.html#mail_name">mail_name</a> (Postfix)</b> 118 The mail system name that is displayed in Received: 119 headers, in the SMTP greeting banner, and in 120 bounced mail. 121 122 <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b> 123 The maximum amount of time that an idle Postfix 124 daemon process waits for an incoming connection 125 before terminating voluntarily. 126 127 <b><a href="postconf.5.html#max_use">max_use</a> (100)</b> 128 The maximal number of incoming connections that a 129 Postfix daemon process will service before termi- 130 nating voluntarily. 131 132 <b><a href="postconf.5.html#notify_classes">notify_classes</a> (resource, software)</b> 133 The list of error classes that are reported to the 134 postmaster. 135 136 <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b> 137 The process ID of a Postfix command or daemon 138 process. 139 140 <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b> 141 The process name of a Postfix command or daemon 142 process. 143 144 <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b> 145 The location of the Postfix top-level queue direc- 146 tory. 147 148 <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> 149 The syslog facility of Postfix logging. 150 151 <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> 152 The mail system name that is prepended to the 153 process name in syslog records, so that "smtpd" 154 becomes, for example, "postfix/smtpd". 155 156<b>FILES</b> 157 /var/spool/postfix/bounce/* non-delivery records 158 /var/spool/postfix/defer/* non-delivery records 159 /var/spool/postfix/trace/* delivery status records 160 161<b>SEE ALSO</b> 162 <a href="bounce.5.html">bounce(5)</a>, bounce message template format 163 <a href="qmgr.8.html">qmgr(8)</a>, queue manager 164 <a href="postconf.5.html">postconf(5)</a>, configuration parameters 165 <a href="master.5.html">master(5)</a>, generic daemon options 166 <a href="master.8.html">master(8)</a>, process manager 167 syslogd(8), system logging 168 169<b>LICENSE</b> 170 The Secure Mailer license must be distributed with this 171 software. 172 173<b>AUTHOR(S)</b> 174 Wietse Venema 175 IBM T.J. Watson Research 176 P.O. Box 704 177 Yorktown Heights, NY 10598, USA 178 179 BOUNCE(8) 180</pre> </body> </html> 181