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

Revision 25714, 1.8 KB checked in by jdreed, 12 years ago (diff)
In msmtp-config: * Man page cleanup * Remind users how to renew tickets
Line 
1.TH SENDMAIL 8 "8 August 2012" "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.  The
12message is sent authenticated, and will fail if tickets are not
13available.  Fallback to unauthenticated SMTP can be permitted by setting
14the variable \fIDEBATHENA_SENDMAIL_AUTH\fP to "fallback".  If fallback
15mode is not enabled and no valid Kerberos tickets can be found to
16authenticate the user, the script will exit with status 1.  See mstmp(1)
17for possible values 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).  You can force a Return-Path or From by setting the
34environment variable \fIDEBATHENA_SENDMAIL_FROM\fP.  The contents of the
35variable are passed verbatim.
36
37Really, this is not an MTA.  In the time it took you to read this
38section, you could have installed postfix or exim.  Just sayin'.
39
40.SH SEE ALSO
41
42msmtp(1)
43
44.SH AUTHOR
45SIPB Debathena Project (http://debathena.mit.edu)
46
Note: See TracBrowser for help on using the repository browser.