redhat man page for postlock

POSTLOCK(1)						      General Commands Manual						       POSTLOCK(1)

NAME
       postlock - lock mail folder and execute command

SYNOPSIS
       postlock [-c config_dir] [-l lock_style] [-v] file command...

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

       Options:

       -c config_dir
	      Read the main.cf configuration file in the named directory instead of the default configuration directory.

       -l lock_style
	      Override the locking method specified via the mailbox_delivery_lock configuration parameter (see below).

       -v     Enable verbose logging for debugging purposes. Multiple -v 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 interpretation	by
	      a shell command interpreter.

DIAGNOSTICS
       The result status is 75 (EX_TEMPFAIL) when postlock could not perform the requested operation.  Otherwise, the exit status is the exit sta-
       tus from the command.

BUGS
       With remote file systems, the ability to acquire a lock does not necessarily eliminate access conflicts. Avoid  file  access  by  processes
       running on different machines.

ENVIRONMENT
       MAIL_CONFIG
	      Directory with Postfix configuration files.

       MAIL_VERBOSE
	      Enable verbose logging for debugging purposes.

CONFIGURATION PARAMETERS
       The  following  main.cf parameters are especially relevant to this program. See the Postfix main.cf file for syntax details and for default
       values.

Locking controls
       deliver_lock_attempts
	      Limit the number of attempts to acquire an exclusive lock.

       deliver_lock_delay
	      Time in seconds between successive attempts to acquire an exclusive lock.

       stale_lock_time
	      Limit the time after which a stale lock is removed.

       mailbox_delivery_lock
	      What file locking method(s) to use when delivering to a UNIX-style mailbox.  The default setting is system dependent.  For a list of
	      available file locking methods, use the postconf -l command.

Resource controls
       fork_attempts
	      Number of attempts to fork() a process before giving up.

       fork_delay
	      Delay in seconds between successive fork() attempts.

LICENSE
       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)