13
13
<b>pipe</b> [generic Postfix daemon options] command_attributes...
16
The <a href="pipe.8.html"><b>pipe</b>(8)</a> daemon processes requests from the Postfix
17
queue manager to deliver messages to external commands.
18
This program expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process
21
Message attributes such as sender address, recipient
22
address and next-hop host name can be specified as com-
23
mand-line macros that are expanded before the external
26
The <a href="pipe.8.html"><b>pipe</b>(8)</a> daemon updates queue files and marks recipi-
27
ents as finished, or it informs the queue manager that
28
delivery should be tried again at a later time. Delivery
29
status reports are sent to the <a href="bounce.8.html"><b>bounce</b>(8)</a>, <a href="defer.8.html"><b>defer</b>(8)</a> or
30
<a href="trace.8.html"><b>trace</b>(8)</a> daemon as appropriate.
16
The <a href="pipe.8.html"><b>pipe</b>(8)</a> daemon processes requests from the Postfix queue manager to
17
deliver messages to external commands. This program expects to be run
18
from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
20
Message attributes such as sender address, recipient address and next-
21
hop host name can be specified as command-line macros that are expanded
22
before the external command is executed.
24
The <a href="pipe.8.html"><b>pipe</b>(8)</a> daemon updates queue files and marks recipients as fin-
25
ished, or it informs the queue manager that delivery should be tried
26
again at a later time. Delivery status reports are sent to the
27
<a href="bounce.8.html"><b>bounce</b>(8)</a>, <a href="defer.8.html"><b>defer</b>(8)</a> or <a href="trace.8.html"><b>trace</b>(8)</a> daemon as appropriate.
32
29
<b>SINGLE-RECIPIENT DELIVERY</b>
33
Some destinations cannot handle more than one recipient
34
per delivery request. Examples are pagers or fax machines.
35
In addition, multi-recipient delivery is undesirable when
36
prepending a <b>Delivered-to:</b> or <b>X-Original-To:</b> message
30
Some destinations cannot handle more than one recipient per delivery
31
request. Examples are pagers or fax machines. In addition, multi-
32
recipient delivery is undesirable when prepending a <b>Delivered-to:</b> or <b>X-</b>
33
<b>Original-To:</b> message header.
39
To prevent Postfix from sending multiple recipients per
40
delivery request, specify
35
To prevent Postfix from sending multiple recipients per delivery
42
38
<b><a href="postconf.5.html#transport_destination_recipient_limit"><i>transport</i>_destination_recipient_limit</a> = 1</b>
44
in the Postfix <a href="postconf.5.html"><b>main.cf</b></a> file, where <i>transport</i> is the name
45
in the first column of the Postfix <a href="master.5.html"><b>master.cf</b></a> entry for the
46
pipe-based delivery transport.
40
in the Postfix <a href="postconf.5.html"><b>main.cf</b></a> file, where <i>transport</i> is the name in the first
41
column of the Postfix <a href="master.5.html"><b>master.cf</b></a> entry for the pipe-based delivery
48
44
<b>COMMAND ATTRIBUTE SYNTAX</b>
49
The external command attributes are given in the <a href="master.5.html"><b>master.cf</b></a>
50
file at the end of a service definition. The syntax is as
45
The external command attributes are given in the <a href="master.5.html"><b>master.cf</b></a> file at the
46
end of a service definition. The syntax is as follows:
53
48
<b>chroot=</b><i>pathname</i> (optional)
54
Change the process root directory and working
55
directory to the named directory. This happens
56
before switching to the privileges specified with
57
the <b>user</b> attribute, and before executing the
58
optional <b>directory=</b><i>pathname</i> directive. Delivery is
59
deferred in case of failure.
49
Change the process root directory and working directory to the
50
named directory. This happens before switching to the privileges
51
specified with the <b>user</b> attribute, and before executing the
52
optional <b>directory=</b><i>pathname</i> directive. Delivery is deferred in
61
55
This feature is available as of Postfix 2.3.
63
57
<b>directory=</b><i>pathname</i> (optional)
64
Change to the named directory before executing the
65
external command. The directory must be accessible
66
for the user specified with the <b>user</b> attribute (see
67
below). The default working directory is
68
<b>$<a href="postconf.5.html#queue_directory">queue_directory</a></b>. Delivery is deferred in case of
58
Change to the named directory before executing the external com-
59
mand. The directory must be accessible for the user specified
60
with the <b>user</b> attribute (see below). The default working direc-
61
tory is <b>$<a href="postconf.5.html#queue_directory">queue_directory</a></b>. Delivery is deferred in case of fail-
71
64
This feature is available as of Postfix 2.2.
73
66
<b>eol=</b><i>string</i> (optional, default: <b>\n</b>)
74
The output record delimiter. Typically one would
75
use either <b>\r\n</b> or <b>\n</b>. The usual C-style backslash
76
escape sequences are recognized: <b>\a \b \f \n \r \t</b>
77
<b>\v \</b><i>ddd</i> (up to three octal digits) and <b>\\</b>.
67
The output record delimiter. Typically one would use either <b>\r\n</b>
68
or <b>\n</b>. The usual C-style backslash escape sequences are recog-
69
nized: <b>\a \b \f \n \r \t \v \</b><i>ddd</i> (up to three octal digits) and
79
72
<b>flags=BDFORXhqu.</b>> (optional)
80
Optional message processing flags. By default, a
81
message is copied unchanged.
83
<b>B</b> Append a blank line at the end of each mes-
84
sage. This is required by some mail user
85
agents that recognize "<b>From</b> " lines only
86
when preceded by a blank line.
88
<b>D</b> Prepend a "<b>Delivered-To:</b> <i>recipient</i>" message
89
header with the envelope recipient address.
90
Note: for this to work, the <i>transport</i><b>_desti-</b>
91
<b>nation_recipient_limit</b> must be 1 (see SIN-
92
GLE-RECIPIENT DELIVERY above for details).
94
The <b>D</b> flag also enforces loop detection
95
(Postfix 2.5 and later): if a message
96
already contains a <b>Delivered-To:</b> header with
97
the same recipient address, then the message
98
is returned as undeliverable. The address
99
comparison is case insensitive.
101
This feature is available as of Postfix 2.0.
103
<b>F</b> Prepend a "<b>From</b> <i>sender time</i><b>_</b><i>stamp</i>" envelope
104
header to the message content. This is
73
Optional message processing flags. By default, a message is
76
<b>B</b> Append a blank line at the end of each message. This is
77
required by some mail user agents that recognize "<b>From</b> "
78
lines only when preceded by a blank line.
80
<b>D</b> Prepend a "<b>Delivered-To:</b> <i>recipient</i>" message header with
81
the envelope recipient address. Note: for this to work,
82
the <b><a href="postconf.5.html#transport_destination_recipient_limit"><i>transport</i>_destination_recipient_limit</a></b> must be 1 (see
83
SINGLE-RECIPIENT DELIVERY above for details).
85
The <b>D</b> flag also enforces loop detection (Postfix 2.5 and
86
later): if a message already contains a <b>Delivered-To:</b>
87
header with the same recipient address, then the message
88
is returned as undeliverable. The address comparison is
91
This feature is available as of Postfix 2.0.
93
<b>F</b> Prepend a "<b>From</b> <i>sender time</i><b>_</b><i>stamp</i>" envelope header to the
94
message content. This is expected by, for example, <b>UUCP</b>
97
<b>O</b> Prepend an "<b>X-Original-To:</b> <i>recipient</i>" message header with
98
the recipient address as given to Postfix. Note: for this
99
to work, the <b><a href="postconf.5.html#transport_destination_recipient_limit"><i>transport</i>_destination_recipient_limit</a></b> must
100
be 1 (see SINGLE-RECIPIENT DELIVERY above for details).
102
This feature is available as of Postfix 2.0.
104
<b>R</b> Prepend a <b>Return-Path:</b> message header with the envelope
107
<b>X</b> Indicate that the external command performs final deliv-
108
ery. This flag affects the status reported in "success"
109
DSN (delivery status notification) messages, and changes
110
it from "relayed" into "delivered".
112
This feature is available as of Postfix 2.5.
114
<b>h</b> Fold the command-line <b>$original_recipient</b> and <b>$recipient</b>
115
address domain part (text to the right of the right-most
116
<b>@</b> character) to lower case; fold the entire command-line
117
<b>$domain</b> and <b>$nexthop</b> host or domain information to lower
118
case. This is recommended for delivery via <b>UUCP</b>.
120
<b>q</b> Quote white space and other special characters in the
121
command-line <b>$sender</b>, <b>$original_recipient</b> and <b>$recipient</b>
122
address localparts (text to the left of the right-most <b>@</b>
123
character), according to an 8-bit transparent version of
124
<a href="http://tools.ietf.org/html/rfc822">RFC 822</a>. This is recommended for delivery via <b>UUCP</b> or
127
The result is compatible with the address parsing of com-
128
mand-line recipients by the Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> mail sub-
131
The <b>q</b> flag affects only entire addresses, not the partial
132
address information from the <b>$user</b>, <b>$extension</b> or <b>$mail-</b>
133
<b>box</b> command-line macros.
135
<b>u</b> Fold the command-line <b>$original_recipient</b> and <b>$recipient</b>
136
address localpart (text to the left of the right-most <b>@</b>
137
character) to lower case. This is recommended for deliv-
140
<b>.</b> Prepend "<b>.</b>" to lines starting with "<b>.</b>". This is needed
141
by, for example, <b>BSMTP</b> software.
143
> Prepend ">" to lines starting with "<b>From</b> ". This is
105
144
expected by, for example, <b>UUCP</b> software.
107
<b>O</b> Prepend an "<b>X-Original-To:</b> <i>recipient</i>" mes-
108
sage header with the recipient address as
109
given to Postfix. Note: for this to work,
110
the <b><a href="postconf.5.html#transport_destination_recipient_limit"><i>transport</i>_destination_recipient_limit</a></b>
111
must be 1 (see SINGLE-RECIPIENT DELIVERY
114
This feature is available as of Postfix 2.0.
116
<b>R</b> Prepend a <b>Return-Path:</b> message header with
117
the envelope sender address.
119
<b>X</b> Indicate that the external command performs
120
final delivery. This flag affects the sta-
121
tus reported in "success" DSN (delivery sta-
122
tus notification) messages, and changes it
123
from "relayed" into "delivered".
125
This feature is available as of Postfix 2.5.
127
<b>h</b> Fold the command-line <b>$original_recipient</b>
128
and <b>$recipient</b> address domain part (text to
129
the right of the right-most <b>@</b> character) to
130
lower case; fold the entire command-line
131
<b>$domain</b> and <b>$nexthop</b> host or domain informa-
132
tion to lower case. This is recommended for
133
delivery via <b>UUCP</b>.
135
<b>q</b> Quote white space and other special charac-
136
ters in the command-line <b>$sender</b>, <b>$origi-</b>
137
<b>nal_recipient</b> and <b>$recipient</b> address local-
138
parts (text to the left of the right-most <b>@</b>
139
character), according to an 8-bit transpar-
140
ent version of <a href="http://tools.ietf.org/html/rfc822">RFC 822</a>. This is recommended
141
for delivery via <b>UUCP</b> or <b>BSMTP</b>.
143
The result is compatible with the address
144
parsing of command-line recipients by the
145
Postfix <a href="sendmail.1.html"><b>sendmail</b>(1)</a> mail submission command.
147
The <b>q</b> flag affects only entire addresses,
148
not the partial address information from the
149
<b>$user</b>, <b>$extension</b> or <b>$mailbox</b> command-line
152
<b>u</b> Fold the command-line <b>$original_recipient</b>
153
and <b>$recipient</b> address localpart (text to
154
the left of the right-most <b>@</b> character) to
155
lower case. This is recommended for deliv-
158
<b>.</b> Prepend "<b>.</b>" to lines starting with "<b>.</b>". This
159
is needed by, for example, <b>BSMTP</b> software.
161
> Prepend ">" to lines starting with "<b>From</b> ".
162
This is expected by, for example, <b>UUCP</b> soft-
165
146
<b>null_sender</b>=<i>replacement</i> (default: MAILER-DAEMON)
166
Replace the null sender address (typically used for
167
delivery status notifications) with the specified
168
text when expanding the <b>$sender</b> command-line macro,
169
and when generating a From_ or Return-Path: message
172
If the null sender replacement text is a non-empty
173
string then it is affected by the <b>q</b> flag for
147
Replace the null sender address (typically used for delivery
148
status notifications) with the specified text when expanding the
149
<b>$sender</b> command-line macro, and when generating a From_ or
150
Return-Path: message header.
152
If the null sender replacement text is a non-empty string then
153
it is affected by the <b>q</b> flag for address quoting in command-line
156
The null sender replacement text may be empty; this form is rec-
157
ommended for content filters that feed mail back into Postfix.
158
The empty sender address is not affected by the <b>q</b> flag for
174
159
address quoting in command-line arguments.
176
The null sender replacement text may be empty; this
177
form is recommended for content filters that feed
178
mail back into Postfix. The empty sender address is
179
not affected by the <b>q</b> flag for address quoting in
180
command-line arguments.
182
Caution: a null sender address is easily mis-parsed
183
by naive software. For example, when the <a href="pipe.8.html"><b>pipe</b>(8)</a>
184
daemon executes a command such as:
161
Caution: a null sender address is easily mis-parsed by naive
162
software. For example, when the <a href="pipe.8.html"><b>pipe</b>(8)</a> daemon executes a com-
186
165
<i>Wrong</i>: command -f$sender -- $recipient
188
the command will mis-parse the -f option value when
189
the sender address is a null string. For correct
190
parsing, specify <b>$sender</b> as an argument by itself:
167
the command will mis-parse the -f option value when the sender
168
address is a null string. For correct parsing, specify <b>$sender</b>
169
as an argument by itself:
192
171
<i>Right</i>: command -f $sender -- $recipient
194
173
This feature is available as of Postfix 2.3.
196
175
<b>size</b>=<i>size</i><b>_</b><i>limit</i> (optional)
197
Don't deliver messages that exceed this size limit
198
(in bytes); return them to the sender instead.
176
Don't deliver messages that exceed this size limit (in bytes);
177
return them to the sender instead.
200
179
<b>user</b>=<i>username</i> (required)
202
181
<b>user</b>=<i>username</i>:<i>groupname</i>
203
Execute the external command with the user ID and
204
group ID of the specified <i>username</i>. The software
205
refuses to execute commands with root privileges,
206
or with the privileges of the mail system owner. If
207
<i>groupname</i> is specified, the corresponding group ID
208
is used instead of the group ID of <i>username</i>.
182
Execute the external command with the user ID and group ID of
183
the specified <i>username</i>. The software refuses to execute com-
184
mands with root privileges, or with the privileges of the mail
185
system owner. If <i>groupname</i> is specified, the corresponding group
186
ID is used instead of the group ID of <i>username</i>.
210
188
<b>argv</b>=<i>command</i>... (required)
211
The command to be executed. This must be specified
212
as the last command attribute. The command is exe-
213
cuted directly, i.e. without interpretation of
214
shell meta characters by a shell command inter-
217
In the command argument vector, the following
218
macros are recognized and replaced with correspond-
219
ing information from the Postfix queue manager
222
In addition to the form ${<i>name</i>}, the forms $<i>name</i>
223
and $(<i>name</i>) are also recognized. Specify <b>$$</b> where
224
a single <b>$</b> is wanted.
226
<b>${client_address</b>}
227
This macro expands to the remote client net-
230
This feature is available as of Postfix 2.2.
232
<b>${client_helo</b>}
233
This macro expands to the remote client HELO
236
This feature is available as of Postfix 2.2.
238
<b>${client_hostname</b>}
239
This macro expands to the remote client
242
This feature is available as of Postfix 2.2.
244
<b>${client_port</b>}
245
This macro expands to the remote client TCP
248
This feature is available as of Postfix 2.5.
250
<b>${client_protocol</b>}
251
This macro expands to the remote client pro-
254
This feature is available as of Postfix 2.2.
257
This macro expands to the domain portion of
258
the recipient address. For example, with an
259
address <i>user+foo@domain</i> the domain is
262
This information is modified by the <b>h</b> flag
265
This feature is available as of Postfix 2.5.
268
This macro expands to the extension part of
269
a recipient address. For example, with an
270
address <i>user+foo@domain</i> the extension is
273
A command-line argument that contains
274
<b>${extension</b>} expands into as many command-
275
line arguments as there are recipients.
277
This information is modified by the <b>u</b> flag
281
This macro expands to the complete local
282
part of a recipient address. For example,
283
with an address <i>user+foo@domain</i> the mailbox
286
A command-line argument that contains
287
<b>${mailbox</b>} expands to as many command-line
288
arguments as there are recipients.
290
This information is modified by the <b>u</b> flag
189
The command to be executed. This must be specified as the last
190
command attribute. The command is executed directly, i.e. with-
191
out interpretation of shell meta characters by a shell command
194
In the command argument vector, the following macros are recog-
195
nized and replaced with corresponding information from the Post-
196
fix queue manager delivery request.
198
In addition to the form ${<i>name</i>}, the forms $<i>name</i> and $(<i>name</i>) are
199
also recognized. Specify <b>$$</b> where a single <b>$</b> is wanted.
201
<b>${client_address}</b>
202
This macro expands to the remote client network address.
204
This feature is available as of Postfix 2.2.
206
<b>${client_helo}</b>
207
This macro expands to the remote client HELO command
210
This feature is available as of Postfix 2.2.
212
<b>${client_hostname}</b>
213
This macro expands to the remote client hostname.
215
This feature is available as of Postfix 2.2.
217
<b>${client_port}</b>
218
This macro expands to the remote client TCP port number.
220
This feature is available as of Postfix 2.5.
222
<b>${client_protocol}</b>
223
This macro expands to the remote client protocol.
225
This feature is available as of Postfix 2.2.
228
This macro expands to the domain portion of the recipient
229
address. For example, with an address <i>user+foo@domain</i>
230
the domain is <i>domain</i>.
232
This information is modified by the <b>h</b> flag for case fold-
235
This feature is available as of Postfix 2.5.
238
This macro expands to the extension part of a recipient
239
address. For example, with an address <i>user+foo@domain</i>
240
the extension is <i>foo</i>.
242
A command-line argument that contains <b>${extension}</b>
243
expands into as many command-line arguments as there are
246
This information is modified by the <b>u</b> flag for case fold-
250
This macro expands to the complete local part of a recip-
251
ient address. For example, with an address
252
<i>user+foo@domain</i> the mailbox is <i>user+foo</i>.
254
A command-line argument that contains <b>${mailbox}</b> expands
255
to as many command-line arguments as there are recipi-
258
This information is modified by the <b>u</b> flag for case fold-
294
262
This macro expands to the next-hop hostname.
296
This information is modified by the <b>h</b> flag
299
<b>${original_recipient</b>}
300
This macro expands to the complete recipient
301
address before any address rewriting or
304
A command-line argument that contains
305
<b>${original_recipient</b>} expands to as many
306
command-line arguments as there are recipi-
309
This information is modified by the <b>hqu</b>
310
flags for quoting and case folding.
264
This information is modified by the <b>h</b> flag for case fold-
267
<b>${original_recipient}</b>
268
This macro expands to the complete recipient address
269
before any address rewriting or aliasing.
271
A command-line argument that contains <b>${original_recipi-</b>
272
<b>ent}</b> expands to as many command-line arguments as there
275
This information is modified by the <b>hqu</b> flags for quoting
312
278
This feature is available as of Postfix 2.5.
315
This macro expands to the complete recipient
318
A command-line argument that contains
319
<b>${recipient</b>} expands to as many command-line
320
arguments as there are recipients.
322
This information is modified by the <b>hqu</b>
323
flags for quoting and case folding.
325
<b>${sasl_method</b>}
326
This macro expands to the name of the SASL
327
authentication mechanism in the AUTH command
328
when the Postfix SMTP server received the
331
This feature is available as of Postfix 2.2.
333
<b>${sasl_sender</b>}
334
This macro expands to the SASL sender name
335
(i.e. the original submitter as per <a href="http://tools.ietf.org/html/rfc4954">RFC</a>
336
<a href="http://tools.ietf.org/html/rfc4954">4954</a>) in the MAIL FROM command when the
337
Postfix SMTP server received the message.
339
This feature is available as of Postfix 2.2.
341
<b>${sasl_username</b>}
342
This macro expands to the SASL user name in
343
the AUTH command when the Postfix SMTP
281
This macro expands to the queue id.
283
This feature is available as of Postfix 2.11.
286
This macro expands to the complete recipient address.
288
A command-line argument that contains <b>${recipient}</b>
289
expands to as many command-line arguments as there are
292
This information is modified by the <b>hqu</b> flags for quoting
295
<b>${sasl_method}</b>
296
This macro expands to the name of the SASL authentication
297
mechanism in the AUTH command when the Postfix SMTP
344
298
server received the message.
346
300
This feature is available as of Postfix 2.2.
349
This macro expands to the envelope sender
350
address. By default, the null sender address
351
expands to MAILER-DAEMON; this can be
352
changed with the <b>null_sender</b> attribute, as
355
This information is modified by the <b>q</b> flag
359
This macro expands to Postfix's idea of the
360
message size, which is an approximation of
361
the size of the message as delivered.
364
This macro expands to the username part of a
365
recipient address. For example, with an
366
address <i>user+foo@domain</i> the username part is
369
A command-line argument that contains
370
<b>${user</b>} expands into as many command-line
371
arguments as there are recipients.
373
This information is modified by the <b>u</b> flag
302
<b>${sasl_sender}</b>
303
This macro expands to the SASL sender name (i.e. the
304
original submitter as per <a href="http://tools.ietf.org/html/rfc4954">RFC 4954</a>) in the MAIL FROM com-
305
mand when the Postfix SMTP server received the message.
307
This feature is available as of Postfix 2.2.
309
<b>${sasl_username}</b>
310
This macro expands to the SASL user name in the AUTH com-
311
mand when the Postfix SMTP server received the message.
313
This feature is available as of Postfix 2.2.
316
This macro expands to the envelope sender address. By
317
default, the null sender address expands to MAILER-DAE-
318
MON; this can be changed with the <b>null_sender</b> attribute,
321
This information is modified by the <b>q</b> flag for quoting.
324
This macro expands to Postfix's idea of the message size,
325
which is an approximation of the size of the message as
329
This macro expands to the username part of a recipient
330
address. For example, with an address <i>user+foo@domain</i>
331
the username part is <i>user</i>.
333
A command-line argument that contains <b>${user}</b> expands
334
into as many command-line arguments as there are recipi-
337
This information is modified by the <b>u</b> flag for case fold-
377
341
<a href="http://tools.ietf.org/html/rfc3463">RFC 3463</a> (Enhanced status codes)
379
343
<b>DIAGNOSTICS</b>
380
Command exit status codes are expected to follow the con-
381
ventions defined in <<b>sysexits.h</b>>. Exit status 0 means
382
normal successful completion.
344
Command exit status codes are expected to follow the conventions
345
defined in <<b>sysexits.h</b>>. Exit status 0 means normal successful comple-
384
In the case of a non-zero exit status, a limited amount of
385
command output is reported in an delivery status notifica-
386
tion. When the output begins with a 4.X.X or 5.X.X
387
enhanced status code, the status code takes precedence
388
over the non-zero exit status (Postfix version 2.3 and
348
In the case of a non-zero exit status, a limited amount of command out-
349
put is reported in an delivery status notification. When the output
350
begins with a 4.X.X or 5.X.X enhanced status code, the status code
351
takes precedence over the non-zero exit status (Postfix version 2.3 and
391
Problems and transactions are logged to <b>syslogd</b>(8). Cor-
392
rupted message files are marked so that the queue manager
393
can move them to the <b>corrupt</b> queue for further inspection.
354
Problems and transactions are logged to <b>syslogd</b>(8). Corrupted message
355
files are marked so that the queue manager can move them to the <b>corrupt</b>
356
queue for further inspection.
396
This program needs a dual personality 1) to access the
397
private Postfix queue and IPC mechanisms, and 2) to exe-
398
cute external commands as the specified user. It is there-
399
fore security sensitive.
359
This program needs a dual personality 1) to access the private Postfix
360
queue and IPC mechanisms, and 2) to execute external commands as the
361
specified user. It is therefore security sensitive.
401
363
<b>CONFIGURATION PARAMETERS</b>
402
Changes to <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically as <a href="pipe.8.html"><b>pipe</b>(8)</a>
403
processes run for only a limited amount of time. Use the
404
command "<b>postfix reload</b>" to speed up a change.
364
Changes to <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically as <a href="pipe.8.html"><b>pipe</b>(8)</a> processes run
365
for only a limited amount of time. Use the command "<b>postfix reload</b>" to
406
The text below provides only a parameter summary. See
407
<a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples.
368
The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
369
more details including examples.
409
371
<b>RESOURCE AND RATE CONTROLS</b>
410
In the text below, <i>transport</i> is the first field in a <b>mas-</b>
413
<b><a href="postconf.5.html#transport_destination_concurrency_limit"><i>transport</i>_destination_concurrency_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_limit">default_destina</a>-</b>
414
<b><a href="postconf.5.html#default_destination_concurrency_limit">tion_concurrency_limit</a>)</b>
415
Limit the number of parallel deliveries to the same
416
destination, for delivery via the named <i>transport</i>.
417
The limit is enforced by the Postfix queue manager.
419
<b><a href="postconf.5.html#transport_destination_recipient_limit"><i>transport</i>_destination_recipient_limit</a> ($<a href="postconf.5.html#default_destination_recipient_limit">default_destina</a>-</b>
420
<b><a href="postconf.5.html#default_destination_recipient_limit">tion_recipient_limit</a>)</b>
421
Limit the number of recipients per message deliv-
422
ery, for delivery via the named <i>transport</i>. The
423
limit is enforced by the Postfix queue manager.
372
In the text below, <i>transport</i> is the first field in a <a href="master.5.html"><b>master.cf</b></a> entry.
374
<b><a href="postconf.5.html#transport_destination_concurrency_limit"><i>transport</i>_destination_concurrency_limit</a> ($<a href="postconf.5.html#default_destination_concurrency_limit">default_destination_concur</a>-</b>
375
<b><a href="postconf.5.html#default_destination_concurrency_limit">rency_limit</a>)</b>
376
Limit the number of parallel deliveries to the same destination,
377
for delivery via the named <i>transport</i>. The limit is enforced by
378
the Postfix queue manager.
380
<b><a href="postconf.5.html#transport_destination_recipient_limit"><i>transport</i>_destination_recipient_limit</a> ($<a href="postconf.5.html#default_destination_recipient_limit">default_destination_recipi</a>-</b>
381
<b><a href="postconf.5.html#default_destination_recipient_limit">ent_limit</a>)</b>
382
Limit the number of recipients per message delivery, for deliv-
383
ery via the named <i>transport</i>. The limit is enforced by the Post-
425
386
<b><a href="postconf.5.html#transport_time_limit"><i>transport</i>_time_limit</a> ($<a href="postconf.5.html#command_time_limit">command_time_limit</a>)</b>
426
Limit the time for delivery to external command,
427
for delivery via the named <i>transport</i>. The limit is
428
enforced by the pipe delivery agent.
387
Limit the time for delivery to external command, for delivery
388
via the named <i>transport</i>. The limit is enforced by the pipe
430
Postfix 2.4 and later support a suffix that speci-
431
fies the time unit: s (seconds), m (minutes), h
432
(hours), d (days), w (weeks). The default time unit
391
Postfix 2.4 and later support a suffix that specifies the time
392
unit: s (seconds), m (minutes), h (hours), d (days), w (weeks).
393
The default time unit is seconds.
435
395
<b>MISCELLANEOUS CONTROLS</b>
436
396
<b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
437
The default location of the Postfix <a href="postconf.5.html">main.cf</a> and
438
<a href="master.5.html">master.cf</a> configuration files.
397
The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
440
400
<b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
441
How much time a Postfix daemon process may take to
442
handle a request before it is terminated by a
443
built-in watchdog timer.
401
How much time a Postfix daemon process may take to handle a
402
request before it is terminated by a built-in watchdog timer.
445
404
<b><a href="postconf.5.html#delay_logging_resolution_limit">delay_logging_resolution_limit</a> (2)</b>
446
The maximal number of digits after the decimal
447
point when logging sub-second delay values.
405
The maximal number of digits after the decimal point when log-
406
ging sub-second delay values.
449
408
<b><a href="postconf.5.html#export_environment">export_environment</a> (see 'postconf -d' output)</b>
450
The list of environment variables that a Postfix
451
process will export to non-Postfix processes.
409
The list of environment variables that a Postfix process will
410
export to non-Postfix processes.
453
412
<b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
454
The time limit for sending or receiving information
455
over an internal communication channel.
413
The time limit for sending or receiving information over an
414
internal communication channel.
457
416
<b><a href="postconf.5.html#mail_owner">mail_owner</a> (postfix)</b>
458
The UNIX system account that owns the Postfix queue
459
and most Postfix daemon processes.
417
The UNIX system account that owns the Postfix queue and most
418
Postfix daemon processes.
461
420
<b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
462
The maximum amount of time that an idle Postfix
463
daemon process waits for an incoming connection
464
before terminating voluntarily.
421
The maximum amount of time that an idle Postfix daemon process
422
waits for an incoming connection before terminating voluntarily.
466
424
<b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
467
The maximal number of incoming connections that a
468
Postfix daemon process will service before termi-
425
The maximal number of incoming connections that a Postfix daemon
426
process will service before terminating voluntarily.
471
428
<b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
472
The process ID of a Postfix command or daemon
429
The process ID of a Postfix command or daemon process.
475
431
<b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
476
The process name of a Postfix command or daemon
432
The process name of a Postfix command or daemon process.
479
434
<b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
480
The location of the Postfix top-level queue direc-
435
The location of the Postfix top-level queue directory.
483
437
<b><a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a> (empty)</b>
484
The separator between user names and address exten-
438
The set of characters that can separate a user name from its
439
extension (example: user+foo), or a .forward file name from its
440
extension (example: .forward+foo).
487
442
<b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
488
443
The syslog facility of Postfix logging.
490
445
<b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
491
The mail system name that is prepended to the
492
process name in syslog records, so that "smtpd"
493
becomes, for example, "postfix/smtpd".
446
The mail system name that is prepended to the process name in
447
syslog records, so that "smtpd" becomes, for example, "post-
496
451
<a href="qmgr.8.html">qmgr(8)</a>, queue manager