| 1 | .TH SENDMAIL 8 "8 August 2012" "debathena-msmtp-mta" "Athena Electronic Mail" |
|---|
| 2 | .SH NAME |
|---|
| 3 | sendmail \- 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 |
|---|
| 10 | sends a message to one or more recipients. Flags and addresses are |
|---|
| 11 | passed to msmtp, which is invoked with the requisite options. The |
|---|
| 12 | message is sent authenticated, and will fail if tickets are not |
|---|
| 13 | available. Fallback to unauthenticated SMTP can be permitted by setting |
|---|
| 14 | the variable \fIDEBATHENA_SENDMAIL_AUTH\fP to "fallback". If fallback |
|---|
| 15 | mode is not enabled and no valid Kerberos tickets can be found to |
|---|
| 16 | authenticate the user, the script will exit with status 1. See mstmp(1) |
|---|
| 17 | for possible values for \fIflags\fP. |
|---|
| 18 | |
|---|
| 19 | .SH BUGS |
|---|
| 20 | |
|---|
| 21 | If you don't supply a \fIFrom:\fP line in the body of your e-mail, |
|---|
| 22 | msmtp will construct one. If you have tickets, it will construct it |
|---|
| 23 | from 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 |
|---|
| 26 | your mail having a \fIFrom:\fP address of \fIhost@mit.edu\fP. Don't |
|---|
| 27 | do that. |
|---|
| 28 | |
|---|
| 29 | Note that even if you specify a \fIFrom:\fP line, the |
|---|
| 30 | \fIReturn-Path\fP will be set to the msmtp-constructed address, and |
|---|
| 31 | thus 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 |
|---|
| 33 | RFC 2076). You can force a Return-Path or From by setting the |
|---|
| 34 | environment variable \fIDEBATHENA_SENDMAIL_FROM\fP. The contents of the |
|---|
| 35 | variable are passed verbatim. |
|---|
| 36 | |
|---|
| 37 | Really, this is not an MTA. In the time it took you to read this |
|---|
| 38 | section, you could have installed postfix or exim. Just sayin'. |
|---|
| 39 | |
|---|
| 40 | .SH SEE ALSO |
|---|
| 41 | |
|---|
| 42 | msmtp(1) |
|---|
| 43 | |
|---|
| 44 | .SH AUTHOR |
|---|
| 45 | SIPB Debathena Project (http://debathena.mit.edu) |
|---|
| 46 | |
|---|
