POSTLOCK(1) POSTLOCK(1)

NAME
       postlock - lock mail folder and execute command

SYNOPSIS
       ppoossttlloocckk [-cc configdir]] [[-ll lockstyle]]
               [[-vv] file command...

DESCRIPTION
       The ppoossttlloocckk command locks file for exclusive access, and executes com-
       mand. The locking method is  compatible  with  the  Postfix  UNIX-style
       local delivery agent.

       Options:

       -cc configdir
              Read  the  mmaaiinn..ccff  configuration  file  in  the named directory
              instead of the default configuration directory.

       -ll lockstyle
              Override the locking method  specified  via  the  mmaaiillbbooxxddeelliivv-
              eerryylloocckk configuration parameter (see below).

       -vv     Enable  verbose  logging  for  debugging  purposes.  Multiple -vv
              options make the software increasingly verbose.

       Arguments:

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

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

DIAGNOSTICS       The result status is 75 (EXTEMPFAIL) when ppoossttlloocckk could  not  perform
       the requested operation.  Otherwise, the exit status is the exit status
       from the command.

BUGS
       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.

ENVIRONMENT       MMAAIILLCCOONNFFIIGG
              Directory with Postfix configuration files.

       MMAAIILLVVEERRBBOOSSEE
              Enable verbose logging for debugging purposes.

CCOONNFFIIGGUURRAATTIIOONN PPAARRAAMMEETTEERRSS
       The following mmaaiinn..ccff parameters are especially relevant to  this  pro-
       gram.   The  text  below  provides  only a parameter summary. See post-
       conf(5) for more details including examples.

LLOOCCKKIINNGG CCOONNTTRROOLLSS
       ddeelliivveerrlloocckkaatttteemmppttss ((2200))
              The maximal number of attempts to acquire an exclusive lock on a
              mailbox file or bounce(8) logfile.

       ddeelliivveerrlloocckkddeellaayy ((11ss))
              The  time  between  attempts  to  acquire an exclusive lock on a
              mailbox file or bounce(8) logfile.

       ssttaalleelloocckkttiimmee ((550000ss))
              The time after which  a  stale  exclusive  mailbox  lockfile  is
              removed.

       mmaaiillbbooxxddeelliivveerryylloocckk ((sseeee ''ppoossttccoonnff -dd'' oouuttppuutt))
              How  to  lock  a  UNIX-style  local(8) mailbox before attempting
              delivery.

RREESSOOUURRCCEE AANNDD RRAATTEE CCOONNTTRROOLLSS
       ffoorrkkaatttteemmppttss ((55))
              The maximal number of attempts to fork() a child process.

       ffoorrkkddeellaayy ((11ss))
              The delay between attempts to fork() a child process.

MMIISSCCEELLLLAANNEEOOUUSS CCOONNTTRROOLLSS
       ccoonnffiiggddiirreeccttoorryy ((sseeee ''ppoossttccoonnff -dd'' oouuttppuutt))
              The default location of the Postfix main.cf and  master.cf  con-
              figuration files.

SEE ALSO
       postconf(5), configuration parameters

LLIICCEENNSSEE
       The Secure Mailer license must be distributed with this software.

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



                                                                   POSTLOCK(1)