Expand PMF_FN_* macros.
[netbsd-mini2440.git] / external / ibm-public / postfix / dist / man / man8 / local.8
blob1bcdc2a8434e5a44771fc6656318269c30db65f3
1 .\"     $NetBSD$
2 .\"
3 .TH LOCAL 8 
4 .ad
5 .fi
6 .SH NAME
7 local
8 \-
9 Postfix local mail delivery
10 .SH "SYNOPSIS"
11 .na
12 .nf
13 \fBlocal\fR [generic Postfix daemon options]
14 .SH DESCRIPTION
15 .ad
16 .fi
17 The \fBlocal\fR(8) daemon processes delivery requests from the
18 Postfix queue manager to deliver mail to local recipients.
19 Each delivery request specifies a queue file, a sender address,
20 a domain or host to deliver to, and one or more recipients.
21 This program expects to be run from the \fBmaster\fR(8) process
22 manager.
24 The \fBlocal\fR(8) daemon updates queue files and marks recipients
25 as finished, or it informs the queue manager that delivery should
26 be tried again at a later time. Delivery status reports are sent
27 to the \fBbounce\fR(8), \fBdefer\fR(8) or \fBtrace\fR(8) daemon as
28 appropriate.
29 .SH "CASE FOLDING"
30 .na
31 .nf
32 .ad
33 .fi
34 All delivery decisions are made using the bare recipient
35 name (i.e. the address localpart), folded to lower case.
36 See also under ADDRESS EXTENSION below for a few exceptions.
37 .SH "SYSTEM-WIDE AND USER-LEVEL ALIASING"
38 .na
39 .nf
40 .ad
41 .fi
42 The system administrator can set up one or more system-wide
43 \fBsendmail\fR-style alias databases.
44 Users can have \fBsendmail\fR-style ~/.\fBforward\fR files.
45 Mail for \fIname\fR is delivered to the alias \fIname\fR, to
46 destinations in ~\fIname\fR/.\fBforward\fR, to the mailbox owned
47 by the user \fIname\fR, or it is sent back as undeliverable.
49 The system administrator can specify a comma/space separated list
50 of ~\fR/.\fBforward\fR like files through the \fBforward_path\fR
51 configuration parameter. Upon delivery, the local delivery agent
52 tries each pathname in the list until a file is found.
54 Delivery via ~/.\fBforward\fR files is done with the privileges
55 of the recipient.
56 Thus, ~/.\fBforward\fR like files must be readable by the
57 recipient, and their parent directory needs to have "execute"
58 permission for the recipient.
60 The \fBforward_path\fR parameter is subject to interpolation of
61 \fB$user\fR (recipient username), \fB$home\fR (recipient home
62 directory), \fB$shell\fR (recipient shell), \fB$recipient\fR
63 (complete recipient address), \fB$extension\fR (recipient address
64 extension), \fB$domain\fR (recipient domain), \fB$local\fR
65 (entire recipient address localpart) and
66 \fB$recipient_delimiter.\fR The forms \fI${name?value}\fR and
67 \fI${name:value}\fR expand conditionally to \fIvalue\fR when
68 \fI$name\fR is (is not) defined.
69 Characters that may have special meaning to the shell or file system
70 are replaced by underscores.  The list of acceptable characters
71 is specified with the \fBforward_expansion_filter\fR configuration
72 parameter.
74 An alias or ~/.\fBforward\fR file may list any combination of external
75 commands, destination file names, \fB:include:\fR directives, or
76 mail addresses.
77 See \fBaliases\fR(5) for a precise description. Each line in a
78 user's .\fBforward\fR file has the same syntax as the right-hand part
79 of an alias.
81 When an address is found in its own alias expansion, delivery is
82 made to the user instead. When a user is listed in the user's own
83 ~/.\fBforward\fR file, delivery is made to the user's mailbox instead.
84 An empty ~/.\fBforward\fR file means do not forward mail.
86 In order to prevent the mail system from using up unreasonable
87 amounts of memory, input records read from \fB:include:\fR or from
88 ~/.\fBforward\fR files are broken up into chunks of length
89 \fBline_length_limit\fR.
91 While expanding aliases, ~/.\fBforward\fR files, and so on, the
92 program attempts to avoid duplicate deliveries. The
93 \fBduplicate_filter_limit\fR configuration parameter limits the
94 number of remembered recipients.
95 .SH "MAIL FORWARDING"
96 .na
97 .nf
98 .ad
99 .fi
100 For the sake of reliability, forwarded mail is re-submitted as
101 a new message, so that each recipient has a separate on-file
102 delivery status record.
104 In order to stop mail forwarding loops early, the software adds an
105 optional
106 \fBDelivered-To:\fR header with the final envelope recipient address. If
107 mail arrives for a recipient that is already listed in a
108 \fBDelivered-To:\fR header, the message is bounced.
109 .SH "MAILBOX DELIVERY"
114 The default per-user mailbox is a file in the UNIX mail spool
115 directory (\fB/var/mail/\fIuser\fR or \fB/var/spool/mail/\fIuser\fR);
116 the location can be specified with the \fBmail_spool_directory\fR
117 configuration parameter. Specify a name ending in \fB/\fR for
118 \fBqmail\fR-compatible \fBmaildir\fR delivery.
120 Alternatively, the per-user mailbox can be a file in the user's home
121 directory with a name specified via the \fBhome_mailbox\fR
122 configuration parameter. Specify a relative path name. Specify a name
123 ending in \fB/\fR for \fBqmail\fR-compatible \fBmaildir\fR delivery.
125 Mailbox delivery can be delegated to an external command specified
126 with the \fBmailbox_command_maps\fR and \fBmailbox_command\fR
127 configuration parameters. The command
128 executes with the privileges of the recipient user (exceptions:
129 secondary groups are not enabled; in case of delivery as root,
130 the command executes with the privileges of \fBdefault_privs\fR).
132 Mailbox delivery can be delegated to alternative message transports
133 specified in the \fBmaster.cf\fR file.
134 The \fBmailbox_transport_maps\fR and \fBmailbox_transport\fR
135 configuration parameters specify an optional
136 message transport that is to be used for all local recipients,
137 regardless of whether they are found in the UNIX passwd database.
138 The \fBfallback_transport_maps\fR and
139 \fBfallback_transport\fR parameters specify an optional
140 message transport
141 for recipients that are not found in the aliases(5) or UNIX
142 passwd database.
144 In the case of UNIX-style mailbox delivery,
145 the \fBlocal\fR(8) daemon prepends a "\fBFrom \fIsender time_stamp\fR"
146 envelope header to each message, prepends an
147 \fBX-Original-To:\fR header with the recipient address as given to
148 Postfix, prepends an
149 optional \fBDelivered-To:\fR header
150 with the final envelope recipient address, prepends a \fBReturn-Path:\fR
151 header with the envelope sender address, prepends a \fB>\fR character
152 to lines beginning with "\fBFrom \fR", and appends an empty line.
153 The mailbox is locked for exclusive access while delivery is in
154 progress. In case of problems, an attempt is made to truncate the
155 mailbox to its original length.
157 In the case of \fBmaildir\fR delivery, the local daemon prepends
158 an optional
159 \fBDelivered-To:\fR header with the final envelope recipient address,
160 prepends an
161 \fBX-Original-To:\fR header with the recipient address as given to
162 Postfix,
163 and prepends a \fBReturn-Path:\fR header with the envelope sender
164 address.
165 .SH "EXTERNAL COMMAND DELIVERY"
170 The \fBallow_mail_to_commands\fR configuration parameter restricts
171 delivery to external commands. The default setting (\fBalias,
172 forward\fR) forbids command destinations in \fB:include:\fR files.
174 Optionally, the process working directory is changed to the path
175 specified with \fBcommand_execution_directory\fR (Postfix 2.2 and
176 later). Failure to change directory causes mail to be deferred.
178 The \fBcommand_execution_directory\fR parameter value is subject
179 to interpolation of \fB$user\fR (recipient username),
180 \fB$home\fR (recipient home directory), \fB$shell\fR
181 (recipient shell), \fB$recipient\fR (complete recipient
182 address), \fB$extension\fR (recipient address extension),
183 \fB$domain\fR (recipient domain), \fB$local\fR (entire
184 recipient address localpart) and \fB$recipient_delimiter.\fR
185 The forms \fI${name?value}\fR and \fI${name:value}\fR expand
186 conditionally to \fIvalue\fR when \fI$name\fR is (is not)
187 defined.  Characters that may have special meaning to the
188 shell or file system are replaced by underscores.  The list
189 of acceptable characters is specified with the
190 \fBexecution_directory_expansion_filter\fR configuration
191 parameter.
193 The command is executed directly where possible. Assistance by the
194 shell (\fB/bin/sh\fR on UNIX systems) is used only when the command
195 contains shell magic characters, or when the command invokes a shell
196 built-in command.
198 A limited amount of command output (standard output and standard
199 error) is captured for inclusion with non-delivery status reports.
200 A command is forcibly terminated if it does not complete within
201 \fBcommand_time_limit\fR seconds.  Command exit status codes are
202 expected to follow the conventions defined in <\fBsysexits.h\fR>.
203 Exit status 0 means normal successful completion.
205 Postfix version 2.3 and later support RFC 3463-style enhanced
206 status codes.  If a command terminates with a non-zero exit
207 status, and the command output begins with an enhanced
208 status code, this status code takes precedence over the
209 non-zero exit status.
211 A limited amount of message context is exported via environment
212 variables. Characters that may have special meaning to the shell
213 are replaced by underscores.  The list of acceptable characters
214 is specified with the \fBcommand_expansion_filter\fR configuration
215 parameter.
216 .IP \fBSHELL\fR
217 The recipient user's login shell.
218 .IP \fBHOME\fR
219 The recipient user's home directory.
220 .IP \fBUSER\fR
221 The bare recipient name.
222 .IP \fBEXTENSION\fR
223 The optional recipient address extension.
224 .IP \fBDOMAIN\fR
225 The recipient address domain part.
226 .IP \fBLOGNAME\fR
227 The bare recipient name.
228 .IP \fBLOCAL\fR
229 The entire recipient address localpart (text to the left of the
230 rightmost @ character).
231 .IP \fBORIGINAL_RECIPIENT\fR
232 The entire recipient address, before any address rewriting
233 or aliasing (Postfix 2.5 and later).
234 .IP \fBRECIPIENT\fR
235 The entire recipient address.
236 .IP \fBSENDER\fR
237 The entire sender address.
239 Additional remote client information is made available via
240 the following environment variables:
241 .IP \fBCLIENT_ADDRESS\fR
242 Remote client network address. Available as of Postfix 2.2.
243 .IP \fBCLIENT_HELO\fR
244 Remote client EHLO command parameter. Available as of Postfix 2.2.
245 .IP \fBCLIENT_HOSTNAME\fR
246 Remote client hostname. Available as of Postfix 2.2.
247 .IP \fBCLIENT_PROTOCOL\fR
248 Remote client protocol. Available as of Postfix 2.2.
249 .IP \fBSASL_METHOD\fR
250 SASL authentication method specified in the
251 remote client AUTH command. Available as of Postfix 2.2.
252 .IP \fBSASL_SENDER\fR
253 SASL sender address specified in the remote client MAIL
254 FROM command. Available as of Postfix 2.2.
255 .IP \fBSASL_USERNAME\fR
256 SASL username specified in the remote client AUTH command.
257 Available as of Postfix 2.2.
259 The \fBPATH\fR environment variable is always reset to a
260 system-dependent default path, and environment variables
261 whose names are blessed by the \fBexport_environment\fR
262 configuration parameter are exported unchanged.
264 The current working directory is the mail queue directory.
266 The \fBlocal\fR(8) daemon prepends a "\fBFrom \fIsender time_stamp\fR"
267 envelope header to each message, prepends an
268 \fBX-Original-To:\fR header with the recipient address as given to
269 Postfix, prepends an
270 optional \fBDelivered-To:\fR
271 header with the final recipient envelope address, prepends a
272 \fBReturn-Path:\fR header with the sender envelope address,
273 and appends no empty line.
274 .SH "EXTERNAL FILE DELIVERY"
279 The delivery format depends on the destination filename syntax.
280 The default is to use UNIX-style mailbox format.  Specify a name
281 ending in \fB/\fR for \fBqmail\fR-compatible \fBmaildir\fR delivery.
283 The \fBallow_mail_to_files\fR configuration parameter restricts
284 delivery to external files. The default setting (\fBalias,
285 forward\fR) forbids file destinations in \fB:include:\fR files.
287 In the case of UNIX-style mailbox delivery,
288 the \fBlocal\fR(8) daemon prepends a "\fBFrom \fIsender time_stamp\fR"
289 envelope header to each message, prepends an
290 \fBX-Original-To:\fR header with the recipient address as given to
291 Postfix, prepends an
292 optional \fBDelivered-To:\fR
293 header with the final recipient envelope address, prepends a \fB>\fR
294 character to lines beginning with "\fBFrom \fR", and appends an
295 empty line.
296 The envelope sender address is available in the \fBReturn-Path:\fR
297 header.
298 When the destination is a regular file, it is locked for exclusive
299 access while delivery is in progress. In case of problems, an attempt
300 is made to truncate a regular file to its original length.
302 In the case of \fBmaildir\fR delivery, the local daemon prepends
303 an optional
304 \fBDelivered-To:\fR header with the final envelope recipient address,
305 and prepends an
306 \fBX-Original-To:\fR header with the recipient address as given to
307 Postfix.
308 The envelope sender address is available in the \fBReturn-Path:\fR
309 header.
310 .SH "ADDRESS EXTENSION"
315 The optional \fBrecipient_delimiter\fR configuration parameter
316 specifies how to separate address extensions from local recipient
317 names.
319 For example, with "\fBrecipient_delimiter = +\fR", mail for
320 \fIname\fR+\fIfoo\fR is delivered to the alias \fIname\fR+\fIfoo\fR
321 or to the alias \fIname\fR, to the destinations listed in
322 ~\fIname\fR/.\fBforward\fR+\fIfoo\fR or in ~\fIname\fR/.\fBforward\fR,
323 to the mailbox owned by the user \fIname\fR, or it is sent back as
324 undeliverable.
325 .SH "DELIVERY RIGHTS"
330 Deliveries to external files and external commands are made with
331 the rights of the receiving user on whose behalf the delivery is made.
332 In the absence of a user context, the \fBlocal\fR(8) daemon uses the
333 owner rights of the \fB:include:\fR file or alias database.
334 When those files are owned by the superuser, delivery is made with
335 the rights specified with the \fBdefault_privs\fR configuration
336 parameter.
337 .SH "STANDARDS"
340 RFC 822 (ARPA Internet Text Messages)
341 RFC 3463 (Enhanced status codes)
342 .SH DIAGNOSTICS
345 Problems and transactions are logged to \fBsyslogd\fR(8).
346 Corrupted message files are marked so that the queue
347 manager can move them to the \fBcorrupt\fR queue afterwards.
349 Depending on the setting of the \fBnotify_classes\fR parameter,
350 the postmaster is notified of bounces and of other trouble.
351 .SH "SECURITY"
356 The \fBlocal\fR(8) delivery agent needs a dual personality
357 1) to access the private Postfix queue and IPC mechanisms,
358 2) to impersonate the recipient and deliver to recipient-specified
359 files or commands. It is therefore security sensitive.
361 The \fBlocal\fR(8) delivery agent disallows regular expression
362 substitution of $1 etc. in \fBalias_maps\fR, because that
363 would open a security hole.
365 The \fBlocal\fR(8) delivery agent will silently ignore
366 requests to use the \fBproxymap\fR(8) server within
367 \fBalias_maps\fR. Instead it will open the table directly.
368 Before Postfix version 2.2, the \fBlocal\fR(8) delivery
369 agent will terminate with a fatal error.
370 .SH BUGS
373 For security reasons, the message delivery status of external commands
374 or of external files is never checkpointed to file. As a result,
375 the program may occasionally deliver more than once to a command or
376 external file. Better safe than sorry.
378 Mutually-recursive aliases or ~/.\fBforward\fR files are not detected
379 early.  The resulting mail forwarding loop is broken by the use of the
380 \fBDelivered-To:\fR message header.
381 .SH "CONFIGURATION PARAMETERS"
386 Changes to \fBmain.cf\fR are picked up automatically, as \fBlocal\fR(8)
387 processes run for only a limited amount of time. Use the command
388 "\fBpostfix reload\fR" to speed up a change.
390 The text below provides only a parameter summary. See
391 \fBpostconf\fR(5) for more details including examples.
392 .SH "COMPATIBILITY CONTROLS"
397 .IP "\fBbiff (yes)\fR"
398 Whether or not to use the local biff service.
399 .IP "\fBexpand_owner_alias (no)\fR"
400 When delivering to an alias "aliasname" that has an "owner-aliasname"
401 companion alias, set the envelope sender address to the expansion
402 of the "owner-aliasname" alias.
403 .IP "\fBowner_request_special (yes)\fR"
404 Give special treatment to owner-listname and listname-request
405 address localparts: don't split such addresses when the
406 recipient_delimiter is set to "-".
407 .IP "\fBsun_mailtool_compatibility (no)\fR"
408 Obsolete SUN mailtool compatibility feature.
410 Available in Postfix version 2.3 and later:
411 .IP "\fBfrozen_delivered_to (yes)\fR"
412 Update the \fBlocal\fR(8) delivery agent's idea of the Delivered-To:
413 address (see prepend_delivered_header) only once, at the start of
414 a delivery attempt; do not update the Delivered-To: address while
415 expanding aliases or .forward files.
417 Available in Postfix version 2.5.3 and later:
418 .IP "\fBstrict_mailbox_ownership (yes)\fR"
419 Defer delivery when a mailbox file is not owned by its recipient.
420 .SH "DELIVERY METHOD CONTROLS"
425 The precedence of \fBlocal\fR(8) delivery methods from high to low is:
426 aliases, .forward files, mailbox_transport_maps,
427 mailbox_transport, mailbox_command_maps, mailbox_command,
428 home_mailbox, mail_spool_directory, fallback_transport_maps,
429 fallback_transport, and luser_relay.
430 .IP "\fBalias_maps (see 'postconf -d' output)\fR"
431 The alias databases that are used for \fBlocal\fR(8) delivery.
432 .IP "\fBforward_path (see 'postconf -d' output)\fR"
433 The \fBlocal\fR(8) delivery agent search list for finding a .forward
434 file with user-specified delivery methods.
435 .IP "\fBmailbox_transport_maps (empty)\fR"
436 Optional lookup tables with per-recipient message delivery
437 transports to use for \fBlocal\fR(8) mailbox delivery, whether or not the
438 recipients are found in the UNIX passwd database.
439 .IP "\fBmailbox_transport (empty)\fR"
440 Optional message delivery transport that the \fBlocal\fR(8) delivery
441 agent should use for mailbox delivery to all local recipients,
442 whether or not they are found in the UNIX passwd database.
443 .IP "\fBmailbox_command_maps (empty)\fR"
444 Optional lookup tables with per-recipient external commands to use
445 for \fBlocal\fR(8) mailbox delivery.
446 .IP "\fBmailbox_command (empty)\fR"
447 Optional external command that the \fBlocal\fR(8) delivery agent should
448 use for mailbox delivery.
449 .IP "\fBhome_mailbox (empty)\fR"
450 Optional pathname of a mailbox file relative to a \fBlocal\fR(8) user's
451 home directory.
452 .IP "\fBmail_spool_directory (see 'postconf -d' output)\fR"
453 The directory where \fBlocal\fR(8) UNIX-style mailboxes are kept.
454 .IP "\fBfallback_transport_maps (empty)\fR"
455 Optional lookup tables with per-recipient message delivery
456 transports for recipients that the \fBlocal\fR(8) delivery agent could
457 not find in the \fBaliases\fR(5) or UNIX password database.
458 .IP "\fBfallback_transport (empty)\fR"
459 Optional message delivery transport that the \fBlocal\fR(8) delivery
460 agent should use for names that are not found in the \fBaliases\fR(5)
461 or UNIX password database.
462 .IP "\fBluser_relay (empty)\fR"
463 Optional catch-all destination for unknown \fBlocal\fR(8) recipients.
465 Available in Postfix version 2.2 and later:
466 .IP "\fBcommand_execution_directory (empty)\fR"
467 The \fBlocal\fR(8) delivery agent working directory for delivery to
468 external command.
469 .SH "MAILBOX LOCKING CONTROLS"
474 .IP "\fBdeliver_lock_attempts (20)\fR"
475 The maximal number of attempts to acquire an exclusive lock on a
476 mailbox file or \fBbounce\fR(8) logfile.
477 .IP "\fBdeliver_lock_delay (1s)\fR"
478 The time between attempts to acquire an exclusive lock on a mailbox
479 file or \fBbounce\fR(8) logfile.
480 .IP "\fBstale_lock_time (500s)\fR"
481 The time after which a stale exclusive mailbox lockfile is removed.
482 .IP "\fBmailbox_delivery_lock (see 'postconf -d' output)\fR"
483 How to lock a UNIX-style \fBlocal\fR(8) mailbox before attempting delivery.
484 .SH "RESOURCE AND RATE CONTROLS"
489 .IP "\fBcommand_time_limit (1000s)\fR"
490 Time limit for delivery to external commands.
491 .IP "\fBduplicate_filter_limit (1000)\fR"
492 The maximal number of addresses remembered by the address
493 duplicate filter for \fBaliases\fR(5) or \fBvirtual\fR(5) alias expansion, or
494 for \fBshowq\fR(8) queue displays.
495 .IP "\fBlocal_destination_concurrency_limit (2)\fR"
496 The maximal number of parallel deliveries via the local mail
497 delivery transport to the same recipient (when
498 "local_destination_recipient_limit = 1") or the maximal number of
499 parallel deliveries to the same local domain (when
500 "local_destination_recipient_limit > 1").
501 .IP "\fBlocal_destination_recipient_limit (1)\fR"
502 The maximal number of recipients per message delivery via the
503 local mail delivery transport.
504 .IP "\fBmailbox_size_limit (51200000)\fR"
505 The maximal size of any \fBlocal\fR(8) individual mailbox or maildir
506 file, or zero (no limit).
507 .SH "SECURITY CONTROLS"
512 .IP "\fBallow_mail_to_commands (alias, forward)\fR"
513 Restrict \fBlocal\fR(8) mail delivery to external commands.
514 .IP "\fBallow_mail_to_files (alias, forward)\fR"
515 Restrict \fBlocal\fR(8) mail delivery to external files.
516 .IP "\fBcommand_expansion_filter (see 'postconf -d' output)\fR"
517 Restrict the characters that the \fBlocal\fR(8) delivery agent allows in
518 $name expansions of $mailbox_command and $command_execution_directory.
519 .IP "\fBdefault_privs (nobody)\fR"
520 The default rights used by the \fBlocal\fR(8) delivery agent for delivery
521 to external file or command.
522 .IP "\fBforward_expansion_filter (see 'postconf -d' output)\fR"
523 Restrict the characters that the \fBlocal\fR(8) delivery agent allows in
524 $name expansions of $forward_path.
526 Available in Postfix version 2.2 and later:
527 .IP "\fBexecution_directory_expansion_filter (see 'postconf -d' output)\fR"
528 Restrict the characters that the \fBlocal\fR(8) delivery agent allows
529 in $name expansions of $command_execution_directory.
531 Available in Postfix version 2.5.3 and later:
532 .IP "\fBstrict_mailbox_ownership (yes)\fR"
533 Defer delivery when a mailbox file is not owned by its recipient.
534 .SH "MISCELLANEOUS CONTROLS"
539 .IP "\fBconfig_directory (see 'postconf -d' output)\fR"
540 The default location of the Postfix main.cf and master.cf
541 configuration files.
542 .IP "\fBdaemon_timeout (18000s)\fR"
543 How much time a Postfix daemon process may take to handle a
544 request before it is terminated by a built-in watchdog timer.
545 .IP "\fBdelay_logging_resolution_limit (2)\fR"
546 The maximal number of digits after the decimal point when logging
547 sub-second delay values.
548 .IP "\fBexport_environment (see 'postconf -d' output)\fR"
549 The list of environment variables that a Postfix process will export
550 to non-Postfix processes.
551 .IP "\fBipc_timeout (3600s)\fR"
552 The time limit for sending or receiving information over an internal
553 communication channel.
554 .IP "\fBlocal_command_shell (empty)\fR"
555 Optional shell program for \fBlocal\fR(8) delivery to non-Postfix command.
556 .IP "\fBmax_idle (100s)\fR"
557 The maximum amount of time that an idle Postfix daemon process waits
558 for an incoming connection before terminating voluntarily.
559 .IP "\fBmax_use (100)\fR"
560 The maximal number of incoming connections that a Postfix daemon
561 process will service before terminating voluntarily.
562 .IP "\fBprepend_delivered_header (command, file, forward)\fR"
563 The message delivery contexts where the Postfix \fBlocal\fR(8) delivery
564 agent prepends a Delivered-To:  message header with the address
565 that the mail was delivered to.
566 .IP "\fBprocess_id (read-only)\fR"
567 The process ID of a Postfix command or daemon process.
568 .IP "\fBprocess_name (read-only)\fR"
569 The process name of a Postfix command or daemon process.
570 .IP "\fBpropagate_unmatched_extensions (canonical, virtual)\fR"
571 What address lookup tables copy an address extension from the lookup
572 key to the lookup result.
573 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
574 The location of the Postfix top-level queue directory.
575 .IP "\fBrecipient_delimiter (empty)\fR"
576 The separator between user names and address extensions (user+foo).
577 .IP "\fBrequire_home_directory (no)\fR"
578 Whether or not a \fBlocal\fR(8) recipient's home directory must exist
579 before mail delivery is attempted.
580 .IP "\fBsyslog_facility (mail)\fR"
581 The syslog facility of Postfix logging.
582 .IP "\fBsyslog_name (see 'postconf -d' output)\fR"
583 The mail system name that is prepended to the process name in syslog
584 records, so that "smtpd" becomes, for example, "postfix/smtpd".
585 .SH "FILES"
588 The following are examples; details differ between systems.
589 $HOME/.forward, per-user aliasing
590 /etc/aliases, system-wide alias database
591 /var/spool/mail, system mailboxes
592 .SH "SEE ALSO"
595 qmgr(8), queue manager
596 bounce(8), delivery status reports
597 newaliases(1), create/update alias database
598 postalias(1), create/update alias database
599 aliases(5), format of alias database
600 postconf(5), configuration parameters
601 master(5), generic daemon options
602 syslogd(8), system logging
603 .SH "LICENSE"
608 The Secure Mailer license must be distributed with this software.
609 .SH "HISTORY"
614 The \fBDelivered-To:\fR message header appears in the \fBqmail\fR
615 system by Daniel Bernstein.
617 The \fImaildir\fR structure appears in the \fBqmail\fR system
618 by Daniel Bernstein.
619 .SH "AUTHOR(S)"
622 Wietse Venema
623 IBM T.J. Watson Research
624 P.O. Box 704
625 Yorktown Heights, NY 10598, USA