.\"/* Copyright 2004 Reuben Thomas
.\" * All rights reserved
.\" *
.\" This man page is distributed under the GNU General Public License
.\" version 2, or at your option, any later version. There is no warranty.
.\"
.Dd October 7, 2004
.Dt SSMTP.CONF 5
.Os
.Sh NAME
.Nm ssmtp.conf
.Nd ssmtp configuration file
.Sh DESCRIPTION
.Nm ssmtp
reads configuration data from
.Pa /etc/ssmtp/ssmtp.conf
The file contains keyword-argument pairs, one per line.
Lines starting with
.Ql #
and empty lines are interpreted as comments.
.Pp
The possible keywords and their meanings are as follows (both are case-insensitive):
.Bl -tag -width Ds
.It Cm Root
The user that gets all mail for userids less than 1000. If blank, address rewriting is disabled.
.Pp
.It Cm Mailhub
The host to send mail to, in the form
.Ar host port | Ar IP_addr port Oo : Ar port Oc .
The default port is 25.
.Pp
.It Cm RewriteDomain
The domain from which mail seems to come.
for user authentication.
.Pp
.It Cm Hostname
The full qualified name of the host.
If not specified, the host is queried for its hostname.
.Pp
.It Cm FromLineOverride
Specifies whether the From header of an email, if any, may override the default domain.
The default is
.Dq no .
.Pp
.It Cm UseTLS
Specifies whether ssmtp uses TLS to talk to the SMTP server.
The default is
.Dq no .
.Pp
.It Cm UseSTARTTLS
Specifies whether ssmtp does a EHLO/STARTTLS before starting SSL negotiation.
See RFC 2487.
.Pp
.It Cm TLSCert
The file name of an RSA certificate to use for TLS, if required.
.Pp
.It Cm AuthUser
The user name to use for SMTP AUTH.
The default is blank, in which case SMTP AUTH is not used.
sent without
.Pp
.It Cm AuthPass
The password to use for SMTP AUTH.
.Pp
.It Cm AuthMethod
The authorization method to use.
If unset, plain text is used.
May also be set to
.Dq cram-md5 .
.Sh FILES
.Bl -tag -width Ds
.It Pa /etc/ssmtp/ssmtp.conf
Contains configuration data for
.Nm ssmtp .
.El
.Sh SEE ALSO
.Xr ssmtp 8
.Sh AUTHORS
Matt Ryan (mryan@debian.org), Hugo Haas (hugo@debian.org), Christoph Lameter (clameter@debian.org)
and Dave Collier-Brown (davecb@hobbes.ss.org).
Reuben Thomas (rrt@sc3d.org) wrote the man page.