158314Sache<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" 2136759Speter "http://www.w3.org/TR/html4/loose.dtd"> 321308Sache<html> <head> 421308Sache<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 5136759Speter<link rel='stylesheet' type='text/css' href='postfix-doc.css'> 621308Sache<title> Postfix manual - postlock(1) </title> 721308Sache</head> <body> <pre> 821308SachePOSTLOCK(1) POSTLOCK(1) 921308Sache 1021308Sache<b>NAME</b> 1121308Sache postlock - lock mail folder and execute command 1258314Sache 1321308Sache<b>SYNOPSIS</b> 1421308Sache <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>] 1521308Sache [<b>-v</b>] <i>file command...</i> 1621308Sache 1721308Sache<b>DESCRIPTION</b> 1821308Sache The <a href="postlock.1.html"><b>postlock</b>(1)</a> command locks <i>file</i> for exclusive access, and executes 1921308Sache <i>command</i>. The locking method is compatible with the Postfix UNIX-style 2021308Sache local delivery agent. 2121308Sache 2221308Sache Options: 2358314Sache 2421308Sache <b>-c</b> <i>config</i><b>_</b><i>dir</i> 2521308Sache Read the <a href="postconf.5.html"><b>main.cf</b></a> configuration file in the named directory 2621308Sache instead of the default configuration directory. 2721308Sache 2821308Sache <b>-l</b> <i>lock</i><b>_</b><i>style</i> 2921308Sache Override the locking method specified via the <b><a href="postconf.5.html#mailbox_delivery_lock">mailbox_deliv</a>-</b> 3021308Sache <b><a href="postconf.5.html#mailbox_delivery_lock">ery_lock</a></b> configuration parameter (see below). 3121308Sache 3221308Sache <b>-v</b> Enable verbose logging for debugging purposes. Multiple <b>-v</b> 3321308Sache options make the software increasingly verbose. 3421308Sache 3521308Sache Arguments: 3626497Sache 3726497Sache <i>file</i> A mailbox file. The user should have read/write permission. 3821308Sache 3921308Sache <i>command...</i> 4021308Sache The command to execute while <i>file</i> is locked for exclusive 4121308Sache access. The command is executed directly, i.e. without inter- 4221308Sache pretation by a shell command interpreter. 4321308Sache 4426497Sache<b>DIAGNOSTICS</b> 4521308Sache The result status is 75 (EX_TEMPFAIL) when <a href="postlock.1.html"><b>postlock</b>(1)</a> could not per- 4621308Sache form the requested operation. Otherwise, the exit status is the exit 4721308Sache status from the command. 48119614Sache 4921308Sache<b>BUGS</b> 5021308Sache With remote file systems, the ability to acquire a lock does not neces- 5121308Sache sarily eliminate access conflicts. Avoid file access by processes run- 5221308Sache ning on different machines. 5321308Sache 5421308Sache<b>ENVIRONMENT</b> 5521308Sache <b>MAIL_CONFIG</b> 5621308Sache Directory with Postfix configuration files. 5758314Sache 5858314Sache <b>MAIL_VERBOSE</b> 5958314Sache Enable verbose logging for debugging purposes. 6021308Sache 6121308Sache<b>CONFIGURATION PARAMETERS</b> 6221308Sache The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro- 6321308Sache gram. The text below provides only a parameter summary. See <a href="postconf.5.html"><b>post-</b></a> 6458314Sache <a href="postconf.5.html"><b>conf</b>(5)</a> for more details including examples. 6575409Sache 6635486Sache<b>LOCKING CONTROLS</b> 6721308Sache <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b> 68119614Sache The maximal number of attempts to acquire an exclusive lock on a 69119614Sache mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 70119614Sache 71119614Sache <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b> 72119614Sache The time between attempts to acquire an exclusive lock on a 7321308Sache mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile. 74119614Sache 75136759Speter <b><a href="postconf.5.html#stale_lock_time">stale_lock_time</a> (500s)</b> 76119614Sache The time after which a stale exclusive mailbox lockfile is 77119614Sache removed. 78119614Sache 79119614Sache <b><a href="postconf.5.html#mailbox_delivery_lock">mailbox_delivery_lock</a> (see 'postconf -d' output)</b> 80119614Sache How to lock a UNIX-style <a href="local.8.html"><b>local</b>(8)</a> mailbox before attempting 8121308Sache delivery. 8258314Sache 8321308Sache<b>RESOURCE AND RATE CONTROLS</b> 8421308Sache <b><a href="postconf.5.html#fork_attempts">fork_attempts</a> (5)</b> 8521308Sache The maximal number of attempts to fork() a child process. 8621308Sache 8721308Sache <b><a href="postconf.5.html#fork_delay">fork_delay</a> (1s)</b> 8821308Sache The delay between attempts to fork() a child process. 8921308Sache 9021308Sache<b>MISCELLANEOUS CONTROLS</b> 9121308Sache <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> 9221308Sache The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con- 9321308Sache figuration files. 9421308Sache 9521308Sache <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b> 9621308Sache The list of environment parameters that a privileged Postfix 9721308Sache process will import from a non-Postfix parent process, or 9821308Sache name=value environment overrides. 9921308Sache 10021308Sache<b>SEE ALSO</b> 10121308Sache <a href="postconf.5.html">postconf(5)</a>, configuration parameters 10221308Sache 10321308Sache<b>LICENSE</b> 10421308Sache The Secure Mailer license must be distributed with this software. 10521308Sache 10621308Sache<b>AUTHOR(S)</b> 10721308Sache Wietse Venema 10821308Sache IBM T.J. Watson Research 10921308Sache P.O. Box 704 11021308Sache Yorktown Heights, NY 10598, USA 11121308Sache 11221308Sache Wietse Venema 11321308Sache Google, Inc. 11421308Sache 111 8th Avenue 11521308Sache New York, NY 10011, USA 11675409Sache 11721308Sache POSTLOCK(1) 11821308Sache</pre> </body> </html> 11921308Sache