1 .\" This file is automatically generated. Do not edit!
2 .\" @(#)$Id: mh-tailor.rf,v 2.21 1994/03/23 23:32:50 jromine Exp $
5 mh-tailor, mtstailor \- system customization for MH message handler
8 \fI/opt/mh-6.8.5/lib/mtstailor\fP
10 The file /opt/mh-6.8.5/lib/mtstailor defines run-time options for those \fIMH\fR
11 programs which interact (in some form) with the message transport system.
12 At present, these (user) programs are:
13 \fIap\fR, \fIconflict\fR, \fIinc\fR, \fImsgchk\fR,
14 \fImsh\fR, \fIpost\fR, \fIrcvdist\fR, and \fIrcvpack\fR.
16 Each option should be given on a single line. Blank lines
17 and lines which begin with `#' are ignored.
18 The options available along with default values and a description of their
19 meanings are listed below:
25 The host name \fIMH\fR considers local.
26 If not set, depending on the version of UNIX you're running,
27 \fIMH\fR will query the system for this value
28 (e.g., <whoami.h>, gethostname, etc.).
29 This has no equivalent in the \fIMH\fR configuration file.
30 POP client hosts should set this value to the name of the POP service host.
35 If this is set, a `.' followed by this string will be
36 appended to your host name.
37 This might be useful for sites
38 where the host name returned by the system
39 (e.g., <whoami.h>, gethostname, etc.),
40 is not a \*(lqfully qualified domain name\*(rq
41 (i.e., does not contain a `.').
46 The host name \fIMH\fP will give in the
47 SMTP \fBHELO\fP (and \fBEHLO\fP) command, when posting mail.
48 If not set, the host name \fIMH\fR considers local is used
49 (see \*(lqlocalname\*(rq above).
50 If empty, no \fBHELO\fP command will be given.
51 Although the \fBHELO\fP command is required by RFC 821,
52 many SMTP servers do not require it.
54 Early versions of SendMail will fail if the host name
55 given in the \fBHELO\fP command is the local host;
56 later versions of SendMail will complain if you omit the
57 \fBHELO\fP command. If you run SendMail, find out what
58 your system expects and set this field if needed.
63 The name of the local host in the \fIUUCP\fR \*(lqdomain\*(rq.
64 If not set, depending on the version of UNIX you're running,
65 \fIMH\fR will query the system for this value.
66 This has no equivalent in the \fIMH\fR configuration file.
69 mmdfldir: /var/spool/mail
71 The directory where maildrops are kept.
72 If this is empty, the user's home directory is used.
73 This overrides the \*(lqmail\*(rq field in the \fIMH\fR configuration file.
78 The name of the maildrop file in the directory where maildrops are kept.
79 If this is empty, the user's login name is used.
80 This overrides the \*(lqmail\*(rq field in the \fIMH\fR configuration file.
83 mmdelim1: \\001\\001\\001\\001\\n
85 The beginning-of-message delimiter for maildrops.
88 mmdelim2: \\001\\001\\001\\001\\n
90 The end-of-message delimiter for maildrops.
95 If non-zero, then support for MMailids in \fB/etc/passwd\fR is enabled.
96 Basically, the pw_gecos field in the password file is of the form
101 The \fIMH\fR internal routines that deal with user and full names will return
102 \*(lqmailid\*(rq and \*(lqMy Full Name\*(rq respectively.
107 The locking discipline to perform.
108 A value of \*(lq0\*(rq means to use kernel-level locking
110 (See below for more details.)
111 On systems compiled without kernel-level locking,
112 standard \fIBellMail\fR locking is used.
113 A value of \*(lq1\*(rq means to use \fIBellMail\fR locking always
114 (the name of the lock is based on the file name).
115 A value of \*(lq2\*(rq means to use \fIMMDF\fR locking always
116 (the name of the lock is based on device/inode pairs).
121 The name of the directory for making locks.
122 If your system isn't configured to use kernel-level locking,
123 then this directory is used when creating locks.
124 If the value is empty,
125 then the directory of the file to be locked is used.
128 maildelivery: /opt/mh-6.8.5/lib/maildelivery
130 The name of the system-wide default \fI\&.maildelivery\fR file.
131 See \fImhook\fR\0(1) for the details.
136 The highest user-id which should NOT receive mail addressed to
142 If set, then each user-id greater than \*(lqeveryone\*(rq
143 that has a login shell equivalent to the given value (e.g.,
145 indicates that mail for \*(lqeveryone\*(rq should not be sent to them.
146 This is useful for handling admin, dummy, and guest logins.
150 These options are only available if you compiled \fIMH\fP with
151 \*(lqoptions\ MF\*(rq.
155 uucpchan: name of \fIUUCP\fR channel
157 Usually \*(lqUUCP\*(rq.
158 This has no equivalent in the \fIMH\fR configuration file.
161 uucpldir: /usr/spool/mail
163 The name of the directory where \fIUUCP\fR maildrops are kept.
164 This has no equivalent in the \fIMH\fR configuration file.
169 The name of the maildrop file in the directory where \fIUUCP\fR maildrops are
171 If this is empty, the user's login name is used.
172 This has no equivalent in the \fIMH\fR configuration file.
175 umincproc: /opt/mh-6.8.5/lib/uminc
177 The path to the program that filters \fIUUCP\fR\^-style maildrops to
178 \fIMMDF\fR\^-style maildrops.
182 .Uh "Stand-Alone Delivery"
183 These options are only available if you compiled \fIMH\fP
184 to use stand-alone delivery (i.e., \*(lqmts:\ mh\*(rq).
188 mailqdir: /usr/spool/netmail
190 The directory where network mail is queued.
195 The directory where network mail queue files are built.
200 If ON, unauthorized mail is copied to the overseer.
205 The user that receives reports of unauthorized mail.
210 The user acting for the mail system.
213 fromtmp: /tmp/rml.f.XXXXXX
215 The \fImktemp\fR template for storing from lines.
218 msgtmp: /tmp/rml.m.XXXXXX
220 The \fImktemp\fR template for storing the rest of the message.
223 errtmp: /tmp/rml.e.XXXXXX
225 The \fImktemp\fR template for storing error messages from other mailers.
230 The octal mode which temporary files are set to.
233 okhosts: /opt/mh-6.8.5/lib/Rmail.OKHosts
235 A file containing a list of hosts that can send ARPAnet mail.
238 okdests: /opt/mh-6.8.5/lib/RMail.OKDests
240 A file containing a list of hosts that can always receive mail.
244 .Uh "The `/smtp' MTS Suffix"
245 These options are only available if you compiled \fIMH\fP with
246 the \*(lq/smtp\*(rq suffix to your \*(lqmts:\*(rq configuration.
250 hostable: /opt/mh-6.8.5/lib/hosts
252 The exceptions file for /etc/hosts used by \fIpost\fR to try to find official
254 The format of this file is quite simple:
257 1. Comments are surrounded by sharp (`#') and newline.
259 2. Words are surrounded by white space.
261 3. The first word on the line is the official name of a host.
263 4. All words following the official names are aliases for that host.
267 servers: localhost \\01localnet
269 A lists of hosts and networks which to look for SMTP servers
270 when posting local mail.
271 It turns out this is a major win for hosts which don't run an message
273 The value of \*(lqservers\*(rq should be one or more items.
274 Each item is the name of either a host or a net
275 (in the latter case, precede the name of the net by a \\01).
276 This list is searched when looking for a smtp server to post mail.
277 If a host is present, the SMTP port on that host is tried.
279 the SMTP port on each host in that net is tried.
280 Note that if you are running with the BIND code,
281 then any networks specified are ignored
282 (sorry, the interface went away under BIND).
287 This option is only available if you compiled \fIMH\fP to
288 use \fISendMail\fP as your delivery agent (i.e., \*(lqmts:\ sendmail\*(rq).
292 sendmail: /usr/lib/sendmail
294 The pathname to the \fIsendmail\fR program.
298 .Uh "Post Office Protocol"
299 This option is only available if you compiled \fIMH\fP with POP
300 support enabled (i.e., \*(lqpop:\ on\*(rq).
306 The name of the default POP service host.
308 then \fIMH\fR looks in the standard maildrop areas for waiting mail,
309 otherwise the named POP service host is consulted.
313 .Uh "BBoards Delivery"
314 This option is only available if you compiled \fIMH\fP with
315 \*(lqbbdelivery:\ on\*(rq.
321 The local BBoards domain (a UCI hack).
325 .Uh "BBoards & The POP"
326 These options are only available if you compiled \fIMH\fP with
327 \*(lqbboards:\ pop\*(rq and \*(lqpop:\ on\*(rq.
333 The POP service host which also acts as a BBoard server.
334 This variable should be set on the POP BBoards client host.
339 The guest account on the POP/BB service host.
340 This should be a different login ID than either the POP user or the BBoards
342 (The user-id \*(lqftp\*(rq is highly recommended.)
343 This variable should be set on both the POP BBoards client and service hosts.
346 popbblist: /opt/mh-6.8.5/lib/hosts.popbb
348 A file containing of lists of hosts that are allowed to use the POP facility
349 to access BBoards using the guest account.
350 If this file is not present,
351 then no check is made.
352 This variable should be set on the POP BBoards service host.
357 .Uh "BBoards & The NNTP"
358 This option is only available if you compiled \fIMH\fP with
359 \*(lqbboards:\ nntp\*(rq and \*(lqpop:\ on\*(rq.
365 The host which provides the NNTP service.
366 This variable should be set on the NNTP BBoards client host.
370 A few words on locking:
371 \fIMH\fR has a flexible locking system for making locks on files.
372 There are two \fBmtstailor\fR variables you should be aware of
373 \*(lqlockstyle\*(rq and \*(lqlockldir\*(rq.
374 The first controls the method of locking,
375 the second says where lock files should be created.
377 The \*(lqlockstyle\*(rq variable can take on three values: 0, 1, 2.
378 A value of 0 is useful on systems with kernel-level locking.
379 If you are on a \fBBSD42\fP system, \fIMH\fP assumes
380 you have the \fIflock\fR system call.
382 define \fBFLOCK\fP if you want to use the \fIflock\fP system call;
383 define \fBLOCKF\fP if you want to use the \fIlockf\fP system call;
384 or define \fBFCNTL\fP if you want to use the \fIfcntl\fP system call
385 for kernel-level locking.
386 If you haven't configured \fIMH\fP to use kernel-level locking,
387 a locking style of 0 is considered the same as locking style 1.
389 A value of 1 or 2 specifies that a file should be created whose existence
390 means \*(lqlocked\*(rq and whose non-existence means \*(lqunlocked\*(rq.
391 A value of 1 says to construct the lockname by appending \*(lq.lock\*(rq to
392 the name of the file being locked.
393 A value of 2 says to construct the lockname by looking at the device and
394 inode numbers of the file being locked.
395 If the \*(lqlockldir\*(rq variable is not specified,
396 lock files will be created in the directory where the file being locked
398 Otherwise, lock files will be created in the directory specified by
400 Prior to installing \fIMH\fR,
401 you should see how locking is done at your site,
402 and set the appropriate values.
404 ^/opt/mh-6.8.5/lib/mtstailor~^tailor file
408 mh\-gen(8), mh\-mts(8)