.TH SMTPD 8 "$Mdocdate: March 13 2014 $" ""
.SH NAME
.ad l
\fB\%smtpd\fP
\- Simple Mail Transfer Protocol daemon
.SH SYNOPSIS
.ad l
.br
\fB\%smtpd\fP
[\fB\-dnv\fP]
[\fB\-D\fP \fImacro\fP=\fIvalue\fP]
[\fB\-f\fP \fIfile\fP]
[\fB\-P\fP \fIsystem\fP]
.SH DESCRIPTION
.ad l
\fB\%smtpd\fP
is a Simple Mail Transfer Protocol
(SMTP)
daemon which can be used as a machine's primary mail system.
\fB\%smtpd\fP
can listen on a network interface and handle SMTP
transactions; it can also be fed messages through the standard
\fBsendmail\fP(8)
interface.
It can relay messages through remote mail transfer agents or store them
locally using either the mbox or maildir format.
This implementation supports SMTP as defined by RFC 5321 as well as several
extensions.
A running
\fB\%smtpd\fP
can be controlled through
\fBsmtpctl\fP(8).
.PP
The options are as follows:
.RS 5
.TP
\fB\-D\fP \fImacro\fP=\fIvalue\fP
Define
\fImacro\fP
to be set to
\fIvalue\fP
on the command line.
Overrides the definition of
\fImacro\fP
in the configuration file.
.TP
\fB\-d\fP
Do not daemonize.
If this option is specified,
\fB\%smtpd\fP
will run in the foreground and log to
.IR stderr.
.TP
\fB\-f\fP \fIfile\fP
Specify an alternative configuration file.
.TP
\fB\-n\fP
Configtest mode.
Only check the configuration file for validity.
.TP
\fB\-P\fP \fIsystem\fP
Pause a specific subsystem at startup.
Normal operation can be resumed using
\fBsmtpctl\fP(8).
This option can be used multiple times.
The accepted values are:
.PP
.RS 5
.TP
mda
Do not schedule local deliveries.
.TP
mta
Do not schedule remote transfers.
.TP
smtp
Do not listen on SMTP sockets.
.RE
.TP
\fB\-v\fP
Produce more verbose output.
.TP
\fB\-T\fP \fItrace\fP
Enables real-time tracing at startup.
Normal operation can be resumed using 
\fBsmtpctl\fP(8).
This option can be used multiple times.
The accepted values are:
.PP
.RS 5
.IP \(bu
imsg
.IP \(bu
io
.IP \(bu
smtp (incoming sessions)
.IP \(bu
filters
.IP \(bu
transfer (outgoing sessions)
.IP \(bu
bounce
.IP \(bu
scheduler
.IP \(bu
expand (aliases/virtual/forward expansion)
.IP \(bu
lookup (user/credentials lookups)
.IP \(bu
stat
.IP \(bu
rules (matched by incoming sessions)
.IP \(bu
mproc
.IP \(bu
all
.RE
.RE
.SH FILES
.ad l
.RS 5
.TP
.B /etc/mailname
Alternate server name to use.
.TP
.B /etc/smtpd.conf
Default
\fB\%smtpd\fP
configuration file.
.TP
.B /var/run/smtpd.sock
Ux -domain
socket used for communication with
\fBsmtpctl\fP(8).
.RE
.SH SEE ALSO
.ad l
\fBsmtpd.conf\fP(5),
\fBmailwrapper\fP(8),
\fBsmtpctl\fP(8)
.SH STANDARDS
.ad l
Rs
%A J. Klensin
%D October 2008
%R RFC 5321
%T Simple Mail Transfer Protocol
Re
.SH HISTORY
.ad l
The
\fB\%smtpd\fP
program first appeared in
OpenBSD 4.6.