1
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2
"http://www.w3.org/TR/html4/loose.dtd">
4
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5
<title> Postfix manual - bounce(8) </title>
10
bounce - Postfix message bounce or defer daemon
13
<b>bounce</b> [generic Postfix daemon options]
16
The <b>bounce</b> daemon maintains per-message log files with
17
non-delivery status information. Each log file is named
18
after the queue file that it corresponds to, and is kept
19
in a queue subdirectory named after the service name in
20
the <b>master.cf</b> file (either <b>bounce</b>, <b>defer</b> or <b>trace</b>). This
21
program expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process man-
24
The <b>bounce</b> daemon processes two types of service 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 bounce message, with a copy of a per-mes-
30
sage log file and of the corresponding message.
31
When the bounce message is enqueued successfully,
32
the per-message log file is deleted.
34
The software does a best notification effort. A non-deliv-
35
ery notification is sent even when the log file or the
36
original message cannot be read.
38
Optionally, a bounce (defer, trace) client can request
39
that the per-message log file be deleted when the
40
requested operation fails. This is used by clients that
41
cannot retry transactions by themselves, and that depend
42
on retry logic in their own client.
45
<a href="http://www.faqs.org/rfcs/rfc822.html">RFC 822</a> (ARPA Internet Text Messages)
46
<a href="http://www.faqs.org/rfcs/rfc1894.html">RFC 1894</a> (Delivery Status Notifications)
47
<a href="http://www.faqs.org/rfcs/rfc2045.html">RFC 2045</a> (Format of Internet Message Bodies)
50
Problems and transactions are logged to <b>syslogd</b>(8).
52
<b>CONFIGURATION PARAMETERS</b>
53
Changes to <b>main.cf</b> are picked up automatically, as
54
<a href="bounce.8.html">bounce(8)</a> processes run for only a limited amount of time.
55
Use the command "<b>postfix reload</b>" to speed up a change.
57
The text below provides only a parameter summary. See
58
<a href="postconf.5.html">postconf(5)</a> for more details including examples.
60
<b><a href="postconf.5.html#2bounce_notice_recipient">2bounce_notice_recipient</a> (postmaster)</b>
61
The recipient of undeliverable mail that cannot be
62
returned to the sender.
64
<b><a href="postconf.5.html#backwards_bounce_logfile_compatibility">backwards_bounce_logfile_compatibility</a> (yes)</b>
65
Produce additional <a href="bounce.8.html">bounce(8)</a> logfile records that
66
can be read by older Postfix versions.
68
<b><a href="postconf.5.html#bounce_notice_recipient">bounce_notice_recipient</a> (postmaster)</b>
69
The recipient of postmaster notifications with the
70
message headers of mail that Postfix did not
71
deliver and of SMTP conversation transcripts of
72
mail that Postfix did not receive.
74
<b><a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a> (50000)</b>
75
The maximal amount of original message text that is
76
sent in a non-delivery notification.
78
<b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
79
The default location of the Postfix main.cf and
80
master.cf configuration files.
82
<b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
83
How much time a Postfix daemon process may take to
84
handle a request before it is terminated by a
85
built-in watchdog timer.
87
<b><a href="postconf.5.html#delay_notice_recipient">delay_notice_recipient</a> (postmaster)</b>
88
The recipient of postmaster notifications with the
89
message headers of mail that cannot be delivered
90
within $<a href="postconf.5.html#delay_warning_time">delay_warning_time</a> time units.
92
<b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b>
93
The maximal number of attempts to acquire an exclu-
94
sive lock on a mailbox file or <a href="bounce.8.html">bounce(8)</a> logfile.
96
<b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b>
97
The time between attempts to acquire an exclusive
98
lock on a mailbox file or <a href="bounce.8.html">bounce(8)</a> logfile.
100
<b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
101
The time limit for sending or receiving information
102
over an internal communication channel.
104
<b><a href="postconf.5.html#mail_name">mail_name</a> (Postfix)</b>
105
The mail system name that is displayed in Received:
106
headers, in the SMTP greeting banner, and in
109
<b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
110
The maximum amount of time that an idle Postfix
111
daemon process waits for the next service request
114
<b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
115
The maximal number of connection requests before a
116
Postfix daemon process terminates.
118
<b><a href="postconf.5.html#notify_classes">notify_classes</a> (resource, software)</b>
119
The list of error classes that are reported to the
122
<b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
123
The process ID of a Postfix command or daemon pro-
126
<b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
127
The process name of a Postfix command or daemon
130
<b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
131
The location of the Postfix top-level queue direc-
134
<b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
135
The syslog facility of Postfix logging.
137
<b><a href="postconf.5.html#syslog_name">syslog_name</a> (postfix)</b>
138
The mail system name that is prepended to the pro-
139
cess name in syslog records, so that "smtpd"
140
becomes, for example, "postfix/smtpd".
143
/var/spool/postfix/bounce/* non-delivery records
144
/var/spool/postfix/defer/* non-delivery records
145
/var/spool/postfix/trace/* delivery status records
148
<a href="qmgr.8.html">qmgr(8)</a>, queue manager
149
<a href="postconf.5.html">postconf(5)</a>, configuration parameters
150
<a href="master.8.html">master(8)</a>, process manager
151
syslogd(8), system logging
154
The Secure Mailer license must be distributed with this
159
IBM T.J. Watson Research
161
Yorktown Heights, NY 10598, USA
164
</pre> </body> </html>