+.TH MH-TAILOR %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
.\"
.\" %nmhwarning%
-.\" $Id$
.\"
-.TH MH-TAILOR %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
-mh-tailor, mts.conf \- mail transport customization for nmh message handler
+mh-tailor, mts.conf \- mail transport configuration for nmh message handler
.SH SYNOPSIS
.I %etcdir%/mts.conf
.SH DESCRIPTION
.PP
.BR mts :
.RS 5
-The mail transport method to use. The two acceptable options are
+The mail transport method to use. The three acceptable options are
.B smtp
-(which is the default), and
-.BR sendmail .
+(which is the default),
+.BR sendmail/smtp ,
+and
+.BR sendmail/pipe .
.PP
If you use
.BR smtp ,
entry.
.PP
If you use
-.BR sendmail ,
+.BR sendmail/smtp ,
then
.B post
will send messages by forking a
local copy of
.BR sendmail .
-Currently it will still speak SMTP with this local
-copy of
+It will still speak SMTP with this local copy of
+.BR sendmail .
+For backward compatibility,
+.B sendmail/smtp
+can be abbreviated to
.BR sendmail .
+.PP
+The third alternative,
+.BR sendmail/pipe ,
+also forks a local copy of
+.B sendmail
+but feeds the message directly to it, using
+.B sendmail
+.BR -t .
+This replaces the old, undocumented
+.B spost
+mechanism and retains some of its limitations, such as lack of
+support for the
+.B \-whom
+switch and
+\*(lqDcc:\*(rq header field.
.RE
.PP
.BR localname :
command will be given.
.PP
Although the
-/B HELO
+.B HELO
command is required by RFC\-821, many SMTP servers
do not require it. Early versions of
.I SendMail
The end-of-message delimiter for maildrops.
.RE
.PP
-.BR masquerade:
-.RS 5
-This directive controls three different types of email address masquerading.
-The three possible values, which may be specified in any combination on the
-line, separated by spaces, are \*(lqdraft_from\*(rq, \*(lqmmailid\*(rq, and
-\*(lqusername_extension\*(rq.
-.PP
-\*(lqmmailid\*(rq was the only type of masquerading in the original MH package, and
-apparently stands for \*(lqmasquerade mail identification\*(rq. This type of
-masquerading keys off of the GECOS field of the passwd file. When enabled,
-.B nmh
-will check if the user's pw_gecos field in the passwd file is of the
-form:
-.PP
-.RS 5
-Full Name <fakeusername>
-.RE
-.PP
-If it is, the internal
-.B nmh
-routines that find the username and full name
-of that user will return \*(lqfakeusername\*(rq and \*(lqFull Name\*(rq respectively. This is
-useful if you want the messages you send to always appear to come from the name
-of an MTA alias rather than your actual account name. For instance, many
-organizations set up \*(lqFirst.Last\*(rq sendmail aliases for all users. If this is
-the case, the GECOS field for each user should look like:
-.PP
-.RS 5
-First [Middle] Last <First.Last>
-.RE
-.PP
-\*(lqusername_extension\*(rq, when specified on the \*(lqmasquerade:\*(rq line, allows a second
-type of username masquerading. If the user sets the
-.B $USERNAME_EXTENSION
-environment variable, its value will be appended to the actual login name. For
-instance, if I am \*(lqdan@company.com\*(rq, and I set
-.B $USERNAME_EXTENSION
-to \*(lq\-www\*(rq, my mail will appear to come from \*(lqdan\-www@company.com\*(rq. This is meant
-to interact with qmail's \*(lquser\-extension\*(rq feature, where mail sent to
-.IR user \- string
-will be delivered to
-.IR user .
-Likewise, those using
-versions of sendmail for which \*(lqplussed user\*(rq processing is active can set
-.B $USERNAME_EXTENSION
-to \*(lq+\fIstring\fR\*(rq. These MTA features are useful
-because they allow one to use different email addresses in different situations
-(to aid in automatic mail filtering or in determining where spammers got one's
-address) while only actually having a single account. Note that
-.B $USERNAME_EXTENSION
-is only appended to the username when \fIpost\fR is
-generating \*(lq[Resent\-]From:\*(rq lines and the SMTP envelope
-\*(lqFrom:\*(rq.
-.BR inc ,
-for instance, will not try to read from a maildrop file called \*(lqdan\-www\*(rq (to
-recall the earlier example).
-.PP
-\*(lqdraft_from\*(rq controls the most powerful type of address masquerading. Normally,
-when a user explicitly specifies a \*(lqFrom:\*(rq header in a draft,
-.B nmh
-uses it
-rather than constructing its own. However, to discourage email forgery, the
-SMTP envelope \*(lqFrom:\*(rq and a \*(lqSender:\*(rq header are set to the user's real address.
-When \*(lqdraft_from\*(rq is turned on, though, the envelope \*(lqFrom:\*(rq will use the
-address specified in the draft, and there will be no \*(lqSender:\*(rq header. This is
-useful when a user wants to pretend to be sending mail \*(lqdirectly\*(rq from a remote
-POP3 account, or when remote mail robots incorrectly use the envelope \*(lqFrom:\*(rq in
-preference to the body \*(lqFrom:\*(rq (or refuse to take action when the two don't
-match). Note that the MTA may still reveal the user's real identity (e.g.
-.BR sendmail 's
-\*(lqX\-Authentication\-Warning:\*(rq header).
-.RE
-.PP
.BR maildelivery :
%libdir%/maildelivery
.RS 5
.I maildelivery
file.
See
-.BR slocal (1)
+.IR slocal (1)
for the details.
.RE
.PP
This is useful for handling admin, dummy, and guest logins.
.RE
.SS "SMTP support"
-These options are only available if you set
+This option is only available if you set
.B mts
to
.BR smtp .
.PP
-.BR hostable :
-%etcdir%/hosts
-.RS 5
-The exceptions file for /etc/hosts used by
-.B post
-to try to find
-official names. The format of this file is quite simple:
-.PP
-.IP 1. 4
-Comments are surrounded by sharp (`#') and newline.
-.IP 2. 4
-Words are surrounded by white space.
-.IP 3. 4
-The first word on the line is the official name of a host.
-.IP 4. 4
-All words following the official names are aliases for that host.
-.RE
-.PP
.BR servers :
-localhost \\01localnet
+localhost
.RS 5
A lists of hosts and networks which to look for SMTP servers when
-posting local mail. It turns out this is a major win for hosts which
-don't run an message transport system. The value of
+posting non\-local mail. It turns out this is a major win for hosts
+which don't run an message transport system. The value of
.B servers
-should be one or more items. Each item is the name of either a host
-or a net (in the latter case, precede the name of the net by a \\01).
-This list is searched when looking for a smtp server to post mail.
-If a host is present, the SMTP port on that host is tried. If a net
-is present, the SMTP port on each host in that net is tried. Note that
-if you are running with the BIND code, then any networks specified are
-ignored (sorry, the interface went away under BIND).
+should be one or more items. Each item is the name of a host which
+is (hopefully) running a SMTP server.
.SS "SendMail"
This option is only available if you set
.B mts
\" .RS 5
\" The local BBoards domain (a UCI hack).
\" .RE
-
\" .SS "BBoards & The POP"
\" These options are only available if you compiled \fInmh\fP with
\" \*(lqbboards:\ pop\*(rq and \*(lqpop:\ on\*(rq.
-
\" .PP
\" .BR popbbhost :
\" .RS 5
\" present, then no check is made. This variable should be set on the POP
\" BBoards service host.
\" .RE
-
-\" .SS "BBoards & The NNTP"
-\" This option is only available if you compiled \fInmh\fP with
-\" \*(lqbboards:\ nntp\*(rq and \*(lqpop:\ on\*(rq.
-\" .PP
-\" .BR nntphost :
-\" .RS 5
-\" The host which provides the NNTP service. This variable should be set
-\" on the NNTP BBoards client host.
-\" .RE
.SS "File Locking"
A few words on locking:
.B nmh
a file should be created whose existence means \*(lqlocked\*(rq and
whose non-existence means \*(lqunlocked\*(rq. The name of this file is
constructed by appending \*(lq.lock\*(rq to the name of the file being
-locked. If
-.B LOCKDIR
-is not specified, lock files will be created
+locked. If \*(lq--enable-lockdir=directory\*(rq
+is not specified at build time, lock files will be created
in the directory where the file being locked resides. Otherwise, lock
files will be created in the directory specified by
-.BR LOCKDIR .
+\*(lq--enable-lockdir\*(rq.
.PP
Prior to installing
.BR nmh ,
you should see how locking is done at
your site, and set the appropriate values.
-
.SH FILES
.fc ^ ~
.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
+.ta \w'%etcdir%/ExtraBigFileName 'u
^%etcdir%/mts.conf~^nmh mts configuration file
.fi
-
.SH "PROFILE COMPONENTS"
None
-
.SH "SEE ALSO"
-mh\-mts(8), post(8)
-
+.IR mh\-mts (8),
+.IR post (8)
.SH DEFAULTS
-As listed above
+As listed above. The path of the mail transport configuration
+file can be changed with the
+.B MHMTSCONF
+environment variable and augmented with the
+.B MHMTSUSERCONF
+environment variable, see mh\-profile(5).
+.SH BUGS
+Failure to open any mail transport configuration file is silently
+ignored. Therefore, it's best to avoid dynamic creation of such
+a file with the intent of use via the
+.B MHMTSCONF
+or
+.B MHMTSUSERCONF
+environment variables. If such use is necessary, the ability
+to successfully open the file should first be verified.