source: trunk/debathena/config/msmtp-config/debian/sendmail.8 @ 25088

Revision 25088, 1.5 KB checked in by jdreed, 13 years ago (diff)
Update man page with more caveats
Line 
1.TH SENDMAIL 8 "11 March 2010" "debathena-msmtp-mta" "Athena Electronic Mail"
2.SH NAME
3sendmail \- A script which invokes msmtp in order to send mail
4.SH SYNOPSIS
5.nf
6.B sendmail [\fIflags\fP] [\fIaddress ...\fP]
7.sp
8.SH DESCRIPTION
9.BR sendmail
10sends a message to one or more recipients.  Flags and addresses are
11passed to msmtp, which is invoked with the requisite options.  If
12possible, the message is sent authenticated, but will fall back to
13unauthenticated smtp.  Authentication can be forced by setting the
14variable \fIDEBATHENA_SENDMAIL_AUTH\fP to "yes".  If authentication is
15forced, but no valid Kerberos tickets can be found to authenticate the
16user, the script will exit with status 1.  See mstmp(1) for possible
17values for \fIflags\fP.
18
19.SH BUGS
20
21If you don't supply a \fIFrom:\fP line in the body of your e-mail,
22msmtp will construct one.  If you have tickets, it will construct it
23from the principal, with any instances removed, and append
24\fI@MIT.EDU\fP.  If you currently have tickets from a keytab
25(e.g. host/some-hostname.mit.edu@ATHENA.MIT.EDU), that will result in
26your mail having a \fIFrom:\fP address of \fIhost@mit.edu\fP.  Don't
27do that.
28
29Note that even if you specify a \fIFrom:\fP line, the
30\fIReturn-Path\fP will be set to the msmtp-constructed address, and
31thus you might miss bounces or other errors.  While you can specify
32\fIErrors-To:\fP, and most MTAs will honor it, it's discouraged (per
33RFC 2076).  So really, don't send mail with host tickets.
34
35.SH SEE ALSO
36
37msmtp(1)
38
39.SH AUTHOR
40SIPB Debathena Project (http://debathena.mit.edu)
41
Note: See TracBrowser for help on using the repository browser.