Annotation of 43BSD/contrib/mh/conf/doc/mh-tailor.rf, revision 1.1.1.1

1.1       root        1: .\"    @(MHWARNING)
                      2: .TH MH\-TAILOR 5 "April 22, 1986" MH [mh.6]
                      3: .UC 6
                      4: .SH NAME
                      5: @(MHETCPATH)/mtstailor \- system customization for MH message system
                      6: .SH SYNOPSIS
                      7: .in +.5i
                      8: .ti -.5i
                      9: any \fIMH\fR command that interacts with the MTS
                     10: .in -.5i
                     11: .SH DESCRIPTION
                     12: The file @(MHETCPATH)/mtstailor defines run\-time options for those \fIMH\fR
                     13: programs which interact (in some form) with the message transport system.
                     14: At present, these (user) programs are:
                     15: \fIap\fR, \fIconflict\fR, \fIinc\fR, \fImsgchk\fR,
                     16: \fImsh\fR, \fIpost\fR, \fIrcvdist\fR, and \fIrcvpack\fR.
                     17: 
                     18: The options available along with default values and a description of their
                     19: meanings are listed below:
                     20: 
                     21: .in +.5i
                     22: .ti -.5i
                     23: localname:
                     24: .br
                     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: @BEGIN: POP
                     30: POP client hosts have this value set to the name of the POP service host.
                     31: @END: POP
                     32: This has no equivalent in the \fIMH\fR configuration file.
                     33: 
                     34: .ti -.5i
                     35: systemname:
                     36: .br
                     37: The name of the local host in the \fIUUCP\fR \*(lqdomain\*(rq.
                     38: If not set, depending on the version of UNIX you're running,
                     39: \fIMH\fR will query the system for this value.
                     40: This has no equivalent in the \fIMH\fR configuration file.
                     41: @BEGIN: MF
                     42: 
                     43: .ti -.5i
                     44: uucpchan: name of \fIUUCP\fR channel
                     45: .br
                     46: Usually \*(lqUUCP\*(rq.
                     47: This has no equivalent in the \fIMH\fR configuration file.
                     48: @END: MF
                     49: 
                     50: .ti -.5i
                     51: mmdfldir: @(MHDROPATH)
                     52: .br
                     53: The directory where maildrops are kept.
                     54: If this is empty, the user's home directory is used.
                     55: This overrides the \*(lqmail\*(rq field in the \fIMH\fR configuration file.
                     56: 
                     57: .ti -.5i
                     58: mmdflfil: @(MHDROPFIL)
                     59: .br
                     60: The name of the maildrop file in the directory where maildrops are kept.
                     61: If this is empty, the user's login name is used.
                     62: This overrides the \*(lqmail\*(rq field in the \fIMH\fR configuration file.
                     63: @BEGIN: MF
                     64: 
                     65: .ti -.5i
                     66: uucpldir: /usr/spool/mail
                     67: .br
                     68: The name of the directory where \fIUUCP\fR maildrops are kept.
                     69: This has no equivalent in the \fIMH\fR configuration file.
                     70: 
                     71: .ti -.5i
                     72: uucplfil:
                     73: .br
                     74: The name of the maildrop file in the directory where \fIUUCP\fR maildrops are
                     75: kept.
                     76: If this is empty, the user's login name is used.
                     77: This has no equivalent in the \fIMH\fR configuration file.
                     78: @END: MF
                     79: 
                     80: .ti -.5i
                     81: mmdelim1: \\001\\001\\001\\001\\n
                     82: .br
                     83: The beginning\-of\-message delimiter for maildrops.
                     84: 
                     85: .ti -.5i
                     86: mmdelim2: \\001\\001\\001\\001\\n
                     87: .br
                     88: The end\-of\-message delimiter for maildrops.
                     89: 
                     90: .ti -.5i
                     91: mmailid: 0
                     92: .br
                     93: If non-zero, then support for MMailids in \fB/etc/passwd\fR is enabled.
                     94: Basically, the pw_gecos field in the password file is of the form
                     95: 
                     96: .ti +.5i
                     97: My Full Name <mailid>
                     98: 
                     99: The \fIMH\fR internal routines that deal with user and full names will return
                    100: \*(lqmailid\*(rq and \*(lqMy Full Name\*(rq respectively.
                    101: @BEGIN: MF
                    102: 
                    103: .ti -.5i
                    104: umincproc: @(MHETCPATH)/uminc
                    105: .br
                    106: The path to the program that filters \fIUUCP\fR\-style maildrops to
                    107: \fIMMDF\fR\-style maildrops.
                    108: @END: MF
                    109: 
                    110: .ti -.5i
                    111: lockstyle: 0
                    112: .br
                    113: The locking\-discipline to perform.
                    114: A value of \*(lq0\*(rq means to use \fIflock\fR if available,
                    115: standard \fIBellMail\fR locking otherwise.
                    116: A value of \*(lq1\*(rq means to use \fIBellMail\fR locking always
                    117: (the name of the lock is based on the file name).
                    118: A value of \*(lq2\*(rq means to use \fIMMDF\fR locking always
                    119: (the name of the lock is based on device/inode pairs).
                    120: 
                    121: .ti -.5i
                    122: lockldir:
                    123: .br
                    124: The name of the directory for making locks.
                    125: If your system doesn't have the \fIflock\fR syscall,
                    126: then this directory is used when creating locks.
                    127: If the value is empty,
                    128: then the directory of the file to be locked is used.
                    129: @BEGIN: MHMTS
                    130: 
                    131: .ti -.5i
                    132: mailqdir: /usr/spool/netmail
                    133: .br
                    134: The directory where network mail is queued.
                    135: 
                    136: .ti -.5i
                    137: tmailqdir: /usr/tmp
                    138: .br
                    139: The directory where network mail queue files are built.
                    140: 
                    141: .ti -.5i
                    142: syscpy: 1
                    143: .br
                    144: If ON, unauthorized mail is copied to the overseer.
                    145: 
                    146: .ti -.5i
                    147: overseer: root
                    148: .br
                    149: The user that receives reports of unauthorized mail.
                    150: 
                    151: .ti -.5i
                    152: mailer: root
                    153: .br
                    154: The user acting for the mail system.
                    155: 
                    156: .ti -.5i
                    157: fromtmp: /tmp/rml.f.XXXXXX
                    158: .br
                    159: The \fImktemp\fR template for storing from lines.
                    160: 
                    161: .ti -.5i
                    162: msgtmp: /tmp/rml.m.XXXXXX
                    163: .br
                    164: The \fImktemp\fR template for storing the rest of the message.
                    165: 
                    166: .ti -.5i
                    167: errtmp: /tmp/rml.e.XXXXXX
                    168: .br
                    169: The \fImktemp\fR template for storing error messages from other mailers.
                    170: 
                    171: .ti -.5i
                    172: tmpmode: 0600
                    173: .br
                    174: The octal mode which temporary files are set to.
                    175: 
                    176: .ti -.5i
                    177: okhosts: @(MHETCPATH)/Rmail.OKHosts
                    178: .br
                    179: A file containing a list of hosts that can sent ARPAnet mail.
                    180: 
                    181: .ti -.5i
                    182: okdests: @(MHETCPATH)/RMail.OKDests
                    183: .br
                    184: A file containing a list of hosts that can always receive mail.
                    185: @END: MHMTS
                    186: @BEGIN: SMTP
                    187: 
                    188: .ti -.5i
                    189: hostable: @(MHETCPATH)/hosts
                    190: .br
                    191: The exceptions file for /etc/hosts used by \fIpost\fR to try to find official
                    192: names.
                    193: The format of this file is quite simple:
                    194: 
                    195: .in +.5i
                    196: 1. Comments are surrounded by sharp (`#') and newline.
                    197: .br
                    198: 2. Words are surrounded by whitespace.
                    199: .br
                    200: 3. The first word on the line is the official name of a host.
                    201: .br
                    202: 4. All words following the official names are aliases for that host.
                    203: .in -.5i
                    204: 
                    205: .ti -.5i
                    206: servers: localhost \\01localnet
                    207: .br
                    208: A lists of hosts and networks which to look for SMTP servers
                    209: when posting local mail.
                    210: It turns out this is a major win for hosts which don't run an message
                    211: transport system.
                    212: The value of \*(lqservers\*(rq should be one or more items.
                    213: Each item is the name of either a host or a net
                    214: (in the latter case, precede the name of the net by a \\01).
                    215: This list is searched when looking for a smtp server to post mail.
                    216: If a host is present, the SMTP port on that host is tried.
                    217: If a net is present,
                    218: the SMTP port on each host in that net is tried.
                    219: Note that if you are running with the BIND code,
                    220: then any networks specified are ignored
                    221: (sorry, the interface went away under BIND).
                    222: @END: SMTP
                    223: @BEGIN: SENDMTS
                    224: 
                    225: .ti -.5i
                    226: sendmail: /usr/lib/sendmail
                    227: .br
                    228: The pathname to the \fIsendmail\fR program.
                    229: @END: SENDMTS
                    230: @BEGIN: POP
                    231: 
                    232: .ti -.5i
                    233: pophost:
                    234: .br
                    235: The name of the default POP service host.
                    236: If this is not set,
                    237: then \fIMH\fR looks in the standard maildrop areas for waiting mail,
                    238: otherwise the named POP service host is consulted.
                    239: @END: POP
                    240: @BEGIN: BBOARDS
                    241: 
                    242: .ti -.5i
                    243: bbdomain:
                    244: .br
                    245: The local BBoards domain (a UCI hack).
                    246: @END: BBOARDS
                    247: @BEGIN: BPOP
                    248: 
                    249: .ti -.5i
                    250: popbbhost
                    251: .br
                    252: The POP service host which also acts as a BBoard server.
                    253: This variable should be set on the POP BBoards client host.
                    254: 
                    255: .ti -.5i
                    256: popbbuser
                    257: .br
                    258: The guest account on the POP/BB service host.
                    259: This should be a different login ID than either the POP user or the BBoards
                    260: user.
                    261: (The user\-id \*(lqftp\*(rq is highly recommended.)
                    262: This variable should be set on both the POP BBoards client and service hosts.
                    263: 
                    264: .ti -.5i
                    265: popbblist: @(MHETCPATH)/hosts.popbb
                    266: .br
                    267: A file containing of lists of hosts that are allowed to use the POP facility
                    268: to access BBoards using the guest account.
                    269: If this file is not present,
                    270: then no check is made.
                    271: This variable should be set on the POP BBoards service host.
                    272: @END: BPOP
                    273: 
                    274: .ti -.5i
                    275: maildelivery: @(MHETCPATH)/maildelivery
                    276: .br
                    277: The name of the system\-wide default \fI\&.maildelivery\fR file.
                    278: See \fImhook\fR\0(1) for the details.
                    279: 
                    280: .ti -.5i
                    281: everyone: 200
                    282: .br
                    283: The highest user\-id which should NOT receive mail addressed to
                    284: \*(lqeveryone\*(rq.
                    285: 
                    286: .ti -.5i
                    287: noshell: 
                    288: .br
                    289: If set, then each user-id greater than \*(lqeveryone\*(rq
                    290: that has a login shell equivalent to the given value (e.g.,
                    291: \*(lq/bin/csh\*(rq)
                    292: indicates that mail for \*(lqeveryone\*(rq should not be sent to them.
                    293: This is useful for handling admin, dummy, and guest logins.
                    294: .in -.5i
                    295: 
                    296: A few words on locking:
                    297: \fIMH\fR has a flexible locking system for making locks on files.
                    298: There are two \fBmtstailor\fR variables you should be aware of
                    299: \*(lqlockstyle\*(rq and \*(lqlockldir\*(rq.
                    300: The first controls the method of locking,
                    301: the second says where lock files should be created.
                    302: The \*(lqlockstyle\*(rq variable can take on three values: 0, 1, 2.
                    303: A value of 0 says to use the flock syscall if you're running on 4.2BSD,
                    304: (otherwise use a locking style of 1).
                    305: A value of 1 or 2 specifies that a file should be created whose existance
                    306: means \*(lqlocked\*(rq and whose non\-existence means \*(lqunlocked\*(rq.
                    307: A value of 1 says to construct the lockname by appending \*(lq.lock\*(rq to
                    308: the name of the file being locked.
                    309: A value of 2 says to construct the lockname by looking at the device and
                    310: inode numbers of the file being locked.
                    311: If the \*(lqlockldir\*(rq variable is not specified,
                    312: lock files will be created in the directory where the file being locked
                    313: resides.
                    314: Otherwise, lock files will be created in the directory specified by
                    315: \*(lqlockldir\*(rq.
                    316: Prior to installing \fIMH\fR,
                    317: you should see how locking is done at your site,
                    318: and set the appropriate values.
                    319: .Fi
                    320: ^@(MHETCPATH)/mtstailor~^tailor file
                    321: .Pr
                    322: None
                    323: .Sa
                    324: mh\-gen(8), mh\-mts(8)
                    325: .De
                    326: As listed above
                    327: .Co
                    328: None
                    329: .En

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.