postlock.1.html revision 1.1.1.3
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 - postlock(1) </title> 6</head> <body> <pre> 7POSTLOCK(1) General Commands Manual POSTLOCK(1) 8 9<b>NAME</b> 10 postlock - lock mail folder and execute command 11 12<b>SYNOPSIS</b> 13 <b>postlock</b> [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<b>-l</b> <i>lock</i><b>_</b><i>style</i>] 14 [<b>-v</b>] <i>file command...</i> 15 16<b>DESCRIPTION</b> 17 The <a href="postlock.1.html"><b>postlock</b>(1)</a> command locks <i>file</i> for exclusive access, and executes 18 <i>command</i>. The locking method is compatible with the Postfix UNIX-style 19 local delivery agent. 20 21 Options: 22 23 <b>-c</b> <i>config</i><b>_</b><i>dir</i> 24 Read the <a href="postconf.5.html"><b>main.cf</b></a> configuration file in the named directory 25 instead of the default configuration directory. 26 27 <b>-l</b> <i>lock</i><b>_</b><i>style</i> 28 Override the locking method specified via the <b><a href="postconf.5.html#mailbox_delivery_lock">mailbox_deliv</a>-</b> 29 <b><a href="postconf.5.html#mailbox_delivery_lock">ery_lock</a></b> configuration parameter (see below). 30 31 <b>-v</b> Enable verbose logging for debugging purposes. Multiple <b>-v</b> 32 options make the software increasingly verbose. 33 34 Arguments: 35 36 <i>file</i> A mailbox file. The user should have read/write permission. 37 38 <i>command...</i> 39 The command to execute while <i>file</i> is locked for exclusive 40 access. The command is executed directly, i.e. without inter- 41 pretation by a shell command interpreter. 42 43<b>DIAGNOSTICS</b> 44 The result status is 75 (EX_TEMPFAIL) when <a href="postlock.1.html"><b>postlock</b>(1)</a> could not per- 45 form the requested operation. Otherwise, the exit status is the exit 46 status from the command. 47 48<b>BUGS</b> 49 With remote file systems, the ability to acquire a lock does not neces- 50 sarily eliminate access conflicts. Avoid file access by processes run- 51 ning on different machines. 52 53<b>ENVIRONMENT</b> 54 <b>MAIL_CONFIG</b> 55 Directory with Postfix configuration files. 56 57 <b>MAIL_VERBOSE</b> 58 Enable verbose logging for debugging purposes. 59 60<b>CONFIGURATION PARAMETERS</b> 61 The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro- 62 gram. The text below provides only a parameter summary. See <a href="postconf.5.html"><b>post-</b></a> 63 <a href="postconf.5.html"><b>conf</b>(5)</a> for more details including examples. 64 65<b>LOCKING CONTROLS</b> 66 <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b> 67 The maximal number of attempts to acquire an exclusive lock on a 68 mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 69 70 <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b> 71 The time between attempts to acquire an exclusive lock on a 72 mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 73 74 <b><a href="postconf.5.html#stale_lock_time">stale_lock_time</a> (500s)</b> 75 The time after which a stale exclusive mailbox lockfile is 76 removed. 77 78 <b><a href="postconf.5.html#mailbox_delivery_lock">mailbox_delivery_lock</a> (see 'postconf -d' output)</b> 79 How to lock a UNIX-style <a href="local.8.html"><b>local</b>(8)</a> mailbox before attempting 80 delivery. 81 82<b>RESOURCE AND RATE CONTROLS</b> 83 <b><a href="postconf.5.html#fork_attempts">fork_attempts</a> (5)</b> 84 The maximal number of attempts to fork() a child process. 85 86 <b><a href="postconf.5.html#fork_delay">fork_delay</a> (1s)</b> 87 The delay between attempts to fork() a child process. 88 89<b>MISCELLANEOUS CONTROLS</b> 90 <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> 91 The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con- 92 figuration files. 93 94<b>SEE ALSO</b> 95 <a href="postconf.5.html">postconf(5)</a>, configuration parameters 96 97<b>LICENSE</b> 98 The Secure Mailer license must be distributed with this software. 99 100<b>AUTHOR(S)</b> 101 Wietse Venema 102 IBM T.J. Watson Research 103 P.O. Box 704 104 Yorktown Heights, NY 10598, USA 105 106 Wietse Venema 107 Google, Inc. 108 111 8th Avenue 109 New York, NY 10011, USA 110 111 POSTLOCK(1) 112</pre> </body> </html> 113