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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
<html> <head> </head> <body> <pre>
POSTFIX(1) POSTFIX(1)
<b>NAME</b>
postfix - Postfix control program
<b>SYNOPSIS</b>
<b>postfix</b> [<b>-Dv</b>] [<b>-c</b> <i>config_dir</i>] <i>command</i>
<b>DESCRIPTION</b>
This command is reserved for the superuser. To submit
mail, use the Postfix <b>sendmail</b> command.
The <b>postfix</b> command controls the operation of the Postfix
mail system: start or stop the <b>master</b> daemon, do a health
check, and other maintenance.
The <b>postfix</b> command sets up a standardized environment and
runs the <b>postfix-script</b> shell script to do the actual
work.
The following commands are implemented:
<b>check</b> Validate the Postfix mail system configuration.
Warn about bad directory/file ownership or permis-
sions, and create missing directories.
<b>start</b> Start the Postfix mail system. This also runs the
configuration check described above.
<b>stop</b> Stop the Postfix mail system in an orderly fashion.
Running processes are allowed to terminate at their
earliest convenience.
Note: in order to refresh the Postfix mail system
after a configuration change, do not use the <b>start</b>
and <b>stop</b> commands in succession. Use the <b>reload</b>
command instead.
<b>abort</b> Stop the Postfix mail system abruptly. Running pro-
cesses are signaled to stop immediately.
<b>flush</b> Force delivery: attempt to deliver every message in
the deferred mail queue. Normally, attempts to
deliver delayed mail happen at regular intervals,
the interval doubling after each failed attempt.
<b>reload</b> Re-read configuration files. Running processes ter-
minate at their earliest convenience.
The following options are implemented:
<b>-c</b> <i>config_dir</i>
Read the <b>main.cf</b> and <b>master.cf</b> configuration files
in the named directory instead of the default con-
figuration directory. Use this to distinguish
between multiple Postfix instances on the same
host.
<b>-D</b> (with <b>postfix</b> <b>start</b> only)
Run each Postfix daemon under control of a debugger
as specified via the <b>debugger</b><i>_</i><b>command</b> configuration
parameter.
<b>-v</b> Enable verbose logging for debugging purposes. Mul-
tiple <b>-v</b> options make the software increasingly
verbose.
<b>ENVIRONMENT</b>
The <b>postfix</b> command exports the following environment
variables before executing the <b>postfix-script</b> file:
<b>MAIL</b><i>_</i><b>CONFIG</b>
This is set when the -c command-line option is pre-
sent.
<b>MAIL</b><i>_</i><b>VERBOSE</b>
This is set when the -v command-line option is pre-
sent.
<b>MAIL</b><i>_</i><b>DEBUG</b>
This is set when the -D command-line option is pre-
sent.
The following <b>main.cf</b> configuration parameters are
exported as environment variables with the same names:
<b>command</b><i>_</i><b>directory</b>
Directory with Postfix administrative commands.
<b>daemon</b><i>_</i><b>directory</b>
Directory with Postfix daemon programs.
<b>config</b><i>_</i><b>directory</b>
Directory with Postfix configuration files and with
administrative shell scripts.
<b>queue</b><i>_</i><b>directory</b>
The directory with Postfix queue files, with local
inter-process communication endpoints, and with
files needed for daemon programs that run in the
optional chrooted environment.
<b>mail</b><i>_</i><b>owner</b>
The owner of Postfix queue files and of most Post-
fix processes.
<b>setgid</b><i>_</i><b>group</b>
The group for mail submission and queue management
commands.
<b>sendmail</b><i>_</i><b>path</b>
The full pathname for the Postfix <b>sendmail</b> command.
<b>newaliases</b><i>_</i><b>path</b>
The full pathname for the Postfix <b>newaliases</b> com-
mand.
<b>mailq</b><i>_</i><b>path</b>
The full pathname for the Postfix <b>mailq</b> command.
<b>manpage</b><i>_</i><b>directory</b>
The directory for the Postfix on-line manual pages.
<b>sample</b><i>_</i><b>directory</b>
The directory for the Postfix sample configuration
files.
<b>readme</b><i>_</i><b>directory</b>
The directory for the Postfix README files.
<b>Other</b> <b>configuration</b> <b>parameters</b>
<b>import</b><i>_</i><b>environment</b>
List of names of environment parameters that can be
imported from non-Postfix processes.
<b>FILES</b>
$<b>config</b><i>_</i><b>directory/postfix-script</b>, administrative commands
$<b>config</b><i>_</i><b>directory/main.cf</b>, configuration parameters
$<b>config</b><i>_</i><b>directory/master.cf</b>, Postfix daemon processes
<b>SEE</b> <b>ALSO</b>
<a href="postconf.1.html">postconf(1)</a> Postfix configuration management
<a href="postsuper.1.html">postsuper(1)</a> Postfix housekeeping
<a href="sendmail.1.html">sendmail(1)</a> Sendmail-compatible interface
<a href="postmap.1.html">postmap(1)</a> Postfix lookup table management
<a href="master.8.html">master(8)</a> Postfix master daemon
The respective manual pages for the daemon processes spec-
ified in the <b>master.cf</b> file, and the manual pages refer-
enced by those manual pages.
<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
POSTFIX(1)
</pre> </body> </html>
|