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> (Internet Message Format) 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 <a href="http://tools.ietf.org/html/rfc5322">RFC 5322</a> (Internet Message Format) 53 54<b>DIAGNOSTICS</b> 55 Problems and transactions are logged to <b>syslogd</b>(8). 56 57<b>CONFIGURATION PARAMETERS</b> 58 Changes to <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically, as 59 <a href="bounce.8.html"><b>bounce</b>(8)</a> processes run for only a limited amount of time. 60 Use the command "<b>postfix reload</b>" to speed up a change. 61 62 The text below provides only a parameter summary. See 63 <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples. 64 65 <b><a href="postconf.5.html#2bounce_notice_recipient">2bounce_notice_recipient</a> (postmaster)</b> 66 The recipient of undeliverable mail that cannot be 67 returned to the sender. 68 69 <b><a href="postconf.5.html#backwards_bounce_logfile_compatibility">backwards_bounce_logfile_compatibility</a> (yes)</b> 70 Produce additional <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile records that 71 can be read by Postfix versions before 2.0. 72 73 <b><a href="postconf.5.html#bounce_notice_recipient">bounce_notice_recipient</a> (postmaster)</b> 74 The recipient of postmaster notifications with the 75 message headers of mail that Postfix did not 76 deliver and of SMTP conversation transcripts of 77 mail that Postfix did not receive. 78 79 <b><a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a> (50000)</b> 80 The maximal amount of original message text that is 81 sent in a non-delivery notification. 82 83 <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a> (empty)</b> 84 Pathname of a configuration file with bounce mes- 85 sage templates. 86 87 <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> 88 The default location of the Postfix <a href="postconf.5.html">main.cf</a> and 89 <a href="master.5.html">master.cf</a> configuration files. 90 91 <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b> 92 How much time a Postfix daemon process may take to 93 handle a request before it is terminated by a 94 built-in watchdog timer. 95 96 <b><a href="postconf.5.html#delay_notice_recipient">delay_notice_recipient</a> (postmaster)</b> 97 The recipient of postmaster notifications with the 98 message headers of mail that cannot be delivered 99 within $<a href="postconf.5.html#delay_warning_time">delay_warning_time</a> time units. 100 101 <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b> 102 The maximal number of attempts to acquire an exclu- 103 sive lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 104 105 <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b> 106 The time between attempts to acquire an exclusive 107 lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 108 109 <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b> 110 The time limit for sending or receiving information 111 over an internal communication channel. 112 113 <b><a href="postconf.5.html#internal_mail_filter_classes">internal_mail_filter_classes</a> (empty)</b> 114 What categories of Postfix-generated mail are sub- 115 ject to before-queue content inspection by 116 <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>. 117 118 <b><a href="postconf.5.html#mail_name">mail_name</a> (Postfix)</b> 119 The mail system name that is displayed in Received: 120 headers, in the SMTP greeting banner, and in 121 bounced mail. 122 123 <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b> 124 The maximum amount of time that an idle Postfix 125 daemon process waits for an incoming connection 126 before terminating voluntarily. 127 128 <b><a href="postconf.5.html#max_use">max_use</a> (100)</b> 129 The maximal number of incoming connections that a 130 Postfix daemon process will service before termi- 131 nating voluntarily. 132 133 <b><a href="postconf.5.html#notify_classes">notify_classes</a> (resource, software)</b> 134 The list of error classes that are reported to the 135 postmaster. 136 137 <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b> 138 The process ID of a Postfix command or daemon 139 process. 140 141 <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b> 142 The process name of a Postfix command or daemon 143 process. 144 145 <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b> 146 The location of the Postfix top-level queue direc- 147 tory. 148 149 <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> 150 The syslog facility of Postfix logging. 151 152 <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> 153 The mail system name that is prepended to the 154 process name in syslog records, so that "smtpd" 155 becomes, for example, "postfix/smtpd". 156 157<b>FILES</b> 158 /var/spool/postfix/bounce/* non-delivery records 159 /var/spool/postfix/defer/* non-delivery records 160 /var/spool/postfix/trace/* delivery status records 161 162<b>SEE ALSO</b> 163 <a href="bounce.5.html">bounce(5)</a>, bounce message template format 164 <a href="qmgr.8.html">qmgr(8)</a>, queue manager 165 <a href="postconf.5.html">postconf(5)</a>, configuration parameters 166 <a href="master.5.html">master(5)</a>, generic daemon options 167 <a href="master.8.html">master(8)</a>, process manager 168 syslogd(8), system logging 169 170<b>LICENSE</b> 171 The Secure Mailer license must be distributed with this 172 software. 173 174<b>AUTHOR(S)</b> 175 Wietse Venema 176 IBM T.J. Watson Research 177 P.O. Box 704 178 Yorktown Heights, NY 10598, USA 179 180 BOUNCE(8) 181</pre> </body> </html> 182