1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" 2 "http://www.w3.org/TR/html4/loose.dtd"> 3<html> <head> 4<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> 5<title> Postfix manual - local(8) </title> 6</head> <body> <pre> 7LOCAL(8) LOCAL(8) 8 9<b>NAME</b> 10 local - Postfix local mail delivery 11 12<b>SYNOPSIS</b> 13 <b>local</b> [generic Postfix daemon options] 14 15<b>DESCRIPTION</b> 16 The <a href="local.8.html"><b>local</b>(8)</a> daemon processes delivery requests from the Postfix queue 17 manager to deliver mail to local recipients. Each delivery request 18 specifies a queue file, a sender address, a domain or host to deliver 19 to, and one or more recipients. This program expects to be run from 20 the <a href="master.8.html"><b>master</b>(8)</a> process manager. 21 22 The <a href="local.8.html"><b>local</b>(8)</a> daemon updates queue files and marks recipients as fin- 23 ished, or it informs the queue manager that delivery should be tried 24 again at a later time. Delivery status reports are sent to the 25 <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. 26 27<b>CASE FOLDING</b> 28 All delivery decisions are made using the bare recipient name (i.e. the 29 address localpart), folded to lower case. See also under ADDRESS 30 EXTENSION below for a few exceptions. 31 32<b>SYSTEM-WIDE AND USER-LEVEL ALIASING</b> 33 The system administrator can set up one or more system-wide <b>send-</b> 34 <b>mail</b>-style alias databases. Users can have <b>sendmail</b>-style ~/.<b>forward</b> 35 files. Mail for <i>name</i> is delivered to the alias <i>name</i>, to destinations 36 in ~<i>name</i>/.<b>forward</b>, to the mailbox owned by the user <i>name</i>, or it is sent 37 back as undeliverable. 38 39 The system administrator can specify a comma/space separated list of 40 ~/.<b>forward</b> like files through the <b><a href="postconf.5.html#forward_path">forward_path</a></b> configuration parameter. 41 Upon delivery, the local delivery agent tries each pathname in the list 42 until a file is found. 43 44 Delivery via ~/.<b>forward</b> files is done with the privileges of the recip- 45 ient. Thus, ~/.<b>forward</b> like files must be readable by the recipient, 46 and their parent directory needs to have "execute" permission for the 47 recipient. 48 49 The <b><a href="postconf.5.html#forward_path">forward_path</a></b> parameter is subject to interpolation of <b>$user</b> (recip- 50 ient username), <b>$home</b> (recipient home directory), <b>$shell</b> (recipient 51 shell), <b>$recipient</b> (complete recipient address), <b>$extension</b> (recipient 52 address extension), <b>$domain</b> (recipient domain), <b>$local</b> (entire recipi- 53 ent address localpart) and <b>$<a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a>.</b> The forms 54 <i>${name?value}</i> and <i>${name:value}</i> expand conditionally to <i>value</i> when 55 <i>$name</i> is (is not) defined. Characters that may have special meaning to 56 the shell or file system are replaced by underscores. The list of 57 acceptable characters is specified with the <b><a href="postconf.5.html#forward_expansion_filter">forward_expansion_filter</a></b> 58 configuration parameter. 59 60 An alias or ~/.<b>forward</b> file may list any combination of external com- 61 mands, destination file names, <b>:include:</b> directives, or mail addresses. 62 See <a href="aliases.5.html"><b>aliases</b>(5)</a> for a precise description. Each line in a user's .<b>for-</b> 63 <b>ward</b> file has the same syntax as the right-hand part of an alias. 64 65 When an address is found in its own alias expansion, delivery is made 66 to the user instead. When a user is listed in the user's own ~/.<b>forward</b> 67 file, delivery is made to the user's mailbox instead. An empty ~/.<b>for-</b> 68 <b>ward</b> file means do not forward mail. 69 70 In order to prevent the mail system from using up unreasonable amounts 71 of memory, input records read from <b>:include:</b> or from ~/.<b>forward</b> files 72 are broken up into chunks of length <b><a href="postconf.5.html#line_length_limit">line_length_limit</a></b>. 73 74 While expanding aliases, ~/.<b>forward</b> files, and so on, the program 75 attempts to avoid duplicate deliveries. The <b><a href="postconf.5.html#duplicate_filter_limit">duplicate_filter_limit</a></b> con- 76 figuration parameter limits the number of remembered recipients. 77 78<b>MAIL FORWARDING</b> 79 For the sake of reliability, forwarded mail is re-submitted as a new 80 message, so that each recipient has a separate on-file delivery status 81 record. 82 83 In order to stop mail forwarding loops early, the software adds an 84 optional <b>Delivered-To:</b> header with the final envelope recipient 85 address. If mail arrives for a recipient that is already listed in a 86 <b>Delivered-To:</b> header, the message is bounced. 87 88<b>MAILBOX DELIVERY</b> 89 The default per-user mailbox is a file in the UNIX mail spool directory 90 (<b>/var/mail/</b><i>user</i> or <b>/var/spool/mail/</b><i>user</i>); the location can be specified 91 with the <b><a href="postconf.5.html#mail_spool_directory">mail_spool_directory</a></b> configuration parameter. Specify a name 92 ending in <b>/</b> for <b>qmail</b>-compatible <b>maildir</b> delivery. 93 94 Alternatively, the per-user mailbox can be a file in the user's home 95 directory with a name specified via the <b><a href="postconf.5.html#home_mailbox">home_mailbox</a></b> configuration 96 parameter. Specify a relative path name. Specify a name ending in <b>/</b> for 97 <b>qmail</b>-compatible <b>maildir</b> delivery. 98 99 Mailbox delivery can be delegated to an external command specified with 100 the <b><a href="postconf.5.html#mailbox_command_maps">mailbox_command_maps</a></b> and <b><a href="postconf.5.html#mailbox_command">mailbox_command</a></b> configuration parameters. 101 The command executes with the privileges of the recipient user (excep- 102 tions: secondary groups are not enabled; in case of delivery as root, 103 the command executes with the privileges of <b><a href="postconf.5.html#default_privs">default_privs</a></b>). 104 105 Mailbox delivery can be delegated to alternative message transports 106 specified in the <a href="master.5.html"><b>master.cf</b></a> file. The <b><a href="postconf.5.html#mailbox_transport_maps">mailbox_transport_maps</a></b> and <b><a href="postconf.5.html#mailbox_transport">mail</a>-</b> 107 <b><a href="postconf.5.html#mailbox_transport">box_transport</a></b> configuration parameters specify an optional message 108 transport that is to be used for all local recipients, regardless of 109 whether they are found in the UNIX passwd database. The <b><a href="postconf.5.html#fallback_transport_maps">fall</a>-</b> 110 <b><a href="postconf.5.html#fallback_transport_maps">back_transport_maps</a></b> and <b><a href="postconf.5.html#fallback_transport">fallback_transport</a></b> parameters specify an 111 optional message transport for recipients that are not found in the 112 <a href="aliases.5.html">aliases(5)</a> or UNIX passwd database. 113 114 In the case of UNIX-style mailbox delivery, the <a href="local.8.html"><b>local</b>(8)</a> daemon 115 prepends a "<b>From</b> <i>sender time</i><b>_</b><i>stamp</i>" envelope header to each message, 116 prepends an <b>X-Original-To:</b> header with the recipient address as given 117 to Postfix, prepends an optional <b>Delivered-To:</b> header with the final 118 envelope recipient address, prepends a <b>Return-Path:</b> header with the 119 envelope sender address, prepends a > character to lines beginning with 120 "<b>From</b> ", and appends an empty line. The mailbox is locked for exclu- 121 sive access while delivery is in progress. In case of problems, an 122 attempt is made to truncate the mailbox to its original length. 123 124 In the case of <b>maildir</b> delivery, the local daemon prepends an optional 125 <b>Delivered-To:</b> header with the final envelope recipient address, 126 prepends an <b>X-Original-To:</b> header with the recipient address as given 127 to Postfix, and prepends a <b>Return-Path:</b> header with the envelope sender 128 address. 129 130<b>EXTERNAL COMMAND DELIVERY</b> 131 The <b><a href="postconf.5.html#allow_mail_to_commands">allow_mail_to_commands</a></b> configuration parameter restricts delivery 132 to external commands. The default setting (<b>alias, forward</b>) forbids com- 133 mand destinations in <b>:include:</b> files. 134 135 Optionally, the process working directory is changed to the path speci- 136 fied with <b><a href="postconf.5.html#command_execution_directory">command_execution_directory</a></b> (Postfix 2.2 and later). Failure 137 to change directory causes mail to be deferred. 138 139 The <b><a href="postconf.5.html#command_execution_directory">command_execution_directory</a></b> parameter value is subject to interpo- 140 lation of <b>$user</b> (recipient username), <b>$home</b> (recipient home directory), 141 <b>$shell</b> (recipient shell), <b>$recipient</b> (complete recipient address), 142 <b>$extension</b> (recipient address extension), <b>$domain</b> (recipient domain), 143 <b>$local</b> (entire recipient address localpart) and <b>$<a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a>.</b> 144 The forms <i>${name?value}</i> and <i>${name:value}</i> expand conditionally to <i>value</i> 145 when <i>$name</i> is (is not) defined. Characters that may have special mean- 146 ing to the shell or file system are replaced by underscores. The list 147 of acceptable characters is specified with the <b><a href="postconf.5.html#execution_directory_expansion_filter">execution_direc</a>-</b> 148 <b><a href="postconf.5.html#execution_directory_expansion_filter">tory_expansion_filter</a></b> configuration parameter. 149 150 The command is executed directly where possible. Assistance by the 151 shell (<b>/bin/sh</b> on UNIX systems) is used only when the command contains 152 shell magic characters, or when the command invokes a shell built-in 153 command. 154 155 A limited amount of command output (standard output and standard error) 156 is captured for inclusion with non-delivery status reports. A command 157 is forcibly terminated if it does not complete within <b>com-</b> 158 <b>mand_time_limit</b> seconds. Command exit status codes are expected to 159 follow the conventions defined in <<b>sysexits.h</b>>. Exit status 0 means 160 normal successful completion. 161 162 Postfix version 2.3 and later support <a href="http://tools.ietf.org/html/rfc3463">RFC 3463</a>-style enhanced status 163 codes. If a command terminates with a non-zero exit status, and the 164 command output begins with an enhanced status code, this status code 165 takes precedence over the non-zero exit status. 166 167 A limited amount of message context is exported via environment vari- 168 ables. Characters that may have special meaning to the shell are 169 replaced by underscores. The list of acceptable characters is speci- 170 fied with the <b><a href="postconf.5.html#command_expansion_filter">command_expansion_filter</a></b> configuration parameter. 171 172 <b>SHELL</b> The recipient user's login shell. 173 174 <b>HOME</b> The recipient user's home directory. 175 176 <b>USER</b> The bare recipient name. 177 178 <b>EXTENSION</b> 179 The optional recipient address extension. 180 181 <b>DOMAIN</b> The recipient address domain part. 182 183 <b>LOGNAME</b> 184 The bare recipient name. 185 186 <b>LOCAL</b> The entire recipient address localpart (text to the left of the 187 rightmost @ character). 188 189 <b>ORIGINAL_RECIPIENT</b> 190 The entire recipient address, before any address rewriting or 191 aliasing (Postfix 2.5 and later). 192 193 <b>RECIPIENT</b> 194 The entire recipient address. 195 196 <b>SENDER</b> The entire sender address. 197 198 Additional remote client information is made available via the follow- 199 ing environment variables: 200 201 <b>CLIENT_ADDRESS</b> 202 Remote client network address. Available as of Postfix 2.2. 203 204 <b>CLIENT_HELO</b> 205 Remote client EHLO command parameter. Available as of Postfix 206 2.2. 207 208 <b>CLIENT_HOSTNAME</b> 209 Remote client hostname. Available as of Postfix 2.2. 210 211 <b>CLIENT_PROTOCOL</b> 212 Remote client protocol. Available as of Postfix 2.2. 213 214 <b>SASL_METHOD</b> 215 SASL authentication method specified in the remote client AUTH 216 command. Available as of Postfix 2.2. 217 218 <b>SASL_SENDER</b> 219 SASL sender address specified in the remote client MAIL FROM 220 command. Available as of Postfix 2.2. 221 222 <b>SASL_USERNAME</b> 223 SASL username specified in the remote client AUTH command. 224 Available as of Postfix 2.2. 225 226 The <b>PATH</b> environment variable is always reset to a system-dependent 227 default path, and environment variables whose names are blessed by the 228 <b><a href="postconf.5.html#export_environment">export_environment</a></b> configuration parameter are exported unchanged. 229 230 The current working directory is the mail queue directory. 231 232 The <a href="local.8.html"><b>local</b>(8)</a> daemon prepends a "<b>From</b> <i>sender time</i><b>_</b><i>stamp</i>" envelope header 233 to each message, prepends an <b>X-Original-To:</b> header with the recipient 234 address as given to Postfix, prepends an optional <b>Delivered-To:</b> header 235 with the final recipient envelope address, prepends a <b>Return-Path:</b> 236 header with the sender envelope address, and appends no empty line. 237 238<b>EXTERNAL FILE DELIVERY</b> 239 The delivery format depends on the destination filename syntax. The 240 default is to use UNIX-style mailbox format. Specify a name ending in 241 <b>/</b> for <b>qmail</b>-compatible <b>maildir</b> delivery. 242 243 The <b><a href="postconf.5.html#allow_mail_to_files">allow_mail_to_files</a></b> configuration parameter restricts delivery to 244 external files. The default setting (<b>alias, forward</b>) forbids file des- 245 tinations in <b>:include:</b> files. 246 247 In the case of UNIX-style mailbox delivery, the <a href="local.8.html"><b>local</b>(8)</a> daemon 248 prepends a "<b>From</b> <i>sender time</i><b>_</b><i>stamp</i>" envelope header to each message, 249 prepends an <b>X-Original-To:</b> header with the recipient address as given 250 to Postfix, prepends an optional <b>Delivered-To:</b> header with the final 251 recipient envelope address, prepends a > character to lines beginning 252 with "<b>From</b> ", and appends an empty line. The envelope sender address 253 is available in the <b>Return-Path:</b> header. When the destination is a 254 regular file, it is locked for exclusive access while delivery is in 255 progress. In case of problems, an attempt is made to truncate a regular 256 file to its original length. 257 258 In the case of <b>maildir</b> delivery, the local daemon prepends an optional 259 <b>Delivered-To:</b> header with the final envelope recipient address, and 260 prepends an <b>X-Original-To:</b> header with the recipient address as given 261 to Postfix. The envelope sender address is available in the 262 <b>Return-Path:</b> header. 263 264<b>ADDRESS EXTENSION</b> 265 The optional <b><a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a></b> configuration parameter specifies how 266 to separate address extensions from local recipient names. 267 268 For example, with "<b><a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a> = +</b>", mail for <i>name</i>+<i>foo</i> is 269 delivered to the alias <i>name</i>+<i>foo</i> or to the alias <i>name</i>, to the destina- 270 tions listed in ~<i>name</i>/.<b>forward</b>+<i>foo</i> or in ~<i>name</i>/.<b>forward</b>, to the mailbox 271 owned by the user <i>name</i>, or it is sent back as undeliverable. 272 273<b>DELIVERY RIGHTS</b> 274 Deliveries to external files and external commands are made with the 275 rights of the receiving user on whose behalf the delivery is made. In 276 the absence of a user context, the <a href="local.8.html"><b>local</b>(8)</a> daemon uses the owner 277 rights of the <b>:include:</b> file or alias database. When those files are 278 owned by the superuser, delivery is made with the rights specified with 279 the <b><a href="postconf.5.html#default_privs">default_privs</a></b> configuration parameter. 280 281<b>STANDARDS</b> 282 <a href="http://tools.ietf.org/html/rfc822">RFC 822</a> (ARPA Internet Text Messages) 283 <a href="http://tools.ietf.org/html/rfc3463">RFC 3463</a> (Enhanced status codes) 284 285<b>DIAGNOSTICS</b> 286 Problems and transactions are logged to <b>syslogd</b>(8). Corrupted message 287 files are marked so that the queue manager can move them to the <b>corrupt</b> 288 queue afterwards. 289 290 Depending on the setting of the <b><a href="postconf.5.html#notify_classes">notify_classes</a></b> parameter, the postmas- 291 ter is notified of bounces and of other trouble. 292 293<b>SECURITY</b> 294 The <a href="local.8.html"><b>local</b>(8)</a> delivery agent needs a dual personality 1) to access the 295 private Postfix queue and IPC mechanisms, 2) to impersonate the recipi- 296 ent and deliver to recipient-specified files or commands. It is there- 297 fore security sensitive. 298 299 The <a href="local.8.html"><b>local</b>(8)</a> delivery agent disallows regular expression substitution 300 of $1 etc. in <b><a href="postconf.5.html#alias_maps">alias_maps</a></b>, because that would open a security hole. 301 302 The <a href="local.8.html"><b>local</b>(8)</a> delivery agent will silently ignore requests to use the 303 <a href="proxymap.8.html"><b>proxymap</b>(8)</a> server within <b><a href="postconf.5.html#alias_maps">alias_maps</a></b>. Instead it will open the table 304 directly. Before Postfix version 2.2, the <a href="local.8.html"><b>local</b>(8)</a> delivery agent will 305 terminate with a fatal error. 306 307<b>BUGS</b> 308 For security reasons, the message delivery status of external commands 309 or of external files is never checkpointed to file. As a result, the 310 program may occasionally deliver more than once to a command or exter- 311 nal file. Better safe than sorry. 312 313 Mutually-recursive aliases or ~/.<b>forward</b> files are not detected early. 314 The resulting mail forwarding loop is broken by the use of the <b>Deliv-</b> 315 <b>ered-To:</b> message header. 316 317<b>CONFIGURATION PARAMETERS</b> 318 Changes to <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically, as <a href="local.8.html"><b>local</b>(8)</a> processes 319 run for only a limited amount of time. Use the command "<b>postfix reload</b>" 320 to speed up a change. 321 322 The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for 323 more details including examples. 324 325<b>COMPATIBILITY CONTROLS</b> 326 <b><a href="postconf.5.html#biff">biff</a> (yes)</b> 327 Whether or not to use the local <a href="postconf.5.html#biff">biff</a> service. 328 329 <b><a href="postconf.5.html#expand_owner_alias">expand_owner_alias</a> (no)</b> 330 When delivering to an alias "aliasname" that has an 331 "owner-aliasname" companion alias, set the envelope sender 332 address to the expansion of the "owner-aliasname" alias. 333 334 <b><a href="postconf.5.html#owner_request_special">owner_request_special</a> (yes)</b> 335 Give special treatment to owner-listname and listname-request 336 address localparts: don't split such addresses when the <a href="postconf.5.html#recipient_delimiter">recipi</a>- 337 <a href="postconf.5.html#recipient_delimiter">ent_delimiter</a> is set to "-". 338 339 <b><a href="postconf.5.html#sun_mailtool_compatibility">sun_mailtool_compatibility</a> (no)</b> 340 Obsolete SUN mailtool compatibility feature. 341 342 Available in Postfix version 2.3 and later: 343 344 <b><a href="postconf.5.html#frozen_delivered_to">frozen_delivered_to</a> (yes)</b> 345 Update the <a href="local.8.html"><b>local</b>(8)</a> delivery agent's idea of the Delivered-To: 346 address (see <a href="postconf.5.html#prepend_delivered_header">prepend_delivered_header</a>) only once, at the start 347 of a delivery attempt; do not update the Delivered-To: address 348 while expanding aliases or .forward files. 349 350 Available in Postfix version 2.5.3 and later: 351 352 <b><a href="postconf.5.html#strict_mailbox_ownership">strict_mailbox_ownership</a> (yes)</b> 353 Defer delivery when a mailbox file is not owned by its recipi- 354 ent. 355 356 <b><a href="postconf.5.html#reset_owner_alias">reset_owner_alias</a> (no)</b> 357 Reset the <a href="local.8.html"><b>local</b>(8)</a> delivery agent's idea of the owner-alias 358 attribute, when delivering mail to a child alias that does not 359 have its own owner alias. 360 361 Available in Postfix version 3.0 and later: 362 363 <b><a href="postconf.5.html#local_delivery_status_filter">local_delivery_status_filter</a> ($<a href="postconf.5.html#default_delivery_status_filter">default_delivery_status_filter</a>)</b> 364 Optional filter for the <a href="local.8.html"><b>local</b>(8)</a> delivery agent to change the 365 status code or explanatory text of successful or unsuccessful 366 deliveries. 367 368<b>DELIVERY METHOD CONTROLS</b> 369 The precedence of <a href="local.8.html"><b>local</b>(8)</a> delivery methods from high to low is: 370 aliases, .forward files, <a href="postconf.5.html#mailbox_transport_maps">mailbox_transport_maps</a>, <a href="postconf.5.html#mailbox_transport">mailbox_transport</a>, 371 <a href="postconf.5.html#mailbox_command_maps">mailbox_command_maps</a>, <a href="postconf.5.html#mailbox_command">mailbox_command</a>, <a href="postconf.5.html#home_mailbox">home_mailbox</a>, <a href="postconf.5.html#mail_spool_directory">mail_spool_direc</a>- 372 <a href="postconf.5.html#mail_spool_directory">tory</a>, <a href="postconf.5.html#fallback_transport_maps">fallback_transport_maps</a>, <a href="postconf.5.html#fallback_transport">fallback_transport</a>, and <a href="postconf.5.html#luser_relay">luser_relay</a>. 373 374 <b><a href="postconf.5.html#alias_maps">alias_maps</a> (see 'postconf -d' output)</b> 375 The alias databases that are used for <a href="local.8.html"><b>local</b>(8)</a> delivery. 376 377 <b><a href="postconf.5.html#forward_path">forward_path</a> (see 'postconf -d' output)</b> 378 The <a href="local.8.html"><b>local</b>(8)</a> delivery agent search list for finding a .forward 379 file with user-specified delivery methods. 380 381 <b><a href="postconf.5.html#mailbox_transport_maps">mailbox_transport_maps</a> (empty)</b> 382 Optional lookup tables with per-recipient message delivery 383 transports to use for <a href="local.8.html"><b>local</b>(8)</a> mailbox delivery, whether or not 384 the recipients are found in the UNIX passwd database. 385 386 <b><a href="postconf.5.html#mailbox_transport">mailbox_transport</a> (empty)</b> 387 Optional message delivery transport that the <a href="local.8.html"><b>local</b>(8)</a> delivery 388 agent should use for mailbox delivery to all local recipients, 389 whether or not they are found in the UNIX passwd database. 390 391 <b><a href="postconf.5.html#mailbox_command_maps">mailbox_command_maps</a> (empty)</b> 392 Optional lookup tables with per-recipient external commands to 393 use for <a href="local.8.html"><b>local</b>(8)</a> mailbox delivery. 394 395 <b><a href="postconf.5.html#mailbox_command">mailbox_command</a> (empty)</b> 396 Optional external command that the <a href="local.8.html"><b>local</b>(8)</a> delivery agent 397 should use for mailbox delivery. 398 399 <b><a href="postconf.5.html#home_mailbox">home_mailbox</a> (empty)</b> 400 Optional pathname of a mailbox file relative to a <a href="local.8.html"><b>local</b>(8)</a> 401 user's home directory. 402 403 <b><a href="postconf.5.html#mail_spool_directory">mail_spool_directory</a> (see 'postconf -d' output)</b> 404 The directory where <a href="local.8.html"><b>local</b>(8)</a> UNIX-style mailboxes are kept. 405 406 <b><a href="postconf.5.html#fallback_transport_maps">fallback_transport_maps</a> (empty)</b> 407 Optional lookup tables with per-recipient message delivery 408 transports for recipients that the <a href="local.8.html"><b>local</b>(8)</a> delivery agent could 409 not find in the <a href="aliases.5.html"><b>aliases</b>(5)</a> or UNIX password database. 410 411 <b><a href="postconf.5.html#fallback_transport">fallback_transport</a> (empty)</b> 412 Optional message delivery transport that the <a href="local.8.html"><b>local</b>(8)</a> delivery 413 agent should use for names that are not found in the <a href="aliases.5.html"><b>aliases</b>(5)</a> 414 or UNIX password database. 415 416 <b><a href="postconf.5.html#luser_relay">luser_relay</a> (empty)</b> 417 Optional catch-all destination for unknown <a href="local.8.html"><b>local</b>(8)</a> recipients. 418 419 Available in Postfix version 2.2 and later: 420 421 <b><a href="postconf.5.html#command_execution_directory">command_execution_directory</a> (empty)</b> 422 The <a href="local.8.html"><b>local</b>(8)</a> delivery agent working directory for delivery to 423 external command. 424 425<b>MAILBOX LOCKING CONTROLS</b> 426 <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b> 427 The maximal number of attempts to acquire an exclusive lock on a 428 mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 429 430 <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b> 431 The time between attempts to acquire an exclusive lock on a 432 mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 433 434 <b><a href="postconf.5.html#stale_lock_time">stale_lock_time</a> (500s)</b> 435 The time after which a stale exclusive mailbox lockfile is 436 removed. 437 438 <b><a href="postconf.5.html#mailbox_delivery_lock">mailbox_delivery_lock</a> (see 'postconf -d' output)</b> 439 How to lock a UNIX-style <a href="local.8.html"><b>local</b>(8)</a> mailbox before attempting 440 delivery. 441 442<b>RESOURCE AND RATE CONTROLS</b> 443 <b><a href="postconf.5.html#command_time_limit">command_time_limit</a> (1000s)</b> 444 Time limit for delivery to external commands. 445 446 <b><a href="postconf.5.html#duplicate_filter_limit">duplicate_filter_limit</a> (1000)</b> 447 The maximal number of addresses remembered by the address dupli- 448 cate filter for <a href="aliases.5.html"><b>aliases</b>(5)</a> or <a href="virtual.5.html"><b>virtual</b>(5)</a> alias expansion, or for 449 <a href="showq.8.html"><b>showq</b>(8)</a> queue displays. 450 451 <b><a href="postconf.5.html#local_destination_concurrency_limit">local_destination_concurrency_limit</a> (2)</b> 452 The maximal number of parallel deliveries via the local mail 453 delivery transport to the same recipient (when "<a href="postconf.5.html#local_destination_recipient_limit">local_destina</a>- 454 <a href="postconf.5.html#local_destination_recipient_limit">tion_recipient_limit</a> = 1") or the maximal number of parallel 455 deliveries to the same local domain (when "<a href="postconf.5.html#local_destination_recipient_limit">local_destina</a>- 456 <a href="postconf.5.html#local_destination_recipient_limit">tion_recipient_limit</a> > 1"). 457 458 <b><a href="postconf.5.html#local_destination_recipient_limit">local_destination_recipient_limit</a> (1)</b> 459 The maximal number of recipients per message delivery via the 460 local mail delivery transport. 461 462 <b><a href="postconf.5.html#mailbox_size_limit">mailbox_size_limit</a> (51200000)</b> 463 The maximal size of any <a href="local.8.html"><b>local</b>(8)</a> individual mailbox or maildir 464 file, or zero (no limit). 465 466<b>SECURITY CONTROLS</b> 467 <b><a href="postconf.5.html#allow_mail_to_commands">allow_mail_to_commands</a> (alias, forward)</b> 468 Restrict <a href="local.8.html"><b>local</b>(8)</a> mail delivery to external commands. 469 470 <b><a href="postconf.5.html#allow_mail_to_files">allow_mail_to_files</a> (alias, forward)</b> 471 Restrict <a href="local.8.html"><b>local</b>(8)</a> mail delivery to external files. 472 473 <b><a href="postconf.5.html#command_expansion_filter">command_expansion_filter</a> (see 'postconf -d' output)</b> 474 Restrict the characters that the <a href="local.8.html"><b>local</b>(8)</a> delivery agent allows 475 in $name expansions of $<a href="postconf.5.html#mailbox_command">mailbox_command</a> and $<a href="postconf.5.html#command_execution_directory">command_execu</a>- 476 <a href="postconf.5.html#command_execution_directory">tion_directory</a>. 477 478 <b><a href="postconf.5.html#default_privs">default_privs</a> (nobody)</b> 479 The default rights used by the <a href="local.8.html"><b>local</b>(8)</a> delivery agent for 480 delivery to external file or command. 481 482 <b><a href="postconf.5.html#forward_expansion_filter">forward_expansion_filter</a> (see 'postconf -d' output)</b> 483 Restrict the characters that the <a href="local.8.html"><b>local</b>(8)</a> delivery agent allows 484 in $name expansions of $<a href="postconf.5.html#forward_path">forward_path</a>. 485 486 Available in Postfix version 2.2 and later: 487 488 <b><a href="postconf.5.html#execution_directory_expansion_filter">execution_directory_expansion_filter</a> (see 'postconf -d' output)</b> 489 Restrict the characters that the <a href="local.8.html"><b>local</b>(8)</a> delivery agent allows 490 in $name expansions of $<a href="postconf.5.html#command_execution_directory">command_execution_directory</a>. 491 492 Available in Postfix version 2.5.3 and later: 493 494 <b><a href="postconf.5.html#strict_mailbox_ownership">strict_mailbox_ownership</a> (yes)</b> 495 Defer delivery when a mailbox file is not owned by its recipi- 496 ent. 497 498<b>MISCELLANEOUS CONTROLS</b> 499 <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> 500 The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con- 501 figuration files. 502 503 <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b> 504 How much time a Postfix daemon process may take to handle a 505 request before it is terminated by a built-in watchdog timer. 506 507 <b><a href="postconf.5.html#delay_logging_resolution_limit">delay_logging_resolution_limit</a> (2)</b> 508 The maximal number of digits after the decimal point when log- 509 ging sub-second delay values. 510 511 <b><a href="postconf.5.html#export_environment">export_environment</a> (see 'postconf -d' output)</b> 512 The list of environment variables that a Postfix process will 513 export to non-Postfix processes. 514 515 <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b> 516 The time limit for sending or receiving information over an 517 internal communication channel. 518 519 <b><a href="postconf.5.html#local_command_shell">local_command_shell</a> (empty)</b> 520 Optional shell program for <a href="local.8.html"><b>local</b>(8)</a> delivery to non-Postfix com- 521 mand. 522 523 <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b> 524 The maximum amount of time that an idle Postfix daemon process 525 waits for an incoming connection before terminating voluntarily. 526 527 <b><a href="postconf.5.html#max_use">max_use</a> (100)</b> 528 The maximal number of incoming connections that a Postfix daemon 529 process will service before terminating voluntarily. 530 531 <b><a href="postconf.5.html#prepend_delivered_header">prepend_delivered_header</a> (command, file, forward)</b> 532 The message delivery contexts where the Postfix <a href="local.8.html"><b>local</b>(8)</a> deliv- 533 ery agent prepends a Delivered-To: message header with the 534 address that the mail was delivered to. 535 536 <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b> 537 The process ID of a Postfix command or daemon process. 538 539 <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b> 540 The process name of a Postfix command or daemon process. 541 542 <b><a href="postconf.5.html#propagate_unmatched_extensions">propagate_unmatched_extensions</a> (canonical, virtual)</b> 543 What address lookup tables copy an address extension from the 544 lookup key to the lookup result. 545 546 <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b> 547 The location of the Postfix top-level queue directory. 548 549 <b><a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a> (empty)</b> 550 The set of characters that can separate a user name from its 551 extension (example: user+foo), or a .forward file name from its 552 extension (example: .forward+foo). 553 554 <b><a href="postconf.5.html#require_home_directory">require_home_directory</a> (no)</b> 555 Require that a <a href="local.8.html"><b>local</b>(8)</a> recipient's home directory exists before 556 mail delivery is attempted. 557 558 <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> 559 The syslog facility of Postfix logging. 560 561 <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> 562 The mail system name that is prepended to the process name in 563 syslog records, so that "smtpd" becomes, for example, "post- 564 fix/smtpd". 565 566<b>FILES</b> 567 The following are examples; details differ between systems. 568 $HOME/.forward, per-user aliasing 569 /etc/aliases, system-wide alias database 570 /var/spool/mail, system mailboxes 571 572<b>SEE ALSO</b> 573 <a href="qmgr.8.html">qmgr(8)</a>, queue manager 574 <a href="bounce.8.html">bounce(8)</a>, delivery status reports 575 <a href="newaliases.1.html">newaliases(1)</a>, create/update alias database 576 <a href="postalias.1.html">postalias(1)</a>, create/update alias database 577 <a href="aliases.5.html">aliases(5)</a>, format of alias database 578 <a href="postconf.5.html">postconf(5)</a>, configuration parameters 579 <a href="master.5.html">master(5)</a>, generic daemon options 580 syslogd(8), system logging 581 582<b>LICENSE</b> 583 The Secure Mailer license must be distributed with this software. 584 585<b>HISTORY</b> 586 The <b>Delivered-To:</b> message header appears in the <b>qmail</b> system by Daniel 587 Bernstein. 588 589 The <i>maildir</i> structure appears in the <b>qmail</b> system by Daniel Bernstein. 590 591<b>AUTHOR(S)</b> 592 Wietse Venema 593 IBM T.J. Watson Research 594 P.O. Box 704 595 Yorktown Heights, NY 10598, USA 596 597 Wietse Venema 598 Google, Inc. 599 111 8th Avenue 600 New York, NY 10011, USA 601 602 LOCAL(8) 603</pre> </body> </html> 604