Computer Science
MH-TAILOR(5) MH-TAILOR(5)
NAME
mh-tailor, mts.conf - mail transport customization for nmh
message handler
SYNOPSIS
/etc/nmh/mts.conf
DESCRIPTION
The file /etc/nmh/mts.conf defines run-time options for
those nmh programs which interact (in some form) with the
message transport system. At present, these (user) pro-
grams are: ap, conflict, inc, msgchk, msh, post, rcvdist,
and rcvpack.
Each option should be given on a single line. Blank lines
and lines which begin with `#' are ignored. The options
available along with default values and a description of
their meanings are listed below:
localname:
The hostname nmh considers local. It should typi-
cally be a fully qualified hostname. If this is not
set, depending on the version of UNIX you're running,
nmh will query the system for this value (e.g.,
uname, gethostname, etc.), and attempt to fully qual-
ify this value.
If you are using POP to retrieve new messages, you
may want to set this value to the name of the POP
server, so that outgoing message appear to have orig-
inated on the POP server.
localdomain:
If this is set, a `.' followed by this string will be
appended to your hostname.
This should only be needed, if for some reason nmh is
not able to fully qualify the hostname returned by
the system (e.g., uname, gethostname, etc.).
clientname:
This option specifies the host name that nmh will
give in the SMTP HELO (and EHLO) command, when post-
ing mail. If not set, the default is to use the host
name that nmh considers local (see "localname"
above). If this option is set, but empty, no HELO
command will be given.
Although the HELO command is required by RFC-821,
many SMTP servers do not require it. Early versions
of SendMail will fail if the hostname given in the
HELO command is the local host. Later versions of
SendMail will complain if you omit the HELO command.
If you run SendMail, find out what your system
expects and set this field if needed.
systemname:
This option is only used for UUCP mail. It specifies
the name of the local host in the UUCP "domain". If
not set, depending on the version of UNIX you're run-
ning, nmh will query the system for this value. This
has no equivalent in the nmh configuration file.
mmdfldir: /var/spool/mail
The directory where maildrops are kept. If this
option is set, but empty, the user's home directory
is used. This overrides the default value chosen at
the time of compilation.
mmdflfil:
The name of the maildrop file in the directory where
maildrops are kept. If this is empty, the user's
login name is used. This overrides the default value
(which is empty).
mmdelim1: \001\001\001\001\n
The beginning-of-message delimiter for maildrops.
mmdelim2: \001\001\001\001\n
The end-of-message delimiter for maildrops.
mmailid: 0
If this is non-zero, then activate support for
MMailids (username masquerading). When this is acti-
vated, nmh will check if the pw_gecos field in the
password file has the form
Full Name <fakeusername>
If the pw_gecos field has this form, then the inter-
nal nmh routines that find the username and full name
of a user will return "fakeusername" and "Full Name"
respectively. If the pw_gecos field for a user is
not of this form, there will be no username mas-
querading for that user.
maildelivery: /usr/lib/nmh/maildelivery
The name of the system-wide default .maildelivery
file. See slocal (1) for the details.
everyone: 200
The highest user-id which should NOT receive mail
addressed to "everyone".
noshell:
If set, then each user-id greater than "everyone"
that has a login shell equivalent to the given value
(e.g., "/bin/csh") indicates that mail for "everyone"
should not be sent to them. This is useful for han-
dling admin, dummy, and guest logins.
These options are only available if you compiled nmh with
the "/smtp" support.
hostable: /etc/nmh/hosts
The exceptions file for /etc/hosts used by post to
try to find official names. The format of this file
is quite simple:
1. Comments are surrounded by sharp (`#') and
newline.
2. Words are surrounded by white space.
3. The first word on the line is the official
name of a host.
4. All words following the official names are
aliases for that host.
servers: localhost \01localnet
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 "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).
This option is only available if you compiled nmh to use
SendMail as your delivery agent.
sendmail: /usr/lib/sendmail
The pathname to the sendmail program.
This option is only available if you have compiled nmh
with POP support enabled (i.e., "--enable-nmh-pop").
pophost:
The name of the default POP service host. If this is
not set, then nmh looks in the standard maildrop
areas for waiting mail, otherwise the named POP ser-
vice host is consulted.
This option is only available if you compiled nmh with
"bbdelivery: on".
bbdomain:
The local BBoards domain (a UCI hack).
These options are only available if you compiled nmh with
"bboards: pop" and "pop: on".
popbbhost:
The POP service host which also acts as a BBoard
server. This variable should be set on the POP
BBoards client host.
popbbuser:
The guest account on the POP/BB service host. This
should be a different login ID than either the POP
user or the BBoards user. (The user-id "ftp" is
highly recommended.) This variable should be set on
both the POP BBoards client and service hosts.
popbblist: /etc/nmh/hosts.popbb
A file containing of lists of hosts that are allowed
to use the POP facility to access BBoards using the
guest account. If this file is not present, then no
check is made. This variable should be set on the
POP BBoards service host.
This option is only available if you compiled nmh with
"bboards: nntp" and "pop: on".
nntphost:
The host which provides the NNTP service. This vari-
able should be set on the NNTP BBoards client host.
A few words on locking: nmh has several methods for creat-
ing locks on files. When configuring nmh, you will need
to decide on the locking style and locking directory (if
any). The first controls the method of locking, the sec-
ond says where lock files should be created.
To configure nmh for kernel locking, define FLOCK_LOCKING
if you want to use the flock system call; define
LOCKF_LOCKING if you want to use the lockf system call; or
define FCNTL_LOCKING if you want to use the fcntl system
call for kernel-level locking.
Instead of kernel locking, you can configure nmh to use
dot locking by defining DOT_LOCKING. Dot locking speci-
fies that a file should be created whose existence means
"locked" and whose non-existence means "unlocked". The
name of this file is constructed by appending ".lock" to
the name of the file being locked. If LOCKDIR is not
specified, 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 LOCK-
DIR.
Prior to installing nmh, you should see how locking is
done at your site, and set the appropriate values.
^/etc/nmh/mts.conf~^nmh mts configuration file None
mh-mts(8) As listed above None
[nmh-0.27] MH.6.8 1
Back to the index