"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/msmtpd.1" between
msmtp-1.8.19.tar.xz and msmtp-1.8.20.tar.xz

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

msmtpd.1  (msmtp-1.8.19.tar.xz):msmtpd.1  (msmtp-1.8.20.tar.xz)
skipping to change at line 63 skipping to change at line 63
EXAMPLES EXAMPLES
Using msmtpd as a system service Using msmtpd as a system service
Only use a local interface to listen on. Run msmtpd with correct user rights and permissions (e.g. use Only use a local interface to listen on. Run msmtpd with correct user rights and permissions (e.g. use
CAP_NET_BIND_SERVICE to bind to port 25 instead of running as root, or us e systemd with inetd service CAP_NET_BIND_SERVICE to bind to port 25 instead of running as root, or us e systemd with inetd service
capabilities). Be aware that the pipe command will be run as the same u ser that msmtpd runs as. Enable capabilities). Be aware that the pipe command will be run as the same u ser that msmtpd runs as. Enable
logging to syslog with --log=syslog. logging to syslog with --log=syslog.
Example for managing msmtpd with start-stop-daemon: Example for managing msmtpd with start-stop-daemon:
# start msmtpd # start msmtpd
start-stop-daemon --start --pidfile /var/run/msmtpd.pid --make-pidfile -- chuid msmtpd --background --exec start-stop-daemon --start --pidfile /var/run/msmtpd.pid --make-pidfile -- chuid msmtpd --background --exec
/usr/local/bin/msmtpd -- --command '/usr/local/bin/msmtp -f %F' /usr/local/bin/msmtpd -- --command '/usr/local/bin/msmtp -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
Using msmtpd to handle outgoing mail for an SMTP-based mail client Using msmtpd to handle outgoing mail for an SMTP-based mail client
Some mail clients cannot send outgoing mail with a program like msmtp and instead insist on using an SMTP 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 SMTP server and hand your out going mail over to msmtp. server. You can configure msmtpd to be that SMTP server and hand your out going mail over to msmtp.
(Similarly, some mail clients cannot get incoming mail from a local mailb ox and insist on using a POP3 or (Similarly, some mail clients cannot get incoming mail from a local mailb ox and insist on using a POP3 or
IMAP server. You can configure mpopd to be that POP3 server and serve inc oming mail from a local mailbox. IMAP server. You can configure mpopd to be that POP3 server and serve inc oming mail from a local mailbox.
See the relevant section in the mpop manual.) See the relevant section in the mpop manual.)
For this purpose, msmtpd should listen on an unprivileged port, e.g. 2500 . Furthermore, msmtpd should For this purpose, msmtpd should listen on an unprivileged port, e.g. 2500 . Furthermore, msmtpd should
require authentication because otherwise anyone connecting to it can se nd mail using your account, even require authentication because otherwise anyone connecting to it can se nd mail using your account, even
if it's just other users or processes on your local machine. if it's just other users or processes on your local machine.
Let's use the user name msmtpd-user for this purpose. You have two option s to manage the password: Let's use the user name msmtpd-user for this purpose. You have two option s to manage the password:
Store the password in your key ring, e.g. with secret-tool store --label=msmtpd host localhost Store the password in your key ring, e.g. with secret-tool store --label=msmtpd host localhost
service smtp user msmtpd-user. In this case, use the msmtpd optio n --auth=msmtpd-user. service smtp user msmtpd-user. In this case, use the msmtpd optio n --auth=msmtpd-user.
Store the password in an encrypted file and use the password eval mechanism. Example for gpg: Store the password in an encrypted file and use the password eval mechanism. Example for gpg:
msmtpd ... --auth=msmtpd-user,'gpg -q -d ~/.msmtpd-password.gpg' msmtpd ... --auth=msmtpd-user,'gpg -q -d ~/.msmtpd-password.gpg'
The complete command then is (using the keyring): msmtpd --port= 2500 --auth=msmtpd-user --com- The complete command then is (using the keyring): msmtpd --port= 2500 --auth=msmtpd-user --com-
mand='/path/to/your/msmtp -f %F' mand='/path/to/your/msmtp -f %F --'
The mail client software must then be configured to use localhost at port 2500 for outgoing mail via The mail client software must then be configured to use localhost at port 2500 for outgoing mail via
SMTP, and to use authentication with user msmtpd-user and the password yo u chose. The mail client will SMTP, and to use authentication with user msmtpd-user and the password yo u chose. The mail client will
probably complain that the SMTP server does not support TLS, but in th is special case that is ok since probably complain that the SMTP server does not support TLS, but in th is special case that is ok since
all communication between your mail client and msmtpd will stay on the lo cal machine. all communication between your mail client and msmtpd will stay on the lo cal machine.
This setup also works with multiple mail accounts. Msmtp will pick the co rrect one based on the envelope- This setup also works with multiple mail accounts. Msmtp will pick the co rrect one based on the envelope-
from address given to it via -f %F. You do not need multiple instances of msmtpd for this purpose, and from address given to it via -f %F. You do not need multiple instances of msmtpd for this purpose, and
therefore you need only one SMTP server in your mail client configuration . therefore you need only one SMTP server in your mail client configuration .
SEE ALSO SEE ALSO
msmtp(1) msmtp(1)
 End of changes. 2 change blocks. 
2 lines changed or deleted 2 lines changed or added

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