2000-04-30 22:52:26 +04:00
|
|
|
.TH MASTER 8
|
|
|
|
|
.ad
|
|
|
|
|
.fi
|
|
|
|
|
.SH NAME
|
|
|
|
|
master
|
|
|
|
|
\-
|
|
|
|
|
Postfix master process
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.na
|
|
|
|
|
.nf
|
|
|
|
|
.fi
|
2001-05-08 08:55:29 +04:00
|
|
|
\fBmaster\fR [\fB-c \fIconfig_dir\fR] [\fB-e \fIexit_time\fR]
|
|
|
|
|
[\fB-D\fR] [\fB-t\fR] [\fB-v\fR]
|
2000-04-30 22:52:26 +04:00
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.ad
|
|
|
|
|
.fi
|
|
|
|
|
The \fBmaster\fR daemon is the resident process that runs Postfix
|
|
|
|
|
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 \fBmaster\fR daemon is controlled by the
|
|
|
|
|
\fBmaster.cf\fR configuration file. The table specifies zero or
|
|
|
|
|
more servers in the \fBUNIX\fR or \fBINET\fR domain, or servers
|
|
|
|
|
that take requests from a FIFO. Precise configuration details are
|
|
|
|
|
given in the \fBmaster.cf\fR file, and in the manual pages of the
|
|
|
|
|
respective daemons.
|
|
|
|
|
|
|
|
|
|
Options:
|
|
|
|
|
.IP "\fB-c \fIconfig_dir\fR"
|
|
|
|
|
Read the \fBmain.cf\fR and \fBmaster.cf\fR configuration files in
|
2001-03-13 20:45:02 +03:00
|
|
|
the named directory instead of the default configuration directory.
|
2001-05-08 08:55:29 +04:00
|
|
|
.IP "\fB-e \fIexit_time\fR"
|
|
|
|
|
Terminate the master process after \fIexit_time\fR seconds. Child
|
|
|
|
|
processes terminate at their convenience.
|
2000-04-30 22:52:26 +04:00
|
|
|
.IP \fB-D\fR
|
|
|
|
|
After initialization, run a debugger on the master process. The
|
|
|
|
|
debugging command is specified with the \fBdebugger_command\fR in
|
|
|
|
|
the \fBmain.cf\fR global configuration file.
|
|
|
|
|
.IP \fB-t\fR
|
|
|
|
|
Test mode. Return a zero exit status when the \fBmaster.pid\fR lock
|
|
|
|
|
file does not exist or when that file is not locked. This is evidence
|
|
|
|
|
that the \fBmaster\fR daemon is not running.
|
|
|
|
|
.IP \fB-v\fR
|
|
|
|
|
Enable verbose logging for debugging purposes. This option
|
|
|
|
|
is passed on to child processes. Multiple \fB-v\fR options
|
|
|
|
|
make the software increasingly verbose.
|
|
|
|
|
.PP
|
|
|
|
|
Signals:
|
|
|
|
|
.IP \fBSIGHUP\fR
|
|
|
|
|
Upon receipt of a \fBHUP\fR signal (e.g., after \fBpostfix reload\fR),
|
|
|
|
|
the master process re-reads its configuration files. If a service has
|
|
|
|
|
been removed from the \fBmaster.cf\fR file, its running processes
|
|
|
|
|
are terminated immediately.
|
|
|
|
|
Otherwise, running processes are allowed to terminate as soon
|
|
|
|
|
as is convenient, so that changes in configuration settings
|
|
|
|
|
affect only new service requests.
|
|
|
|
|
.IP \fBSIGTERM\fR
|
|
|
|
|
Upon receipt of a \fBTERM\fR signal (e.g., after \fBpostfix abort\fR),
|
|
|
|
|
the master process passes the signal on to its child processes and
|
|
|
|
|
terminates.
|
|
|
|
|
This is useful for an emergency shutdown. Normally one would
|
|
|
|
|
terminate only the master (\fBpostfix stop\fR) and allow running
|
|
|
|
|
processes to finish what they are doing.
|
|
|
|
|
.SH DIAGNOSTICS
|
|
|
|
|
.ad
|
|
|
|
|
.fi
|
|
|
|
|
Problems are reported to \fBsyslogd\fR(8).
|
|
|
|
|
.SH BUGS
|
|
|
|
|
.ad
|
|
|
|
|
.fi
|
|
|
|
|
.SH ENVIRONMENT
|
|
|
|
|
.na
|
|
|
|
|
.nf
|
|
|
|
|
.ad
|
|
|
|
|
.fi
|
|
|
|
|
.IP \fBMAIL_DEBUG\fR
|
|
|
|
|
After initialization, start a debugger as specified with the
|
|
|
|
|
\fBdebugger_command\fR configuration parameter in the \fBmain.cf\fR
|
|
|
|
|
configuration file.
|
|
|
|
|
.IP \fBMAIL_CONFIG\fR
|
|
|
|
|
Directory with Postfix configuration files.
|
|
|
|
|
.SH CONFIGURATION PARAMETERS
|
|
|
|
|
.na
|
|
|
|
|
.nf
|
|
|
|
|
.ad
|
|
|
|
|
.fi
|
|
|
|
|
The following \fBmain.cf\fR parameters are especially relevant to
|
|
|
|
|
this program. See the Postfix \fBmain.cf\fR file for syntax details
|
|
|
|
|
and for default values. Use the \fBpostfix reload\fR command after
|
|
|
|
|
a configuration change.
|
|
|
|
|
.SH Miscellaneous
|
|
|
|
|
.ad
|
|
|
|
|
.fi
|
2001-03-13 20:45:02 +03:00
|
|
|
.IP \fBimport_environment\fR
|
|
|
|
|
.IP \fBexport_environment\fR
|
|
|
|
|
Lists of names of environment parameters that can be imported
|
|
|
|
|
from (exported to) non-Postfix processes.
|
2000-04-30 22:52:26 +04:00
|
|
|
.IP \fBmail_owner\fR
|
|
|
|
|
The owner of the mail queue and of most Postfix processes.
|
|
|
|
|
.IP \fBcommand_directory\fR
|
|
|
|
|
Directory with Postfix support programs.
|
|
|
|
|
.IP \fBdaemon_directory\fR
|
|
|
|
|
Directory with Postfix daemon programs.
|
|
|
|
|
.IP \fBqueue_directory\fR
|
|
|
|
|
Top-level directory of the Postfix queue. This is also the root
|
|
|
|
|
directory of Postfix daemons that run chrooted.
|
|
|
|
|
.SH "Resource controls"
|
|
|
|
|
.ad
|
|
|
|
|
.fi
|
|
|
|
|
.IP \fBdefault_process_limit\fR
|
|
|
|
|
Default limit for the number of simultaneous child processes that
|
|
|
|
|
provide a given service.
|
|
|
|
|
.IP \fBmax_idle\fR
|
|
|
|
|
Limit the time in seconds that a child process waits between
|
|
|
|
|
service requests.
|
|
|
|
|
.IP \fBmax_use\fR
|
|
|
|
|
Limit the number of service requests handled by a child process.
|
|
|
|
|
.IP \fBservice_throttle_time\fR
|
|
|
|
|
Time to avoid forking a server that appears to be broken.
|
|
|
|
|
.SH FILES
|
|
|
|
|
.na
|
|
|
|
|
.nf
|
|
|
|
|
/etc/postfix/main.cf: global configuration file.
|
|
|
|
|
/etc/postfix/master.cf: master process configuration file.
|
|
|
|
|
/var/spool/postfix/pid/master.pid: master lock file.
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.na
|
|
|
|
|
.nf
|
|
|
|
|
qmgr(8) queue manager
|
|
|
|
|
pickup(8) local mail pickup
|
|
|
|
|
syslogd(8) system logging
|
|
|
|
|
.SH LICENSE
|
|
|
|
|
.na
|
|
|
|
|
.nf
|
|
|
|
|
.ad
|
|
|
|
|
.fi
|
|
|
|
|
The Secure Mailer license must be distributed with this software.
|
|
|
|
|
.SH AUTHOR(S)
|
|
|
|
|
.na
|
|
|
|
|
.nf
|
|
|
|
|
Wietse Venema
|
|
|
|
|
IBM T.J. Watson Research
|
|
|
|
|
P.O. Box 704
|
|
|
|
|
Yorktown Heights, NY 10598, USA
|
