"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/msmtp.texi" between
msmtp-1.8.17.tar.xz and msmtp-1.8.18.tar.xz

About: msmtp is an SMTP client with a sendmail compatible interface. It can be used with Mutt and other mail user agents.

msmtp.texi  (msmtp-1.8.17.tar.xz):msmtp.texi  (msmtp-1.8.18.tar.xz)
skipping to change at line 1404 skipping to change at line 1404
# Send everything else to admin # Send everything else to admin
default: admin@@domain.example default: admin@@domain.example
@end example @end example
@node Minimal SMTP server (msmtpd) @node Minimal SMTP server (msmtpd)
@chapter Minimal SMTP server (msmtpd) @chapter Minimal SMTP server (msmtpd)
Msmtpd is a minimal SMTP server that pipes mails to msmtp (or some other Msmtpd is a minimal SMTP server that pipes mails to msmtp (or some other
program) for delivery. It can be used with system services that expect an SMTP program) for delivery. It can be used with system services that expect an SMTP
server on the local host (see @ref{Example: using msmtpd as a system service}), or server on the local host (see @ref{Example using msmtpd as a system service}), o r
it can be used by end users as a way to handle outgoing mail via msmtp with it can be used by end users as a way to handle outgoing mail via msmtp with
mail clients that insist on using SMTP (see @ref{Example: using msmtpd to mail clients that insist on using SMTP (see @ref{Example using msmtpd to
handle outgoing mail for an SMTP-based mail client}). handle outgoing mail for an SMTP-based mail client}).
Msmtpd listens on 127.0.0.1 port 25 by default, but can also run without its Msmtpd listens on 127.0.0.1 port 25 by default, but can also run without its
own network sockets in inetd mode, where it handles a single SMTP session on own network sockets in inetd mode, where it handles a single SMTP session on
standard input / output. standard input / output.
In the string that defines the command that msmtpd pipes each mail to, the In the string that defines the command that msmtpd pipes each mail to, the
first occurrence of @samp{%F} will be replaced with the envelope from address. first occurrence of @samp{%F} will be replaced with the envelope from address.
Furthermore, all recipients of the mail will be appended as arguments. The Furthermore, all recipients of the mail will be appended as arguments. The
command must not write to standard output, as that would mess up the SMTP command must not write to standard output, as that would mess up the SMTP
skipping to change at line 1454 skipping to change at line 1454
Set logging: none (default), syslog, or logging to the given file. Set logging: none (default), syslog, or logging to the given file.
@item --command=@var{cmd} @item --command=@var{cmd}
Pipe mails to @var{cmd} instead of msmtp Pipe mails to @var{cmd} instead of msmtp
@item --auth=@var{user}[,@var{passwordeval}] @item --auth=@var{user}[,@var{passwordeval}]
Require authentication with this user name. The password will be Require authentication with this user name. The password will be
retrieved from the given @var{passwordeval} command (this works retrieved from the given @var{passwordeval} command (this works
just like @ref{passwordeval} in msmtp) or, if none is given, just like @ref{passwordeval} in msmtp) or, if none is given,
from the key ring or, if that fails, from a prompt. from the key ring or, if that fails, from a prompt.
@end table @end table
@node Example: using msmtpd as a system service @node Example using msmtpd as a system service
@section Example: using msmtpd as a system service @section Example: using msmtpd as a system service
Only use a local interface to listen on. Run msmtpd with correct user rights Only use a local interface to listen on. Run msmtpd with correct user rights
and permissions (e.g. use @samp{CAP_NET_BIND_SERVICE} to bind to port 25 and permissions (e.g. use @samp{CAP_NET_BIND_SERVICE} to bind to port 25
instead of running as root, or use systemd with inetd service capabilities). Be instead of running as root, or use systemd with inetd service capabilities). Be
aware that the pipe command will be run as the same user that msmtpd runs as. aware that the pipe command will be run as the same user that msmtpd runs as.
Enable logging to syslog with @samp{--log=syslog}. Enable logging to syslog with @samp{--log=syslog}.
Example for managing msmtpd with @samp{start-stop-daemon}: Example for managing msmtpd with @samp{start-stop-daemon}:
@example @example
# start msmtpd # start msmtpd
start-stop-daemon --start --pidfile /var/run/msmtpd.pid --make-pidfile --chuid m smtpd --background --exec /usr/local/bin/msmtpd -- --command '/usr/local/bin/msm tp -f %F' start-stop-daemon --start --pidfile /var/run/msmtpd.pid --make-pidfile --chuid m smtpd --background --exec /usr/local/bin/msmtpd -- --command '/usr/local/bin/msm tp -f %F'
# stop msmtpd # stop msmtpd
start-stop-daemon --stop --pidfile /var/run/msmtpd.pid --remove-pidfile --quiet --signal TERM start-stop-daemon --stop --pidfile /var/run/msmtpd.pid --remove-pidfile --quiet --signal TERM
@end example @end example
@node Example: using msmtpd to handle outgoing mail for an SMTP-based mail clien t @node Example using msmtpd to handle outgoing mail for an SMTP-based mail client
@section Example: using msmtpd to handle outgoing mail for an SMTP-based mail cl ient @section Example: using msmtpd to handle outgoing mail for an SMTP-based mail cl ient
Some mail clients cannot send outgoing mail with a program like msmtp and Some mail clients cannot send outgoing mail with a program like msmtp and
instead insist on using an SMTP server. You can configure msmtpd to be that instead insist on using an SMTP server. You can configure msmtpd to be that
SMTP server and hand your outgoing mail over to msmtp. SMTP server and hand your outgoing mail over to msmtp.
(Similarly, some mail clients cannot get incoming mail from a local mailbox and (Similarly, some mail clients cannot get incoming mail from a local mailbox and
insist on using a POP3 or IMAP server. You can configure mpopd to be that POP3 insist on using a POP3 or IMAP server. You can configure mpopd to be that POP3
server and serve incoming mail from a local mailbox. See the server and serve incoming mail from a local mailbox. See the
@url{https://marlam.de/mpop/documentation/mpop.html#Example_003a-using-mpopd-to- handle-incoming-mail-for-a-POP3_002dbased-mail-client, corresponding section in the mpop manual}.) @url{https://marlam.de/mpop/mpop.html#Example_003a-using-mpopd-to-handle-incomin g-mail-for-a-POP3_002dbased-mail-client, corresponding section in the mpop manua l}.)
For this purpose, msmtpd should listen on an unprivileged port, e.g. 2500. For this purpose, msmtpd should listen on an unprivileged port, e.g. 2500.
Furthermore, msmtpd should require authentication because otherwise anyone Furthermore, msmtpd should require authentication because otherwise anyone
connecting to it can send mail using your account, even if it's just other connecting to it can send mail using your account, even if it's just other
users or processes on your local machine. users or processes on your local machine.
Let's use the user name @var{msmtpd-user} for this purpose. You have two Let's use the user name @var{msmtpd-user} for this purpose. You have two
options to manage the password: options to manage the password:
@enumerate @enumerate
@item Store the password in your key ring, e.g. with @item Store the password in your key ring, e.g. with
 End of changes. 5 change blocks. 
5 lines changed or deleted 5 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)