8 date 94.03.23.23.32.50; author jromine; state Exp;
13 date 93.09.01.21.20.56; author jromine; state Exp;
18 date 92.12.02.22.16.12; author jromine; state Exp;
23 date 92.12.02.22.12.10; author jromine; state Exp;
28 date 92.12.02.21.54.24; author jromine; state Exp;
33 date 92.12.02.21.47.04; author jromine; state Exp;
38 date 92.05.12.22.23.34; author jromine; state Exp;
43 date 92.05.12.22.14.47; author jromine; state Exp;
48 date 92.02.11.01.01.06; author jromine; state Exp;
53 date 92.02.11.00.55.16; author jromine; state Exp;
58 date 91.01.07.16.13.27; author mh; state Exp;
63 date 91.01.07.16.13.07; author mh; state Exp;
68 date 90.04.09.09.33.58; author sources; state Exp;
73 date 90.04.08.12.24.46; author sources; state Exp;
78 date 90.04.05.15.08.18; author sources; state Exp;
83 date 90.04.05.13.26.13; author sources; state Exp;
88 date 90.04.02.14.29.25; author sources; state Exp;
93 date 90.03.22.11.31.22; author sources; state Exp;
98 date 90.03.21.10.20.29; author sources; state Exp;
103 date 90.03.20.19.42.00; author sources; state Exp;
108 date 90.03.20.17.36.16; author sources; state Exp;
113 date 89.11.17.15.56.35; author sources; state Exp;
118 date 89.06.02.11.27.10; author sources; state Exp;
129 @document change to clientname
133 .\" @@(#)$Id: mh-tailor.rf,v 2.20 1993/09/01 21:20:56 jromine Exp jromine $
136 mh-tailor, mtstailor \- system customization for MH message handler
139 \fI@@(MHETCPATH)/mtstailor\fP
141 The file @@(MHETCPATH)/mtstailor defines run-time options for those \fIMH\fR
142 programs which interact (in some form) with the message transport system.
143 At present, these (user) programs are:
144 \fIap\fR, \fIconflict\fR, \fIinc\fR, \fImsgchk\fR,
145 \fImsh\fR, \fIpost\fR, \fIrcvdist\fR, and \fIrcvpack\fR.
147 Each option should be given on a single line. Blank lines
148 and lines which begin with `#' are ignored.
149 The options available along with default values and a description of their
150 meanings are listed below:
156 The host name \fIMH\fR considers local.
157 If not set, depending on the version of UNIX you're running,
158 \fIMH\fR will query the system for this value
159 (e.g., <whoami.h>, gethostname, etc.).
160 This has no equivalent in the \fIMH\fR configuration file.
161 POP client hosts should set this value to the name of the POP service host.
166 If this is set, a `.' followed by this string will be
167 appended to your host name.
168 This might be useful for sites
169 where the host name returned by the system
170 (e.g., <whoami.h>, gethostname, etc.),
171 is not a \*(lqfully qualified domain name\*(rq
172 (i.e., does not contain a `.').
177 The host name \fIMH\fP will give in the
178 SMTP \fBHELO\fP (and \fBEHLO\fP) command, when posting mail.
179 If not set, the host name \fIMH\fR considers local is used
180 (see \*(lqlocalname\*(rq above).
181 If empty, no \fBHELO\fP command will be given.
182 Although the \fBHELO\fP command is required by RFC 821,
183 many SMTP servers do not require it.
185 Early versions of SendMail will fail if the host name
186 given in the \fBHELO\fP command is the local host;
187 later versions of SendMail will complain if you omit the
188 \fBHELO\fP command. If you run SendMail, find out what
189 your system expects and set this field if needed.
194 The name of the local host in the \fIUUCP\fR \*(lqdomain\*(rq.
195 If not set, depending on the version of UNIX you're running,
196 \fIMH\fR will query the system for this value.
197 This has no equivalent in the \fIMH\fR configuration file.
200 mmdfldir: @@(MHDROPATH)
202 The directory where maildrops are kept.
203 If this is empty, the user's home directory is used.
204 This overrides the \*(lqmail\*(rq field in the \fIMH\fR configuration file.
207 mmdflfil: @@(MHDROPFIL)
209 The name of the maildrop file in the directory where maildrops are kept.
210 If this is empty, the user's login name is used.
211 This overrides the \*(lqmail\*(rq field in the \fIMH\fR configuration file.
214 mmdelim1: \\001\\001\\001\\001\\n
216 The beginning-of-message delimiter for maildrops.
219 mmdelim2: \\001\\001\\001\\001\\n
221 The end-of-message delimiter for maildrops.
226 If non-zero, then support for MMailids in \fB/etc/passwd\fR is enabled.
227 Basically, the pw_gecos field in the password file is of the form
230 My Full Name <mailid>
232 The \fIMH\fR internal routines that deal with user and full names will return
233 \*(lqmailid\*(rq and \*(lqMy Full Name\*(rq respectively.
238 The locking discipline to perform.
239 A value of \*(lq0\*(rq means to use kernel-level locking
241 (See below for more details.)
242 On systems compiled without kernel-level locking,
243 standard \fIBellMail\fR locking is used.
244 A value of \*(lq1\*(rq means to use \fIBellMail\fR locking always
245 (the name of the lock is based on the file name).
246 A value of \*(lq2\*(rq means to use \fIMMDF\fR locking always
247 (the name of the lock is based on device/inode pairs).
252 The name of the directory for making locks.
253 If your system isn't configured to use kernel-level locking,
254 then this directory is used when creating locks.
255 If the value is empty,
256 then the directory of the file to be locked is used.
259 maildelivery: @@(MHETCPATH)/maildelivery
261 The name of the system-wide default \fI\&.maildelivery\fR file.
262 See \fImhook\fR\0(1) for the details.
267 The highest user-id which should NOT receive mail addressed to
273 If set, then each user-id greater than \*(lqeveryone\*(rq
274 that has a login shell equivalent to the given value (e.g.,
276 indicates that mail for \*(lqeveryone\*(rq should not be sent to them.
277 This is useful for handling admin, dummy, and guest logins.
281 These options are only available if you compiled \fIMH\fP with
282 \*(lqoptions\ MF\*(rq.
286 uucpchan: name of \fIUUCP\fR channel
288 Usually \*(lqUUCP\*(rq.
289 This has no equivalent in the \fIMH\fR configuration file.
292 uucpldir: /usr/spool/mail
294 The name of the directory where \fIUUCP\fR maildrops are kept.
295 This has no equivalent in the \fIMH\fR configuration file.
300 The name of the maildrop file in the directory where \fIUUCP\fR maildrops are
302 If this is empty, the user's login name is used.
303 This has no equivalent in the \fIMH\fR configuration file.
306 umincproc: @@(MHETCPATH)/uminc
308 The path to the program that filters \fIUUCP\fR\^-style maildrops to
309 \fIMMDF\fR\^-style maildrops.
313 .Uh "Stand-Alone Delivery"
314 These options are only available if you compiled \fIMH\fP
315 to use stand-alone delivery (i.e., \*(lqmts:\ mh\*(rq).
319 mailqdir: /usr/spool/netmail
321 The directory where network mail is queued.
326 The directory where network mail queue files are built.
331 If ON, unauthorized mail is copied to the overseer.
336 The user that receives reports of unauthorized mail.
341 The user acting for the mail system.
344 fromtmp: /tmp/rml.f.XXXXXX
346 The \fImktemp\fR template for storing from lines.
349 msgtmp: /tmp/rml.m.XXXXXX
351 The \fImktemp\fR template for storing the rest of the message.
354 errtmp: /tmp/rml.e.XXXXXX
356 The \fImktemp\fR template for storing error messages from other mailers.
361 The octal mode which temporary files are set to.
364 okhosts: @@(MHETCPATH)/Rmail.OKHosts
366 A file containing a list of hosts that can send ARPAnet mail.
369 okdests: @@(MHETCPATH)/RMail.OKDests
371 A file containing a list of hosts that can always receive mail.
375 .Uh "The `/smtp' MTS Suffix"
376 These options are only available if you compiled \fIMH\fP with
377 the \*(lq/smtp\*(rq suffix to your \*(lqmts:\*(rq configuration.
381 hostable: @@(MHETCPATH)/hosts
383 The exceptions file for /etc/hosts used by \fIpost\fR to try to find official
385 The format of this file is quite simple:
388 1. Comments are surrounded by sharp (`#') and newline.
390 2. Words are surrounded by white space.
392 3. The first word on the line is the official name of a host.
394 4. All words following the official names are aliases for that host.
398 servers: localhost \\01localnet
400 A lists of hosts and networks which to look for SMTP servers
401 when posting local mail.
402 It turns out this is a major win for hosts which don't run an message
404 The value of \*(lqservers\*(rq should be one or more items.
405 Each item is the name of either a host or a net
406 (in the latter case, precede the name of the net by a \\01).
407 This list is searched when looking for a smtp server to post mail.
408 If a host is present, the SMTP port on that host is tried.
410 the SMTP port on each host in that net is tried.
411 Note that if you are running with the BIND code,
412 then any networks specified are ignored
413 (sorry, the interface went away under BIND).
418 This option is only available if you compiled \fIMH\fP to
419 use \fISendMail\fP as your delivery agent (i.e., \*(lqmts:\ sendmail\*(rq).
423 sendmail: /usr/lib/sendmail
425 The pathname to the \fIsendmail\fR program.
429 .Uh "Post Office Protocol"
430 This option is only available if you compiled \fIMH\fP with POP
431 support enabled (i.e., \*(lqpop:\ on\*(rq).
437 The name of the default POP service host.
439 then \fIMH\fR looks in the standard maildrop areas for waiting mail,
440 otherwise the named POP service host is consulted.
442 .\" @@BEGIN: BBSERVER
444 .Uh "BBoards Delivery"
445 This option is only available if you compiled \fIMH\fP with
446 \*(lqbbdelivery:\ on\*(rq.
452 The local BBoards domain (a UCI hack).
456 .Uh "BBoards & The POP"
457 These options are only available if you compiled \fIMH\fP with
458 \*(lqbboards:\ pop\*(rq and \*(lqpop:\ on\*(rq.
464 The POP service host which also acts as a BBoard server.
465 This variable should be set on the POP BBoards client host.
470 The guest account on the POP/BB service host.
471 This should be a different login ID than either the POP user or the BBoards
473 (The user-id \*(lqftp\*(rq is highly recommended.)
474 This variable should be set on both the POP BBoards client and service hosts.
477 popbblist: @@(MHETCPATH)/hosts.popbb
479 A file containing of lists of hosts that are allowed to use the POP facility
480 to access BBoards using the guest account.
481 If this file is not present,
482 then no check is made.
483 This variable should be set on the POP BBoards service host.
488 .Uh "BBoards & The NNTP"
489 This option is only available if you compiled \fIMH\fP with
490 \*(lqbboards:\ nntp\*(rq and \*(lqpop:\ on\*(rq.
496 The host which provides the NNTP service.
497 This variable should be set on the NNTP BBoards client host.
501 A few words on locking:
502 \fIMH\fR has a flexible locking system for making locks on files.
503 There are two \fBmtstailor\fR variables you should be aware of
504 \*(lqlockstyle\*(rq and \*(lqlockldir\*(rq.
505 The first controls the method of locking,
506 the second says where lock files should be created.
508 The \*(lqlockstyle\*(rq variable can take on three values: 0, 1, 2.
509 A value of 0 is useful on systems with kernel-level locking.
510 If you are on a \fBBSD42\fP system, \fIMH\fP assumes
511 you have the \fIflock\fR system call.
513 define \fBFLOCK\fP if you want to use the \fIflock\fP system call;
514 define \fBLOCKF\fP if you want to use the \fIlockf\fP system call;
515 or define \fBFCNTL\fP if you want to use the \fIfcntl\fP system call
516 for kernel-level locking.
517 If you haven't configured \fIMH\fP to use kernel-level locking,
518 a locking style of 0 is considered the same as locking style 1.
520 A value of 1 or 2 specifies that a file should be created whose existence
521 means \*(lqlocked\*(rq and whose non-existence means \*(lqunlocked\*(rq.
522 A value of 1 says to construct the lockname by appending \*(lq.lock\*(rq to
523 the name of the file being locked.
524 A value of 2 says to construct the lockname by looking at the device and
525 inode numbers of the file being locked.
526 If the \*(lqlockldir\*(rq variable is not specified,
527 lock files will be created in the directory where the file being locked
529 Otherwise, lock files will be created in the directory specified by
531 Prior to installing \fIMH\fR,
532 you should see how locking is done at your site,
533 and set the appropriate values.
535 ^@@(MHETCPATH)/mtstailor~^tailor file
539 mh\-gen(8), mh\-mts(8)
550 @document "clientname"
555 .\" @@(#)$Id: mh-tailor.rf,v 2.19 1992/12/02 22:16:12 jromine Exp jromine $
558 If not set, no \fBHELO\fP command will be given.
561 your system expects and set this field accordingly.
572 .\" @@(#)$Id: mh-tailor.rf,v 2.18 1992/12/02 22:12:10 jromine Exp jromine $
575 POP client hosts have this value set to the name of the POP service host.
588 .\" @@(#)$Id: mh-tailor.rf,v 2.17 1992/12/02 21:54:24 jromine Exp jromine $
591 The path to the program that filters \fIUUCP\fR-style maildrops to
592 \fIMMDF\fR-style maildrops.
598 @explain comment line format
603 .\" @@(#)$Id: mh-tailor.rf,v 2.16 1992/12/02 21:47:04 jromine Exp jromine $
606 mh-tailor, mtstailor \- MH system configuration file
612 @NA fixup, and \- fixups
617 .\" @@(#)$Id: mh-tailor.rf,v 2.15 1992/05/12 22:23:34 jromine Exp jromine $
624 @fixup for nroff problems
629 .\" @@(#)$Id: mh-tailor.rf,v 2.14 1992/05/12 22:14:47 jromine Exp jromine $
632 @@(MHETCPATH)/mtstailor \- system customization for MH message system
635 any \fIMH\fR command that interacts with the MTS
638 The file @@(MHETCPATH)/mtstailor defines run\-time options for those \fIMH\fR
641 The beginning\-of\-message delimiter for maildrops.
644 The end\-of\-message delimiter for maildrops.
647 The locking\-discipline to perform.
650 The name of the system\-wide default \fI\&.maildelivery\fR file.
653 The highest user\-id which should NOT receive mail addressed to
656 The path to the program that filters \fIUUCP\fR\-style maildrops to
657 \fIMMDF\fR\-style maildrops.
660 2. Words are surrounded by whitespace.
663 (The user\-id \*(lqftp\*(rq is highly recommended.)
666 means \*(lqlocked\*(rq and whose non\-existence means \*(lqunlocked\*(rq.
677 .\" @@(#)$Id: mh-tailor.rf,v 2.13 1992/02/11 01:01:06 jromine Exp jromine $
684 @document localdomain
689 .\" @@(#)$Id: mh-tailor.rf,v 2.12 1992/02/11 00:55:16 jromine Exp jromine $
692 A file containing a list of hosts that can sent ARPAnet mail.
703 .\" @@(#)$Id: mh-tailor.rf,v 2.11 1991/01/07 16:13:27 mh Exp jromine $
715 .\" @@(#)$Id: mh-tailor.rf,v 2.10 91/01/07 16:13:07 mh Exp Locker: mh $
718 A value of \*(lq0\*(rq means to use \fIflock\fR if available,
719 or \fIlockf\fR if \fBLOCKF\fP was defined when building \fIMH\fP.
720 On non-\fBBSD42\fP systems,
723 If your system doesn't have the \fIflock\fR or \fIlockf\fP syscalls,
727 A value of 0 is useful on \fBBSD42\fP systems.
728 If you included the \fBLOCKF\fP option when building \fIMH\fP, the
729 \fIlockf\fP syscall is used, otherwise the \fIflock\fP syscall is used.
730 If you're not on a 4.2BSD system,
743 .\" @@(#)$Id: mh-tailor.rf,v 2.9 90/04/09 09:33:58 sources Exp Locker: mh $
744 .if !'\*(ZZ'-man' \{\
749 .b "\\s-2\&\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\\s0"
764 .\" @@(#)$Id: mh-tailor.rf,v 2.8 90/04/08 12:24:46 sources Exp Locker: sources $
767 standard \fIBellMail\fR locking otherwise.
770 If your system doesn't have the \fIflock\fR syscall,
776 .SS "Stand-Alone Delivery"
779 .SS "The \*(lq/smtp\*(rq MTS Suffix"
785 .SS "Post Office Protocol"
788 .SS "BBoards Delivery"
791 .SS "BBoards & The POP"
794 .SS "BBoards & The NNTP"
800 A value of 0 says to use the flock syscall if you're running on 4.2BSD,
801 (otherwise use a locking style of 1).
807 @describe all options, for novice MH administrators
812 .\" @@(#)$Id: mh-tailor.rf,v 2.7 90/04/05 15:08:18 sources Exp Locker: sources $
815 \*(lqbboards:\ pop\*(rq.
824 \*(lqbboards:\ nntp\*(rq.
841 This has no equivalent in the \fIMH\fR configuration file.
845 uucpchan: name of \fIUUCP\fR channel
847 Usually \*(lqUUCP\*(rq.
848 This has no equivalent in the \fIMH\fR configuration file.
855 uucpldir: /usr/spool/mail
857 The name of the directory where \fIUUCP\fR maildrops are kept.
858 This has no equivalent in the \fIMH\fR configuration file.
863 The name of the maildrop file in the directory where \fIUUCP\fR maildrops are
865 If this is empty, the user's login name is used.
866 This has no equivalent in the \fIMH\fR configuration file.
873 umincproc: @@(MHETCPATH)/uminc
875 The path to the program that filters \fIUUCP\fR\-style maildrops to
876 \fIMMDF\fR\-style maildrops.
918 maildelivery: @@(MHETCPATH)/maildelivery
920 The name of the system\-wide default \fI\&.maildelivery\fR file.
921 See \fImhook\fR\0(1) for the details.
926 The highest user\-id which should NOT receive mail addressed to
932 If set, then each user-id greater than \*(lqeveryone\*(rq
933 that has a login shell equivalent to the given value (e.g.,
935 indicates that mail for \*(lqeveryone\*(rq should not be sent to them.
936 This is useful for handling admin, dummy, and guest logins.
962 @put things back, do .NA stuff another way
967 A value of 1 or 2 specifies that a file should be created whose existance
973 @changes for "bbhome: none"
978 .TH MH\-TAILOR 5 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
1002 @fixup for makewhatis
1007 .TH MH\-TAILOR 5 [mh.6] MH
1013 @changes for SUN40 shared libraries and NNTP under bbc