sSMTP

Cette page est la uniquement pour aide-mémoire…

ssmtp, sendmail - send a message using smtp

ssmtp [ flags ] [ address … ] /usr/lib/sendmail [ flags ] [ address … ]

ssmtp is a send-only sendmail emulator for machines which normally pick their mail up from a centralized mailhub (via pop, imap, nfs mounts or other means). It provides the functionality required for humans and programs to send mail via the standard or /usr/bin/mail user agents.

It accepts a mail stream on standard input with recipients specified on the command line and synchronously forwards the message to the mail transfer agent of a mailhub for the mailhub MTA to process. Failed messages are placed in dead.letter in the sender’s home directory.

Config files allow one to specify the address to receive mail from root, daemon, etc.; a default mailhub; a default domain to be used in From: lines; and per-user From: addresses and mailhub names.

It does not attempt to provide all the functionality of sendmail: it is intended for use where other programs are the primary means of at last mail delivery. It is usefull with pop/imap, or to simulate the Sun shared mail spool option for non-Sun machines, for machines whose sendmails are too difficult (or various) to configure, for machines with known disfeatures in their sendmails or for ones where there are ‘mysterious problems’.

It does not do aliasing, which must be done either in the user agent or on the mailhub. Nor does it honor .forwards, which have to be done on the recieving host. It especially does not deliver to pipelines.

Most sendmail options are irrelevent to sSMTP. Those marked ‘ignored’ or ‘default’ have no effect on mail transfer. Those marked ‘unsupported’ are fatal errors. Those marked `simulated’ are not errors, but the result is for the program to exit with an informative message. A sort of fatal non-error.

-4

  Forces ssmtp to use IPv4 addresses only. 

-6

  Forces ssmtp to use IPv6 addresses only. 

-auusername

  Specifies username for SMTP authentication. 

-appassword

  Specifies password for SMTP authentication. 

-ammechanism

  Specifies mechanism for SMTP authentication. (Only LOGIN and CRAM-MD5) 

-ba

  (unsupported) ARPANET mode. All input lines must end with a LINEFEED, and all messages will be generated with a CR-LF at the end. Also, the ``From:'' and ``Sender:'' fields are examined for the name of the sender. 

-bd

  (unsupported) Run as a daemon. 

-bi

  (ignored) Initialise the alias database. 

-bm

  (default) Deliver mail in the usual way. 

-bp

  (simulated) Print a summary of the mail queue. 

-bs

  (unsupported) Read SMTP commands from stdin. 

-bt

  (unsupported) Run in address test mode. 

-bv

  (unsupported) Verify names only. 

-bz

  (unsupported) Create the configuration freeze file. 

-Cfile

  Use alternate configuration file. 

-dX

  Set debugging value to X. 

-E

  (ignored) Don't trust userid of sender. 

-Ffullname

  Set the full name of the sender. 

-fname

  Sets the name of the ``from'' person. This option is valid only if no From: line is specified within the header of the email. 

-h

  (ignored) Set the hop count to N. 

-m

  (ignored) Ignore originator in alias. 

-Mid

  (ignored) Attempt to deliver the queued message with message-id id. 

-N dsn

  (ignored) Set delivery status notification conditions to dsn. 

-n

  (default) Do not do aliasing. 

-oAfile

  (ignored) Use alternate alias file. 

-oc

  (ignored) Delay ``expensive'' connections. 

-od

  (ignored) Set the delivery mode to interactive/synchronous, background or queue (Always interactive). 

-oD

  (ignored) Run newaliases if required. 

-oe

  (ignored) Set error processing to mail, write, print or quit. (Always print). 

-oFmode

  (ignored) The mode to use when creating temporary files. 

-of

  (ignored) Save UNIX-system-style ``From'' lines at the front of messages. 

-ogN

  (ignored) Set group ID to use when calling mailers. 

-oHfile

  (ignored) Set SMTP help file. 

-oi

  (default) Do not take dots on a line by themselves as a message terminator. 

-oLn

  (ignored) The log level. 

-om

  (default) Send to ``me'' (the sender) also if in an alias. 

-oo

  (unsupported) If set, this message may have old style headers. 

-oQqueuedir

  (ignored) Select the directory in which to queue messages. 

-ortimeout

  (ignored) The timeout on reads. 

-oSfile

  (ignored) Save statistics in the named file. 

-os

  (ignored) Always instantiate the queue. 

-oTtime

  (ignored) Set timeout on messages. 

-otstz,dtz

  (ignored) Set the name of the time zone. 

-ouN

  (ignored) Set the default user id for mailers. 

-q[time]

  (simulated) Process the queue. 

-rname

  Same as -f. 

-Rstring

  (ignored) Process queue for recipient. 

-R return

  (ignored) Set the amount of the message to be returned if the message bounces. 

-t

  Read message, searching for recipients. ``To:'', `Cc:'', and ``Bcc:'' lines will be scanned for people to send to. Any addresses in the argument list will be suppressed (not supported). 

-v

  Go into verbose mode. 

-V

  Say version and quit.

A reverse alias gives the From: address placed on a user’s outgoing messages and (optionally) the mailhub these messages will be sent through. Example:

  root:jdoe@isp.com:mail.isp.com

Messages root sends will be identified as from jdoe@isp.com and sent through mail.isp.com.

/etc/ssmtp/ssmtp.conf - configuration file /etc/ssmtp/revaliases - reverse aliases file

RFC821, RFC822, ssmtp.conf(5).

Matt Ryan (mryan@debian.org) Hugo Haas (hugo@debian.org) Christoph Lameter (clameter@debian.org) Dave Collier-Brown (davecb@hobbes.ss.org)

sSMTP does not support exception lists to the -t option (never seen it used).

sSMTP will fail if the mailhub is unreachable.

ssmtp.conf - ssmtp configuration file

ssmtp reads configuration data from /etc/ssmtp/ssmtp.conf The file contains keyword-argument pairs, one per line. Lines starting with `#' and empty lines are interpreted as comments.

The possible keywords and their meanings are as follows (both are case-insensitive):

Root

  The user that gets all mail for userids less than 1000. If blank, address rewriting is disabled. 

Mailhub

  The host to send mail to, in the form host | IP_addr [: port ] The default port is 25. 

RewriteDomain

  The domain from which mail seems to come. for user authentication. 

Hostname

  The full qualified name of the host. If not specified, the host is queried for its hostname. 

FromLineOverride

  Specifies whether the From header of an email, if any, may override the default domain. The default is ``no'' 

UseTLS

  Specifies whether ssmtp uses TLS to talk to the SMTP server. The default is ``no'' 

UseSTARTTLS

  Specifies whether ssmtp does a EHLO/STARTTLS before starting SSL negotiation. See RFC 2487. 

TLSCert

  The file name of an RSA certificate to use for TLS, if required. 

AuthUser

  The user name to use for SMTP AUTH. The default is blank, in which case SMTP AUTH is not used. sent without 

AuthPass

  The password to use for SMTP AUTH. 

AuthMethod

  The authorization method to use. If unset, plain text is used. May also be set to ``cram-md5''

/etc/ssmtp/ssmtp.conf

  Contains configuration data for ssmtp

ssmtp(8)

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.