NAME

postlock - lock mail folder and execute command

SYNOPSIS



ppoossttlloocckk [--cc _c_o_n_f_i_g___d_i_r]] [[--ll _l_o_c_k___s_t_y_l_e]]
        [[--vv] _f_i_l_e _c_o_m_m_a_n_d_._._.

DESCRIPTION

The ppoossttlloocckk(1) command locks _f_i_l_e for exclusive access, and executes _c_o_m_m_a_n_d. The locking method is compatible with the Postfix UNIX-style local delivery agent.

Options:

--cc _c_o_n_f_i_g___d_i_r Read the mmaaiinn..ccff configuration file in the named directory
instead of the default configuration directory.
--ll _l_o_c_k___s_t_y_l_e Override the locking method specified via the
mmaaiillbbooxx__ddeelliivveerryy__lloocckk configuration parameter (see below).
--vv Enable verbose logging for debugging purposes. Multiple --vv
options make the software increasingly verbose.

Arguments:

_f_i_l_e A mailbox file. The user should have read/write permission.
_c_o_m_m_a_n_d_._._. The command to execute while _f_i_l_e 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 ppoossttlloocckk(1) 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 necessarily eliminate access conflicts. Avoid file access by processes running on different machines.

ENVIRONMENT



MMAAIILL__CCOONNFFIIGG Directory with Postfix configuration files.
MMAAIILL__VVEERRBBOOSSEE Enable verbose logging for debugging purposes.

CONFIGURATION PARAMETERS



The following mmaaiinn..ccff parameters are especially relevant to
this program.
The text below provides only a parameter summary. See
ppoossttccoonnff(5) for more details including examples.

LOCKING CONTROLS



ddeelliivveerr__lloocckk__aatttteemmppttss ((2200)) The maximal number of attempts to acquire an exclusive lock on a
mailbox file or bboouunnccee(8) logfile.
ddeelliivveerr__lloocckk__ddeellaayy ((11ss)) The time between attempts to acquire an exclusive lock on a mailbox
file or bboouunnccee(8) logfile.
ssttaallee__lloocckk__ttiimmee ((550000ss)) The time after which a stale exclusive mailbox lockfile is removed.
mmaaiillbbooxx__ddeelliivveerryy__lloocckk ((sseeee ''ppoossttccoonnff --dd'' oouuttppuutt)) How to lock a UNIX-style llooccaall(8) mailbox before attempting delivery.

RESOURCE AND RATE CONTROLS



ffoorrkk__aatttteemmppttss ((55)) The maximal number of attempts to fork() a child process.
ffoorrkk__ddeellaayy ((11ss)) The delay between attempts to fork() a child process.

MISCELLANEOUS CONTROLS



ccoonnffiigg__ddiirreeccttoorryy ((sseeee ''ppoossttccoonnff --dd'' oouuttppuutt)) The default location of the Postfix main.cf and master.cf
configuration files.

SEE ALSO


postconf(5), configuration parameters

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