NetBSD/gnu/dist/postfix/html/postfix.1.html

158 lines
5.9 KiB
HTML

<html> <head> </head> <body> <pre>
POSTFIX(1) POSTFIX(1)
<b>NAME</b>
postfix - Postfix control program
<b>SYNOPSIS</b>
<b>postfix</b> [<b>-c</b> <i>config_dir</i>] [<b>-D</b>] [<b>-v</b>] <i>command</i>
<b>DESCRIPTION</b>
This command is reserved for the super-user. 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 sets the following environment vari-
ables:
<b>MAIL</b><i>_</i><b>CONFIG</b>
Directory with Postfix configuration files.
<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.
<b>CONFIGURATION</b> <b>PARAMETERS</b>
The following <b>main.cf</b> configuration parameters are made
available as process 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 sendmail command.
<b>newaliases</b><i>_</i><b>path</b>
The full pathname for the Postfix newaliases com-
mand.
<b>mailq</b><i>_</i><b>path</b>
The full pathname for the Postfix mailq 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="master.8.html">master(8)</a> Postfix master program
<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>