NAME

       postlock - lock mail folder and execute command

SYNOPSIS

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

DESCRIPTION

       The  postlock(1)  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(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

       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.  The text below provides only a
       parameter summary. See postconf(5) for more details including examples.

LOCKING CONTROLS

       deliver_lock_attempts (20)
              The  maximal  number  of  attempts  to  acquire  an  exclusive lock on a mailbox file or bounce(8)
              logfile.

       deliver_lock_delay (1s)
              The time between attempts to acquire an exclusive lock on a mailbox file or bounce(8) logfile.

       stale_lock_time (500s)
              The time after which a stale exclusive mailbox lockfile is removed.

       mailbox_delivery_lock (see 'postconf -d' output)
              How to lock a UNIX-style local(8) mailbox before attempting delivery.

RESOURCE AND RATE CONTROLS

       fork_attempts (5)
              The maximal number of attempts to fork() a child process.

       fork_delay (1s)
              The delay between attempts to fork() a child process.

MISCELLANEOUS CONTROLS

       config_directory (see 'postconf -d' output)
              The default location of the Postfix main.cf and master.cf configuration files.

       import_environment (see 'postconf -d' output)
              The list of  environment  parameters  that  a  privileged  Postfix  process  will  import  from  a
              non-Postfix parent process, or name=value environment overrides.

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

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

                                                                                                     POSTLOCK(1)