dist/html/postlock.1.html

<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "https://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
<title> Postfix manual - postlock(1) </title>
</head> <body> <pre>
POSTLOCK(1)                                                        POSTLOCK(1)

<b><a name="name">NAME</a></b>
       postlock - lock mail folder and execute command

<b><a name="synopsis">SYNOPSIS</a></b>
       <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>]
               [<b>-v</b>] <i>file command...</i>

<b><a name="description">DESCRIPTION</a></b>
       The  <a href="postlock.1.html"><b>postlock</b>(1)</a>  command locks <i>file</i> for exclusive access, and executes
       <i>command</i>. The locking method is compatible with the  Postfix  UNIX-style
       local delivery agent.

       Options:

       <b>-c</b> <i>config</i><b>_</b><i>dir</i>
              Read  the  <a href="postconf.5.html"><b>main.cf</b></a>  configuration  file  in  the named directory
              instead of the default configuration directory.

       <b>-l</b> <i>lock</i><b>_</b><i>style</i>
              Override the locking method  specified  via  the  <b><a href="postconf.5.html#mailbox_delivery_lock">mailbox_deliv</a>-</b>
              <b><a href="postconf.5.html#mailbox_delivery_lock">ery_lock</a></b> configuration parameter (see below).

       <b>-v</b>     Enable  verbose  logging  for  debugging  purposes.  Multiple <b>-v</b>
              options make the software increasingly verbose.

       Arguments:

       <i>file</i>   A mailbox file. The user should have read/write permission.

       <i>command...</i>
              The command to  execute  while  <i>file</i>  is  locked  for  exclusive
              access.   The  command is executed directly, i.e. without inter-
              pretation by a shell command interpreter.

<b><a name="diagnostics">DIAGNOSTICS</a></b>
       The result status is 75 (EX_TEMPFAIL) when <a href="postlock.1.html"><b>postlock</b>(1)</a> could  not  per-
       form  the  requested operation.  Otherwise, the exit status is the exit
       status from the command.

<b><a name="bugs">BUGS</a></b>
       With remote file systems, the ability to acquire a lock does not neces-
       sarily  eliminate access conflicts. Avoid file access by processes run-
       ning on different machines.

<b><a name="environment">ENVIRONMENT</a></b>
       <b>MAIL_CONFIG</b>
              Directory with Postfix configuration files.

       <b>MAIL_VERBOSE</b>
              Enable verbose logging for debugging purposes.

<b><a name="configuration_parameters">CONFIGURATION PARAMETERS</a></b>
       The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to  this  pro-
       gram.   The  text  below  provides  only a parameter summary. See <a href="postconf.5.html"><b>post-</b></a>
       <a href="postconf.5.html"><b>conf</b>(5)</a> for more details including examples.

<b><a name="locking_controls">LOCKING CONTROLS</a></b>
       <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b>
              The maximal number of attempts to acquire an exclusive lock on a
              mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.

       <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b>
              The  time  between  attempts  to  acquire an exclusive lock on a
              mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.

       <b><a href="postconf.5.html#stale_lock_time">stale_lock_time</a> (500s)</b>
              The time after which  a  stale  exclusive  mailbox  lockfile  is
              removed.

       <b><a href="postconf.5.html#mailbox_delivery_lock">mailbox_delivery_lock</a> (see 'postconf -d' output)</b>
              How  to  lock  a  UNIX-style  <a href="local.8.html"><b>local</b>(8)</a> mailbox before attempting
              delivery.

<b><a name="resource_and_rate_controls">RESOURCE AND RATE CONTROLS</a></b>
       <b><a href="postconf.5.html#fork_attempts">fork_attempts</a> (5)</b>
              The maximal number of attempts to fork() a child process.

       <b><a href="postconf.5.html#fork_delay">fork_delay</a> (1s)</b>
              The delay between attempts to fork() a child process.

<b><a name="miscellaneous_controls">MISCELLANEOUS CONTROLS</a></b>
       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
              The default location of the Postfix <a href="postconf.5.html">main.cf</a> and  <a href="master.5.html">master.cf</a>  con-
              figuration files.

       <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
              The  list  of  environment  variables  that a privileged Postfix
              process will  import  from  a  non-Postfix  parent  process,  or
              name=value environment overrides.

<b><a name="see_also">SEE ALSO</a></b>
       <a href="postconf.5.html">postconf(5)</a>, configuration parameters

<b><a name="license">LICENSE</a></b>
       The Secure Mailer license must be distributed with this software.

<b>AUTHOR(S)</b>
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

       Wietse Venema
       Google, Inc.
       111 8th Avenue
       New York, NY 10011, USA

                                                                   POSTLOCK(1)
</pre> </body> </html>