MH-TAILOR(5)

NAME
mh-tailor, mts.conf - mail transport customization for nmh message handler

SYNOPSIS
/usr/pkg/etc/nmh/mts.conf

DESCRIPTION
The file /usr/pkg/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) programs 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 typically 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 qualify 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 originated 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 posting 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 running, nmh will query the system for this value. This has no equivalent in the nmh configuration file.
mmdfldir: /var/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 activated, 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 internal 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 masquerading for that user. This facility is useful if you are using POP, and wish for messages that are sent by users to appear to originate from the username of their POP account, rather than their username on the local machine.
maildelivery: /usr/pkg/libexec/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 handling admin, dummy, and guest logins.
These options are only available if you compiled nmh with the “/smtp” support.
hostable: /usr/pkg/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/sbin/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 service 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: /usr/pkg/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 variable should be set on the NNTP BBoards client host.
A few words on locking: nmh has several methods for creating 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 second 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 specifies 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 LOCKDIR. Prior to installing nmh, you should see how locking is done at your site, and set the appropriate values. ^/usr/pkg/etc/nmh/mts.conf~^nmh mts configuration file None mh-mts(8) As listed above None