# smtpd

## NAME



           **smtpd** — Simple Mail Transfer Protocol (SMTP) daemon
    


## SYNOPSIS



           **smtpd**[**-dFhnv**] [**-D** _macro_ =_value_] [**-f** _file_] [**-P** _system_] [**-T** _trace_]
    


## DESCRIPTION



           **smtpd** is a Simple Mail Transfer Protocol (SMTP) daemon which can
           be used as a machine's primary mail system.  **smtpd** can listen on a
           network interface and handle SMTP transactions; it can also be fed
           messages through the standard _sendmail_(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 **smtpd** can be controlled through _smtpctl_(8).
    
           The options are as follows:
    
           **-D** _macro_ =_value_
                   Define _macro_ to be set to _value_ on the command line.
                   Overrides the definition of _macro_ in the configuration
                   file.
    
           **-d** Do not daemonize.  If this option is specified, **smtpd** will
                   run in the foreground and log to _stderr_.
    
           **-F** Do not daemonize.  If this option is specified, **smtpd** will
                   run in the foreground and log to _syslogd_(8).
    
           **-f** _file_
                   Specify an alternative configuration file.
    
           **-h** Display version and usage.
    
           **-n** Configtest mode.  Only check the configuration file for
                   validity.
    
           **-P** _system_
                   Pause a specific subsystem at startup.  Normal operation
                   can be resumed using _smtpctl_(8).  This option can be used
                   multiple times.  The accepted values are:
    
                   mda      Do not schedule local deliveries.
                   mta      Do not schedule remote transfers.
                   smtp     Do not listen on SMTP sockets.
    
           **-T** _trace_
                   Enables real-time tracing at startup.  Normal operation
                   can be resumed using _smtpctl_(8).  This option can be used
                   multiple times.  The accepted values are:
    
                   **•** imsg
                   **•** io
                   **•** smtp (incoming sessions)
                   **•** filters
                   **•** transfer (outgoing sessions)
                   **•** bounce
                   **•** scheduler
                   **•** expand (aliases/virtual/forward expansion)
                   **•** lookup (user/credentials lookups)
                   **•** stat
                   **•** rules (matched by incoming sessions)
                   **•** mproc
                   **•** all
    
           **-v** Produce more verbose output.
    


## FILES



           _/etc/mail/mailname_       Alternate server name to use.
           _/etc/mail/smtpd.conf_     Default **smtpd** configuration file.
           _/var/run/smtpd.sock_      Unix-domain socket used for communication
                                    with _smtpctl_(8).
           _/var/spool/smtpd/_        Spool directories for mail during
                                    processing.
           _~/.forward_               User email forwarding information.
    


## STANDARDS



           J. Klensin, _Simple Mail Transfer Protocol_ , RFC 5321, October 2008.
    


* * *