File: master.8.html

package info (click to toggle)
postfix 0.0.19991231pl11-2
  • links: PTS
  • area: main
  • in suites: potato
  • size: 5,044 kB
  • ctags: 4,401
  • sloc: ansic: 33,767; makefile: 5,099; sh: 1,790; awk: 19
file content (200 lines) | stat: -rw-r--r-- 6,130 bytes parent folder | download
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
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
<html> <head> </head> <body> <pre>



MASTER(8)                                               MASTER(8)


<b>NAME</b>
       master - Postfix master process

<b>SYNOPSIS</b>
       <b>master</b> [<b>-c</b> <i>config_dir</i>] [<b>-D</b>] [<b>-t</b>] [<b>-v</b>]

<b>DESCRIPTION</b>
       The  <b>master</b> daemon is the resident process that runs Post-
       fix daemons on demand: daemons to send or receive messages
       via  the  network,  daemons  to deliver mail locally, etc.
       These daemons are created on demand up to  a  configurable
       maximum number per service.

       Postfix  daemons terminate voluntarily, either after being
       idle for a configurable amount of time,  or  after  having
       serviced  a configurable number of requests. The exception
       to this rule is the resident Postfix queue manager.

       The behavior of the <b>master</b> daemon  is  controlled  by  the
       <b>master.cf</b>  configuration file. The table specifies zero or
       more servers in the <b>UNIX</b> or <b>INET</b> domain, or  servers  that
       take  requests  from a FIFO. Precise configuration details
       are given in the <b>master.cf</b> file, and in the  manual  pages
       of the respective daemons.

       Options:

       <b>-c</b> <i>config_dir</i>
              Read  the <b>main.cf</b> and <b>master.cf</b> configuration files
              in the named directory.

       <b>-D</b>     After initialization, run a debugger on the  master
              process.  The  debugging  command is specified with
              the <b>debugger</b><i>_</i><b>command</b> in the <b>main.cf</b> global configu-
              ration file.

       <b>-t</b>     Test  mode. Return a zero exit status when the <b>mas-</b>
              <b>ter.pid</b> lock file does not exist or when that  file
              is  not  locked.   This is evidence that the <b>master</b>
              daemon is not running.

       <b>-v</b>     Enable verbose logging for debugging purposes. This
              option is passed on to child processes. Multiple <b>-v</b>
              options make the software increasingly verbose.

       Signals:

       <b>SIGHUP</b> Upon receipt of a <b>HUP</b> signal (e.g.,  after  <b>postfix</b>
              <b>reload</b>), the master process re-reads its configura-
              tion files. If a service has been removed from  the
              <b>master.cf</b>  file,  its  running processes are termi-
              nated immediately.   Otherwise,  running  processes
              are  allowed to terminate as soon as is convenient,
              so that changes in  configuration  settings  affect



                                                                1





MASTER(8)                                               MASTER(8)


              only new service requests.

       <b>SIGTERM</b>
              Upon  receipt of a <b>TERM</b> signal (e.g., after <b>postfix</b>
              <b>abort</b>), the master process passes the signal on  to
              its child processes and terminates.  This is useful
              for an emergency shutdown. Normally one would  ter-
              minate  only  the  master  (<b>postfix</b> <b>stop</b>) and allow
              running processes to finish what they are doing.

<b>DIAGNOSTICS</b>
       Problems are reported to <b>syslogd</b>(8).

<b>BUGS</b>
<b>ENVIRONMENT</b>
       <b>MAIL</b><i>_</i><b>DEBUG</b>
              After initialization, start a debugger as specified
              with  the  <b>debugger</b><i>_</i><b>command</b> configuration parameter
              in the <b>main.cf</b> configuration file.

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

<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.  Use  the  <b>postfix</b>  <b>reload</b>
       command after a configuration change.

<b>Miscellaneous</b>
       <b>mail</b><i>_</i><b>owner</b>
              The  owner  of  the  mail queue and of most Postfix
              processes.

       <b>command</b><i>_</i><b>directory</b>
              Directory with Postfix support programs.

       <b>daemon</b><i>_</i><b>directory</b>
              Directory with Postfix daemon programs.

       <b>queue</b><i>_</i><b>directory</b>
              Top-level directory of the Postfix queue.  This  is
              also the root directory of Postfix daemons that run
              chrooted.

<b>Resource</b> <b>controls</b>
       <b>default</b><i>_</i><b>process</b><i>_</i><b>limit</b>
              Default limit for the number of simultaneous  child
              processes that provide a given service.

       <b>max</b><i>_</i><b>idle</b>
              Limit  the  time  in  seconds  that a child process
              waits between service requests.




                                                                2





MASTER(8)                                               MASTER(8)


       <b>max</b><i>_</i><b>use</b>
              Limit the number of service requests handled  by  a
              child process.

       <b>service</b><i>_</i><b>throttle</b><i>_</i><b>time</b>
              Time  to  avoid forking a server that appears to be
              broken.

<b>FILES</b>
       /etc/postfix/main.cf: global configuration file.
       /etc/postfix/master.cf: master process configuration file.
       /var/spool/postfix/pid/master.pid: master lock file.

<b>SEE</b> <b>ALSO</b>
       <a href="qmgr.8.html">qmgr(8)</a> queue manager
       <a href="pickup.8.html">pickup(8)</a> local mail pickup
       syslogd(8) system logging

<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






























                                                                3


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