Return to mh-tailor.rf CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / mh / conf / doc

Annotation of 43BSD/contrib/mh/conf/doc/mh-tailor.rf, revision 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

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