autoupdate
[postfix-master.git] / postfix-master / bounce.8.html
blob4896b1f1164b1bbd4200860cf75b600867f21d1d
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>
7 BOUNCE(8) BOUNCE(8)
9 <b>NAME</b>
10 bounce - Postfix delivery status reports
12 <b>SYNOPSIS</b>
13 <b>bounce</b> [generic Postfix daemon options]
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.
23 The <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon processes two types of service
24 requests:
26 <b>o</b> Append a recipient (non-)delivery status record to
27 a per-message log file.
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.
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.
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.
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)
54 <b>DIAGNOSTICS</b>
55 Problems and transactions are logged to <b>syslogd</b>(8).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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>.
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.
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.
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.
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.
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.
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.
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.
149 <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
150 The syslog facility of Postfix logging.
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".
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
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
170 <b>LICENSE</b>
171 The Secure Mailer license must be distributed with this
172 software.
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
180 BOUNCE(8)
181 </pre> </body> </html>