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