1
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2
"http://www.w3.org/TR/html4/loose.dtd">
4
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5
<title> Postfix manual - master(5) </title>
10
master - Postfix master process configuration file format
13
The Postfix mail system is implemented by small number of
14
(mostly) client commands that are invoked by users, and by
15
a larger number of services that run in the background.
17
Postfix services are implemented by daemon processes.
18
These run in the background under control of the <a href="master.8.html"><b>master</b>(8)</a>
19
process. The master.cf configuration file defines how a
20
client program connects to a service, and what daemon pro-
21
gram runs when a service is requested. Most daemon pro-
22
cesses are short-lived and terminate after serving <b><a href="postconf.5.html#max_use">max_use</a></b>
23
clients, or after inactivity for <b><a href="postconf.5.html#max_idle">max_idle</a></b> or more units of
26
All daemons specified here must speak a Postfix-internal
27
protocol. In order to execute non-Postfix software use the
28
<a href="local.8.html"><b>local</b>(8)</a>, <a href="pipe.8.html"><b>pipe</b>(8)</a> or <a href="spawn.8.html"><b>spawn</b>(8)</a> services, or run the server
29
under control by <b>inetd</b>(8) or equivalent.
31
After changing master.cf you must execute "<b>postfix reload</b>"
32
to reload the configuration.
35
The general format of the master.cf file is as follows:
37
<b>o</b> Each logical line defines a single Postfix service.
38
Each service is identified by its name and type as
39
described below. When multiple lines specify the
40
same service name and type, only the last one is
41
remembered. Otherwise, the order of master.cf ser-
42
vice definitions does not matter.
44
<b>o</b> Empty lines and whitespace-only lines are ignored,
45
as are lines whose first non-whitespace character
48
<b>o</b> A logical line starts with non-whitespace text. A
49
line that starts with whitespace continues a logi-
52
Each logical line consists of eight fields separated by
53
whitespace. These are described below in the order as
54
they appear in the master.cf file.
56
Where applicable a field of "-" requests that the built-in
57
default value be used. For boolean fields specify "y" or
58
"n" to override the default value.
61
The service name syntax depends on the service type
65
Specify one of the following service types:
67
<b>inet</b> The service listens on a TCP/IP socket and
68
is accessible via the network.
70
The service name is specified as <i>host:port</i>,
71
denoting the host and port on which new con-
72
nections should be accepted. The host part
73
(and colon) may be omitted. Either host or
74
port may be given in symbolic form (host or
75
service name) or in numeric form (IP address
76
or port number). Host information may be
77
enclosed inside "[]", but this form is not
80
Examples: a service named <b>127.0.0.1:smtp</b> or
81
<b>::1:smtp</b> receives mail via the loopback
82
interface only; and a service named <b>10025</b>
83
accepts connections on TCP port 10025 via
84
all interfaces configured with the
85
<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a></b> parameter.
87
Note: with Postfix version 2.2 and later
88
specify "<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a> = loopback-only</b>" in
89
main.cf, instead of hard-coding loopback IP
90
address information in master.cf or in
93
<b>unix</b> The service listens on a UNIX-domain socket
94
and is accessible for local clients only.
96
The service name is a pathname relative to
97
the Postfix queue directory (pathname con-
98
trolled with the <b><a href="postconf.5.html#queue_directory">queue_directory</a></b> configura-
99
tion parameter in main.cf).
101
On Solaris systems the <b>unix</b> type is imple-
102
mented with streams sockets.
104
<b>fifo</b> The service listens on a FIFO (named pipe)
105
and is accessible for local clients only.
107
The service name is a pathname relative to
108
the Postfix queue directory (pathname con-
109
trolled with the <b><a href="postconf.5.html#queue_directory">queue_directory</a></b> configura-
110
tion parameter in main.cf).
112
<b>Private (default: y)</b>
113
Whether or not access is restricted to the mail
114
system. Internet (type <b>inet</b>) services can't be
117
<b>Unprivileged (default: y)</b>
118
Whether the service runs with root privileges or as
119
the owner of the Postfix system (the owner name is
120
controlled by the <b><a href="postconf.5.html#mail_owner">mail_owner</a></b> configuration variable
121
in the main.cf file).
123
The <a href="local.8.html"><b>local</b>(8)</a>, <a href="pipe.8.html"><b>pipe</b>(8)</a>, <a href="spawn.8.html"><b>spawn</b>(8)</a>, and <a href="virtual.8.html"><b>virtual</b>(8)</a>
124
daemons require privileges.
126
<b>Chroot (default: y)</b>
127
Whether or not the service runs chrooted to the
128
mail queue directory (pathname is controlled by the
129
<b><a href="postconf.5.html#queue_directory">queue_directory</a></b> configuration variable in the
132
Chroot should not be used with the <a href="local.8.html"><b>local</b>(8)</a>,
133
<a href="pipe.8.html"><b>pipe</b>(8)</a>, <a href="spawn.8.html"><b>spawn</b>(8)</a>, and <a href="virtual.8.html"><b>virtual</b>(8)</a> daemons.
134
Although the <a href="proxymap.8.html"><b>proxymap</b>(8)</a> server can run chrooted,
135
doing so defeats most of the purpose of having that
136
service in the first place.
138
The files in the examples/chroot-setup subdirectory
139
of the Postfix source archive describe how to set
140
up a Postfix chroot environment for your type of
141
machine, and <a href="BASIC_CONFIGURATION_README.html">BASIC_CONFIGURATION_README</a> discusses
142
issues related to running daemons chrooted.
144
<b>Wake up time (default: 0)</b>
145
Automatically wake up the named service after the
146
specified number of seconds. The wake up is imple-
147
mented by connecting to the service and sending a
148
wake up request. A ? at the end of the wake-up
149
time field requests that wake up events be sent
150
only to services that are actually being used.
151
Specify 0 for no automatic wake up.
153
The <a href="pickup.8.html"><b>pickup</b>(8)</a>, <a href="qmgr.8.html"><b>qmgr</b>(8)</a> and <a href="flush.8.html"><b>flush</b>(8)</a> daemons require
156
<b>Process limit (default: $<a href="postconf.5.html#default_process_limit">default_process_limit</a>)</b>
157
The maximum number of processes that may execute
158
this service simultaneously. Specify 0 for no
161
NOTE: Some Postfix services must be configured as a
162
single-process service (for example, <a href="qmgr.8.html"><b>qmgr</b>(8)</a>) and
163
some services must be configured with no process
164
limit (for example, <a href="cleanup.8.html"><b>cleanup</b>(8)</a>). These limits must
167
<b>Command name + arguments</b>
168
The command to be executed. Characters that are
169
special to the shell such as ">" or "|" have no
170
special meaning here, and quotes cannot be used to
171
protect arguments containing whitespace.
173
The command name is relative to the Postfix daemon
174
directory (pathname is controlled by the <b><a href="postconf.5.html#daemon_directory">dae</a>-</b>
175
<b><a href="postconf.5.html#daemon_directory">mon_directory</a></b> configuration variable).
177
The command argument syntax for specific commands
178
is specified in the respective daemon manual page.
180
The following command-line options have the same
181
effect for all daemon programs:
183
<b>-D</b> Run the daemon under control by the command
184
specified with the <b><a href="postconf.5.html#debugger_command">debugger_command</a></b> variable
185
in the main.cf configuration file. See
186
<a href="DEBUG_README.html">DEBUG_README</a> for hints and tips.
188
<b>-o</b> <i>name</i>=<i>value</i>
189
Override the named main.cf configuration
190
parameter. The parameter value can refer to
191
other parameters as <i>$name</i> etc., just like in
192
main.cf. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for syntax.
194
NOTE 1: do not specify whitespace around the
195
"=". In parameter values, either avoid
196
whitespace altogether, use commas instead of
197
spaces, or consider overrides like "-o
198
name=$override_parameter" with $over-
199
ride_parameter set in main.cf.
201
NOTE 2: Over-zealous use of parameter over-
202
rides makes the Postfix configuration hard
203
to understand and maintain. At a certain
204
point, it might be easier to configure mul-
205
tiple instances of Postfix, instead of con-
206
figuring multiple personalities via mas-
209
<b>-v</b> Increase the verbose logging level. Specify
210
multiple <b>-v</b> options to make a Postfix daemon
211
process increasingly verbose.
214
<a href="master.8.html">master(8)</a>, process manager
215
<a href="postconf.5.html">postconf(5)</a>, configuration parameters
218
<a href="BASIC_CONFIGURATION_README.html">BASIC_CONFIGURATION_README</a>, basic configuration
219
<a href="DEBUG_README.html">DEBUG_README</a>, Postfix debugging
222
The Secure Mailer license must be distributed with this
228
Lund Institute of Technology
232
IBM T.J. Watson Research
234
Yorktown Heights, NY 10598, USA
237
</pre> </body> </html>