summaryrefslogtreecommitdiff
path: root/gnu/dist/postfix/html/postlock.1.html
blob: 8cc19092f14a9e72c9d1b888f0b6d2a0a0b4ab35 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
<html> <head> </head> <body> <pre>



POSTLOCK(1)                                           POSTLOCK(1)


<b>NAME</b>
       postlock - lock mail folder and execute command

<b>SYNOPSIS</b>
       <b>postlock</b> [<b>-c</b> <i>config_dir</i><b>]</b> <b>[-l</b> <i>lock_style</i><b>]</b> <b>[-v</b>] <i>file</i> <i>com-</i>
       <i>mand...</i>

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

       Options:

       <b>-c</b> <i>config_dir</i>
              Read the <b>main.cf</b> configuration file  in  the  named
              directory  instead  of  the  default  configuration
              directory.

       <b>-l</b> <i>lock_style</i>
              Override the locking method specified via the <b>mail-</b>
              <b>box</b><i>_</i><b>delivery</b><i>_</i><b>lock</b>   configuration   parameter  (see
              below).

       <b>-v</b>     Enable verbose logging for debugging purposes. Mul-
              tiple  <b>-v</b>  options  make  the software increasingly
              verbose.

       Arguments:

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

       <i>command...</i>
              The  command  to  execute  while <i>file</i> is locked for
              exclusive  access.    The   command   is   executed
              directly,  i.e.  without  interpretation by a shell
              command interpreter.

<b>DIAGNOSTICS</b>
       The result status is 75 (EX_TEMPFAIL) when <b>postlock</b>  could
       not  perform the requested operation.  Otherwise, the exit
       status is the exit status from the command.

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

<b>ENVIRONMENT</b>
       <b>MAIL</b><i>_</i><b>CONFIG</b>
              Directory with Postfix configuration files.





                                                                1





POSTLOCK(1)                                           POSTLOCK(1)


       <b>MAIL</b><i>_</i><b>VERBOSE</b>
              Enable verbose logging for debugging purposes.

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

<b>Locking</b> <b>controls</b>
       <b>deliver</b><i>_</i><b>lock</b><i>_</i><b>attempts</b>
              Limit the number of attempts to acquire  an  exclu-
              sive lock.

       <b>deliver</b><i>_</i><b>lock</b><i>_</i><b>delay</b>
              Time  in  seconds  between  successive  attempts to
              acquire an exclusive lock.

       <b>stale</b><i>_</i><b>lock</b><i>_</i><b>time</b>
              Limit the time after which a stale lock is removed.

       <b>mailbox</b><i>_</i><b>delivery</b><i>_</i><b>lock</b>
              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 <b>postconf</b> <b>-l</b> command.

<b>Resource</b> <b>controls</b>
       <b>fork</b><i>_</i><b>attempts</b>
              Number of attempts to <b>fork</b>() a process before  giv-
              ing up.

       <b>fork</b><i>_</i><b>delay</b>
              Delay   in   seconds   between   successive  <b>fork</b>()
              attempts.

<b>LICENSE</b>
       The Secure Mailer license must be  distributed  with  this
       software.

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













                                                                2


</pre> </body> </html>