| blob | 81f35cc4b7547494a8c7db7f430595fae7e01dff |
1 .\" $NetBSD$
2 .\"
3 .TH BOUNCE 8
4 .ad
5 .fi
6 .SH NAME
7 bounce
8 \-
9 Postfix delivery status reports
10 .SH "SYNOPSIS"
11 .na
12 .nf
13 \fBbounce\fR [generic Postfix daemon options]
14 .SH DESCRIPTION
15 .ad
16 .fi
17 The \fBbounce\fR(8) daemon maintains per-message log files with
18 delivery status information. Each log file is named after the
19 queue file that it corresponds to, and is kept in a queue subdirectory
20 named after the service name in the \fBmaster.cf\fR file (either
21 \fBbounce\fR, \fBdefer\fR or \fBtrace\fR).
22 This program expects to be run from the \fBmaster\fR(8) process
23 manager.
25 The \fBbounce\fR(8) daemon processes two types of service requests:
26 .IP \(bu
27 Append a recipient (non-)delivery status record to a per-message
28 log file.
29 .IP \(bu
30 Enqueue a delivery status notification message, with a copy
31 of a per-message log file and of the corresponding message.
32 When the delivery status notification message is
33 enqueued successfully, the per-message log file is deleted.
34 .PP
35 The software does a best notification effort. A non-delivery
36 notification is sent even when the log file or the original
37 message cannot be read.
39 Optionally, a bounce (defer, trace) client can request that the
40 per-message log file be deleted when the requested operation fails.
41 This is used by clients that cannot retry transactions by
42 themselves, and that depend on retry logic in their own client.
43 .SH "STANDARDS"
44 .na
45 .nf
46 RFC 822 (ARPA Internet Text Messages)
47 RFC 2045 (Format of Internet Message Bodies)
48 RFC 2822 (ARPA Internet Text Messages)
49 RFC 3462 (Delivery Status Notifications)
50 RFC 3464 (Delivery Status Notifications)
51 RFC 3834 (Auto-Submitted: message header)
52 .SH DIAGNOSTICS
53 .ad
54 .fi
55 Problems and transactions are logged to \fBsyslogd\fR(8).
56 .SH "CONFIGURATION PARAMETERS"
57 .na
58 .nf
59 .ad
60 .fi
61 Changes to \fBmain.cf\fR are picked up automatically, as \fBbounce\fR(8)
62 processes run for only a limited amount of time. Use the command
63 "\fBpostfix reload\fR" to speed up a change.
65 The text below provides only a parameter summary. See
66 \fBpostconf\fR(5) for more details including examples.
67 .IP "\fB2bounce_notice_recipient (postmaster)\fR"
68 The recipient of undeliverable mail that cannot be returned to
69 the sender.
70 .IP "\fBbackwards_bounce_logfile_compatibility (yes)\fR"
71 Produce additional \fBbounce\fR(8) logfile records that can be read by
72 Postfix versions before 2.0.
73 .IP "\fBbounce_notice_recipient (postmaster)\fR"
74 The recipient of postmaster notifications with the message headers
75 of mail that Postfix did not deliver and of SMTP conversation
76 transcripts of mail that Postfix did not receive.
77 .IP "\fBbounce_size_limit (50000)\fR"
78 The maximal amount of original message text that is sent in a
79 non-delivery notification.
80 .IP "\fBbounce_template_file (empty)\fR"
81 Pathname of a configuration file with bounce message templates.
82 .IP "\fBconfig_directory (see 'postconf -d' output)\fR"
83 The default location of the Postfix main.cf and master.cf
84 configuration files.
85 .IP "\fBdaemon_timeout (18000s)\fR"
86 How much time a Postfix daemon process may take to handle a
87 request before it is terminated by a built-in watchdog timer.
88 .IP "\fBdelay_notice_recipient (postmaster)\fR"
89 The recipient of postmaster notifications with the message headers
90 of mail that cannot be delivered within $delay_warning_time time
91 units.
92 .IP "\fBdeliver_lock_attempts (20)\fR"
93 The maximal number of attempts to acquire an exclusive lock on a
94 mailbox file or \fBbounce\fR(8) logfile.
95 .IP "\fBdeliver_lock_delay (1s)\fR"
96 The time between attempts to acquire an exclusive lock on a mailbox
97 file or \fBbounce\fR(8) logfile.
98 .IP "\fBipc_timeout (3600s)\fR"
99 The time limit for sending or receiving information over an internal
100 communication channel.
101 .IP "\fBinternal_mail_filter_classes (empty)\fR"
102 What categories of Postfix-generated mail are subject to
103 before-queue content inspection by non_smtpd_milters, header_checks
104 and body_checks.
105 .IP "\fBmail_name (Postfix)\fR"
106 The mail system name that is displayed in Received: headers, in
107 the SMTP greeting banner, and in bounced mail.
108 .IP "\fBmax_idle (100s)\fR"
109 The maximum amount of time that an idle Postfix daemon process waits
110 for an incoming connection before terminating voluntarily.
111 .IP "\fBmax_use (100)\fR"
112 The maximal number of incoming connections that a Postfix daemon
113 process will service before terminating voluntarily.
114 .IP "\fBnotify_classes (resource, software)\fR"
115 The list of error classes that are reported to the postmaster.
116 .IP "\fBprocess_id (read-only)\fR"
117 The process ID of a Postfix command or daemon process.
118 .IP "\fBprocess_name (read-only)\fR"
119 The process name of a Postfix command or daemon process.
120 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
121 The location of the Postfix top-level queue directory.
122 .IP "\fBsyslog_facility (mail)\fR"
123 The syslog facility of Postfix logging.
124 .IP "\fBsyslog_name (see 'postconf -d' output)\fR"
125 The mail system name that is prepended to the process name in syslog
126 records, so that "smtpd" becomes, for example, "postfix/smtpd".
127 .SH "FILES"
128 .na
129 .nf
130 /var/spool/postfix/bounce/* non-delivery records
131 /var/spool/postfix/defer/* non-delivery records
132 /var/spool/postfix/trace/* delivery status records
133 .SH "SEE ALSO"
134 .na
135 .nf
136 bounce(5), bounce message template format
137 qmgr(8), queue manager
138 postconf(5), configuration parameters
139 master(5), generic daemon options
140 master(8), process manager
141 syslogd(8), system logging
142 .SH "LICENSE"
143 .na
144 .nf
145 .ad
146 .fi
147 The Secure Mailer license must be distributed with this software.
148 .SH "AUTHOR(S)"
149 .na
150 .nf
151 Wietse Venema
152 IBM T.J. Watson Research
153 P.O. Box 704
154 Yorktown Heights, NY 10598, USA