postlock(1)

1POSTLOCK(1)                 General Commands Manual                POSTLOCK(1)
2
3
4

NAME

6       postlock - lock mail folder and execute command
7

SYNOPSIS

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

DESCRIPTION

13       The  postlock(1)  command locks file for exclusive access, and executes
14       command. The locking method is compatible with the  Postfix  UNIX-style
15       local delivery agent.
16
17       Options:
18
19       -c config_dir
20              Read  the  main.cf  configuration  file  in  the named directory
21              instead of the default configuration directory.
22
23       -l lock_style
24              Override the locking method  specified  via  the  mailbox_deliv‐
25              ery_lock configuration parameter (see below).
26
27       -v     Enable  verbose  logging  for  debugging  purposes.  Multiple -v
28              options make the software increasingly verbose.
29
30       Arguments:
31
32       file   A mailbox file. The user should have read/write permission.
33
34       command...
35              The command to  execute  while  file  is  locked  for  exclusive
36              access.   The  command is executed directly, i.e. without inter‐
37              pretation by a shell command interpreter.
38

DIAGNOSTICS

40       The result status is 75 (EX_TEMPFAIL) when postlock(1) could  not  per‐
41       form  the  requested operation.  Otherwise, the exit status is the exit
42       status from the command.
43

BUGS

45       With remote file systems, the ability to acquire a lock does not neces‐
46       sarily  eliminate access conflicts. Avoid file access by processes run‐
47       ning on different machines.
48

ENVIRONMENT

50       MAIL_CONFIG
51              Directory with Postfix configuration files.
52
53       MAIL_VERBOSE
54              Enable verbose logging for debugging purposes.
55

CONFIGURATION PARAMETERS

57       The following main.cf parameters are especially relevant to  this  pro‐
58       gram.   The  text  below  provides  only a parameter summary. See post‐
59       conf(5) for more details including examples.
60

LOCKING CONTROLS

62       deliver_lock_attempts (20)
63              The maximal number of attempts to acquire an exclusive lock on a
64              mailbox file or bounce(8) logfile.
65
66       deliver_lock_delay (1s)
67              The  time  between  attempts  to  acquire an exclusive lock on a
68              mailbox file or bounce(8) logfile.
69
70       stale_lock_time (500s)
71              The time after which  a  stale  exclusive  mailbox  lockfile  is
72              removed.
73
74       mailbox_delivery_lock (see 'postconf -d' output)
75              How  to  lock  a  UNIX-style  local(8) mailbox before attempting
76              delivery.
77

RESOURCE AND RATE CONTROLS

79       fork_attempts (5)
80              The maximal number of attempts to fork() a child process.
81
82       fork_delay (1s)
83              The delay between attempts to fork() a child process.
84

MISCELLANEOUS CONTROLS

86       config_directory (see 'postconf -d' output)
87              The default location of the Postfix main.cf and  master.cf  con‐
88              figuration files.
89
90       import_environment (see 'postconf -d' output)
91              The  list  of  environment  parameters that a privileged Postfix
92              process will  import  from  a  non-Postfix  parent  process,  or
93              name=value environment overrides.
94

LICENSE

99       The Secure Mailer license must be distributed with this software.
100

AUTHOR(S)

102       Wietse Venema
103       IBM T.J. Watson Research
104       P.O. Box 704
105       Yorktown Heights, NY 10598, USA
106
107       Wietse Venema
108       Google, Inc.
109       111 8th Avenue
110       New York, NY 10011, USA
111
112
113
114                                                                   POSTLOCK(1)