1 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" 2 "https://www.w3.org/TR/html4/loose.dtd"> 3 <html> <head> 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 5 <link rel='stylesheet' type='text/css' href='postfix-doc.css'> 6 <title> Postfix manual - bounce(8) </title> 7 </head> <body> <pre> 8 BOUNCE(8) BOUNCE(8) 9 10 <b><a name="name">NAME</a></b> 11 bounce - Postfix delivery status reports 12 13 <b><a name="synopsis">SYNOPSIS</a></b> 14 <b>bounce</b> [generic Postfix daemon options] 15 16 <b><a name="description">DESCRIPTION</a></b> 17 The <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon maintains per-message log files with delivery sta- 18 tus information. Each log file is named after the queue file that it 19 corresponds to, and is kept in a queue subdirectory named after the 20 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>). 21 This program 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 requests: 24 25 <b>o</b> Append a recipient (non-)delivery status record to a per-message 26 log file. 27 28 <b>o</b> Enqueue a delivery status notification message, with a copy of a 29 per-message log file and of the corresponding message. When the 30 delivery status notification message is enqueued successfully, 31 the per-message log file is deleted. 32 33 The software does a best notification effort. A non-delivery notifica- 34 tion is sent even when the log file or the original message cannot be 35 read. 36 37 Optionally, a bounce (defer, trace) client can request that the 38 per-message log file be deleted when the requested operation fails. 39 This is used by clients that cannot retry transactions by themselves, 40 and that depend on retry logic in their own client. 41 42 <b><a name="standards">STANDARDS</a></b> 43 <a href="https://tools.ietf.org/html/rfc822">RFC 822</a> (ARPA Internet Text Messages) 44 <a href="https://tools.ietf.org/html/rfc2045">RFC 2045</a> (Format of Internet Message Bodies) 45 <a href="https://tools.ietf.org/html/rfc2822">RFC 2822</a> (Internet Message Format) 46 <a href="https://tools.ietf.org/html/rfc3462">RFC 3462</a> (Delivery Status Notifications) 47 <a href="https://tools.ietf.org/html/rfc3464">RFC 3464</a> (Delivery Status Notifications) 48 <a href="https://tools.ietf.org/html/rfc3834">RFC 3834</a> (Auto-Submitted: message header) 49 <a href="https://tools.ietf.org/html/rfc5322">RFC 5322</a> (Internet Message Format) 50 <a href="https://tools.ietf.org/html/rfc6531">RFC 6531</a> (Internationalized SMTP) 51 <a href="https://tools.ietf.org/html/rfc6532">RFC 6532</a> (Internationalized Message Format) 52 <a href="https://tools.ietf.org/html/rfc6533">RFC 6533</a> (Internationalized Delivery Status Notifications) 53 54 <b><a name="diagnostics">DIAGNOSTICS</a></b> 55 Problems and transactions are logged to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>. 56 57 <b><a name="configuration_parameters">CONFIGURATION PARAMETERS</a></b> 58 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 59 run for only a limited amount of time. Use the command "<b>postfix reload</b>" 60 to speed up a change. 61 62 The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for 63 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 returned to 67 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 can be read by 71 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 message head- 75 ers of mail that Postfix did not deliver and of SMTP conversa- 76 tion transcripts of 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 sent in a 80 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 message templates. 84 85 <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> 86 The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con- 87 figuration files. 88 89 <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b> 90 How much time a Postfix daemon process may take to handle a 91 request before it is terminated by a built-in watchdog timer. 92 93 <b><a href="postconf.5.html#delay_notice_recipient">delay_notice_recipient</a> (postmaster)</b> 94 The recipient of postmaster notifications with the message head- 95 ers of mail that cannot be delivered within $<a href="postconf.5.html#delay_warning_time">delay_warning_time</a> 96 time units. 97 98 <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b> 99 The maximal number of attempts to acquire an exclusive lock on a 100 mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 101 102 <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b> 103 The time between attempts to acquire an exclusive lock on a 104 mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 105 106 <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b> 107 The time limit for sending or receiving information over an 108 internal communication channel. 109 110 <b><a href="postconf.5.html#internal_mail_filter_classes">internal_mail_filter_classes</a> (empty)</b> 111 What categories of Postfix-generated mail are subject to 112 before-queue content inspection by <a href="postconf.5.html#non_smtpd_milters">non_smtpd_milters</a>, 113 <a href="postconf.5.html#header_checks">header_checks</a> and <a href="postconf.5.html#body_checks">body_checks</a>. 114 115 <b><a href="postconf.5.html#mail_name">mail_name</a> (Postfix)</b> 116 The mail system name that is displayed in Received: headers, in 117 the SMTP greeting banner, and in bounced mail. 118 119 <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b> 120 The maximum amount of time that an idle Postfix daemon process 121 waits for an incoming connection before terminating voluntarily. 122 123 <b><a href="postconf.5.html#max_use">max_use</a> (100)</b> 124 The maximal number of incoming connections that a Postfix daemon 125 process will service before terminating voluntarily. 126 127 <b><a href="postconf.5.html#notify_classes">notify_classes</a> (resource, software)</b> 128 The list of error classes that are reported to the postmaster. 129 130 <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b> 131 The process ID of a Postfix command or daemon process. 132 133 <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b> 134 The process name of a Postfix command or daemon process. 135 136 <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b> 137 The location of the Postfix top-level queue directory. 138 139 <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> 140 The syslog facility of Postfix logging. 141 142 <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> 143 A prefix that is prepended to the process name in syslog 144 records, so that, for example, "smtpd" becomes "prefix/smtpd". 145 146 Available in Postfix 3.0 and later: 147 148 <b><a href="postconf.5.html#smtputf8_autodetect_classes">smtputf8_autodetect_classes</a> (sendmail, verify)</b> 149 Detect that a message requires SMTPUTF8 support for the speci- 150 fied mail origin classes. 151 152 Available in Postfix 3.3 and later: 153 154 <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b> 155 The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process. 156 157 Available in Postfix 3.6 and later: 158 159 <b><a href="postconf.5.html#enable_threaded_bounces">enable_threaded_bounces</a> (no)</b> 160 Enable non-delivery, success, and delay notifications that link 161 to the original message by including a References: and 162 In-Reply-To: header with the original Message-ID value. 163 164 Available in Postfix 3.7 and later: 165 166 <b><a href="postconf.5.html#header_from_format">header_from_format</a> (standard)</b> 167 The format of the Postfix-generated <b>From:</b> header. 168 169 Available in Postfix 3.10 and later: 170 171 <b><a href="postconf.5.html#tls_required_enable">tls_required_enable</a> (yes)</b> 172 Enable support for the "TLS-Required: no" message header, 173 defined in <a href="https://tools.ietf.org/html/rfc8689">RFC 8689</a>. 174 175 Available in Postfix 3.11 and later: 176 177 <b><a href="postconf.5.html#requiretls_redact_dsn">requiretls_redact_dsn</a> (yes)</b> 178 When sending a delivery status notification for an original mes- 179 sage received with the REQUIRETLS option, do not send the origi- 180 nal message body (as if that message was received with 181 "RET=HDRS") and do not enforce REQUIRETLS (as if that message 182 was received without REQUIRETLS). 183 184 <b><a name="files">FILES</a></b> 185 /var/spool/postfix/bounce/* non-delivery records 186 /var/spool/postfix/defer/* non-delivery records 187 /var/spool/postfix/trace/* delivery status records 188 189 <b><a name="see_also">SEE ALSO</a></b> 190 <a href="bounce.5.html">bounce(5)</a>, bounce message template format 191 <a href="qmgr.8.html">qmgr(8)</a>, queue manager 192 <a href="postconf.5.html">postconf(5)</a>, configuration parameters 193 <a href="master.5.html">master(5)</a>, generic daemon options 194 <a href="master.8.html">master(8)</a>, process manager 195 <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging 196 syslogd(8), system logging 197 198 <b><a name="license">LICENSE</a></b> 199 The Secure Mailer license must be distributed with this software. 200 201 <b>AUTHOR(S)</b> 202 Wietse Venema 203 IBM T.J. Watson Research 204 P.O. Box 704 205 Yorktown Heights, NY 10598, USA 206 207 Wietse Venema 208 Google, Inc. 209 111 8th Avenue 210 New York, NY 10011, USA 211 212 Wietse Venema 213 porcupine.org 214 215 BOUNCE(8) 216 </pre> </body> </html> 217
Indexes created Wed Sep 23 00:26:21 UTC 2026