1BOUNCE(8) System Manager's Manual BOUNCE(8)
2
3
4
6 bounce - Postfix delivery status reports
7
9 bounce [generic Postfix daemon options]
10
12 The bounce(8) daemon maintains per-message log files with delivery sta‐
13 tus information. Each log file is named after the queue file that it
14 corresponds to, and is kept in a queue subdirectory named after the
15 service name in the master.cf file (either bounce, defer or trace).
16 This program expects to be run from the master(8) process manager.
17
18 The bounce(8) daemon processes two types of service requests:
19
20 · Append a recipient (non-)delivery status record to a per-message
21 log file.
22
23 · Enqueue a delivery status notification message, with a copy of a
24 per-message log file and of the corresponding message. When the
25 delivery status notification message is enqueued successfully,
26 the per-message log file is deleted.
27
28 The software does a best notification effort. A non-delivery notifica‐
29 tion is sent even when the log file or the original message cannot be
30 read.
31
32 Optionally, a bounce (defer, trace) client can request that the per-
33 message log file be deleted when the requested operation fails. This
34 is used by clients that cannot retry transactions by themselves, and
35 that depend on retry logic in their own client.
36
38 RFC 822 (ARPA Internet Text Messages)
39 RFC 2045 (Format of Internet Message Bodies)
40 RFC 2822 (ARPA Internet Text Messages)
41 RFC 3462 (Delivery Status Notifications)
42 RFC 3464 (Delivery Status Notifications)
43 RFC 3834 (Auto-Submitted: message header)
44
46 Problems and transactions are logged to syslogd(8).
47
49 Changes to main.cf are picked up automatically, as bounce(8) processes
50 run for only a limited amount of time. Use the command "postfix reload"
51 to speed up a change.
52
53 The text below provides only a parameter summary. See postconf(5) for
54 more details including examples.
55
56 2bounce_notice_recipient (postmaster)
57 The recipient of undeliverable mail that cannot be returned to
58 the sender.
59
60 backwards_bounce_logfile_compatibility (yes)
61 Produce additional bounce(8) logfile records that can be read by
62 Postfix versions before 2.0.
63
64 bounce_notice_recipient (postmaster)
65 The recipient of postmaster notifications with the message head‐
66 ers of mail that Postfix did not deliver and of SMTP conversa‐
67 tion transcripts of mail that Postfix did not receive.
68
69 bounce_size_limit (50000)
70 The maximal amount of original message text that is sent in a
71 non-delivery notification.
72
73 bounce_template_file (empty)
74 Pathname of a configuration file with bounce message templates.
75
76 config_directory (see 'postconf -d' output)
77 The default location of the Postfix main.cf and master.cf con‐
78 figuration files.
79
80 daemon_timeout (18000s)
81 How much time a Postfix daemon process may take to handle a
82 request before it is terminated by a built-in watchdog timer.
83
84 delay_notice_recipient (postmaster)
85 The recipient of postmaster notifications with the message head‐
86 ers of mail that cannot be delivered within $delay_warning_time
87 time units.
88
89 deliver_lock_attempts (20)
90 The maximal number of attempts to acquire an exclusive lock on a
91 mailbox file or bounce(8) logfile.
92
93 deliver_lock_delay (1s)
94 The time between attempts to acquire an exclusive lock on a
95 mailbox file or bounce(8) logfile.
96
97 ipc_timeout (3600s)
98 The time limit for sending or receiving information over an
99 internal communication channel.
100
101 internal_mail_filter_classes (empty)
102 What categories of Postfix-generated mail are subject to before-
103 queue content inspection by non_smtpd_milters, header_checks and
104 body_checks.
105
106 mail_name (Postfix)
107 The mail system name that is displayed in Received: headers, in
108 the SMTP greeting banner, and in bounced mail.
109
110 max_idle (100s)
111 The maximum amount of time that an idle Postfix daemon process
112 waits for an incoming connection before terminating voluntarily.
113
114 max_use (100)
115 The maximal number of incoming connections that a Postfix daemon
116 process will service before terminating voluntarily.
117
118 notify_classes (resource, software)
119 The list of error classes that are reported to the postmaster.
120
121 process_id (read-only)
122 The process ID of a Postfix command or daemon process.
123
124 process_name (read-only)
125 The process name of a Postfix command or daemon process.
126
127 queue_directory (see 'postconf -d' output)
128 The location of the Postfix top-level queue directory.
129
130 syslog_facility (mail)
131 The syslog facility of Postfix logging.
132
133 syslog_name (see 'postconf -d' output)
134 The mail system name that is prepended to the process name in
135 syslog records, so that "smtpd" becomes, for example, "post‐
136 fix/smtpd".
137
139 /var/spool/postfix/bounce/* non-delivery records
140 /var/spool/postfix/defer/* non-delivery records
141 /var/spool/postfix/trace/* delivery status records
142
144 bounce(5), bounce message template format
145 qmgr(8), queue manager
146 postconf(5), configuration parameters
147 master(5), generic daemon options
148 master(8), process manager
149 syslogd(8), system logging
150
152 The Secure Mailer license must be distributed with this software.
153
155 Wietse Venema
156 IBM T.J. Watson Research
157 P.O. Box 704
158 Yorktown Heights, NY 10598, USA
159
160
161
162 BOUNCE(8)