summaryrefslogtreecommitdiff
path: root/gnu/dist/postfix/html/postsuper.1.html
blob: d4dbb09a55d51f007bb808477fdab8a2e1108146 (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
135
136
137
138
139
140
<html> <head> </head> <body> <pre>

POSTSUPER(1)                                         POSTSUPER(1)

<b>NAME</b>
       postsuper - Postfix superintendent

<b>SYNOPSIS</b>
       <b>postsuper</b> [<b>-psv</b>] [<b>-d</b> <i>queue_id</i>] [<b>-r</b> <i>queue_id</i>] [<i>directory</i>
       <i>...</i>]

<b>DESCRIPTION</b>
       The <b>postsuper</b> command does maintenance jobs on the Postfix
       queue. Use of the command is restricted to the super-user.

       By default, <b>postsuper</b> performs  the  operations  requested
       with  the  <b>-s</b>  and  <b>-p</b> command-line options on all Postfix
       queue directories - this includes the <b>incoming</b>, <b>active</b> and
       <b>deferred</b> directories with mail files and the <b>bounce</b>, <b>defer</b>
       and <b>flush</b> directories with log files.

       Options:

       <b>-d</b> <i>queue_id</i>
              Delete one message with the named queue ID from the
              named  mail queue(s) (default: <b>incoming</b>, <b>active</b> and
              <b>deferred</b>).  If a <i>queue_id</i> of <b>-</b>  is  specified,  the
              program reads queue IDs from standard input.

              Specify <b>-d</b> <b>ALL</b> to remove all messages; for example,
              specify <b>-d</b> <b>ALL</b>  <b>deferred</b>  to  delete  mail  in  the
              <b>deferred</b>  queue.  As a safety measure, the word <b>ALL</b>
              must be specified in upper case.

              <b>Postfix</b> <b>queue</b> <b>IDs</b> <b>are</b>  <b>reused.</b>   <b>There</b>  <b>is</b>  <b>a</b>  <b>very</b>
              <b>small</b>  <b>possibility</b> <b>that</b> <b>postsuper</b> <b>deletes</b> <b>the</b> <b>wrong</b>
              <b>message</b> <b>file</b> <b>when</b> <b>it</b> <b>is</b> <b>executed</b> <b>while</b> <b>the</b>  <b>Postfix</b>
              <b>mail</b> <b>system</b> <b>is</b> <b>running.</b>

              The scenario is as follows:

              1)     The  Postfix  queue manager deletes the mes-
                     sage that <b>postsuper</b> is supposed  to  delete,
                     because  Postfix  is  finished with the mes-
                     sage.

              2)     New mail arrives, and  the  new  message  is
                     given  the same queue ID as the message that
                     <b>postsuper</b> is supposed to delete.  The proba-
                     bility  for  reusing  a  deleted queue ID is
                     about 1 in 2**15 (the  number  of  different
                     microsecond values that the system clock can
                     distinguish within a second).

              3)     <b>postsuper</b> deletes the new  message,  instead
                     of  the  old  message  that  it  should have
                     deleted.

       <b>-p</b>     Purge old temporary files that are left over  after
              system or software crashes.

       <b>-r</b> <i>queue_id</i>
              Requeue  the  message  with the named queue ID from
              the named mail queue(s) (default: <b>incoming</b>,  <b>active</b>
              and <b>deferred</b>).  To requeue multiple messages, spec-
              ify multiple  <b>-r</b>  command-line  options.   Alterna-
              tively,  if  a <i>queue_id</i> of <b>-</b> is specified, the pro-
              gram reads queue IDs from standard input.

              Specify <b>-r</b> <b>ALL</b> to requeue all messages. As a safety
              measure,  the  word  <b>ALL</b> must be specified in upper
              case.

              A requeued message is moved to the <b>maildrop</b>  queue,
              from  where  it is copied by the pickup daemon to a
              new file whose name is guaranteed to match the  new
              queue file inode number. The new queue file is sub-
              jected again to mail address rewriting and  substi-
              tution. This is useful when rewriting rules or vir-
              tual mappings have changed.

              Postfix queue IDs are  reused.   There  is  a  very
              small possibility that <b>postsuper</b> requeues the wrong
              message file when it is executed while the  Postfix
              mail system is running, but no harm should be done.

       <b>-s</b>     Structure check and structure repair.  It is highly
              recommended  to  perform this operation once before
              Postfix startup.

              <b>o</b>      Rename files whose name does not  match  the
                     message file inode number. This operation is
                     necessary after restoring a mail queue  from
                     a different machine, or from backup media.

              <b>o</b>      Move queue files that are in the wrong place
                     in the file system hierarchy and remove sub-
                     directories that are no longer needed.  File
                     position rearrangements are necessary  after
                     a  change  in  the  <b>hash</b><i>_</i><b>queue</b><i>_</i><b>names</b>  and/or
                     <b>hash</b><i>_</i><b>queue</b><i>_</i><b>depth</b> configuration parameters.

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

<b>DIAGNOSTICS</b>
       Problems are reported to the standard error stream and  to
       <b>syslogd</b>.

       <b>postsuper</b>  reports the number of messages deleted with <b>-d</b>,
       the number of messages requeued with <b>-r</b>, and the number of
       messages  whose  queue  file  name  was fixed with <b>-s</b>. The
       report is written to the standard error stream and to <b>sys-</b>
       <b>logd</b>.

<b>CONFIGURATION</b> <b>PARAMETERS</b>
       See  the  Postfix  <b>main.cf</b> file for syntax details and for
       default values.

       <b>hash</b><i>_</i><b>queue</b><i>_</i><b>depth</b>
              Number of subdirectory levels for hashed queues.

       <b>hash</b><i>_</i><b>queue</b><i>_</i><b>names</b>
              The names of queues that are organized into  multi-
              ple levels of subdirectories.

<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

                                                                1

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