0
|
1 .\" @(MHWARNING)
|
12
|
2 .\" @(#)$Id: mh-tailor.rf,v 1.1.1.1 2005/04/18 14:46:03 kono Exp $
|
0
|
3 .SC MH-TAILOR 5
|
|
4 .NA
|
|
5 mh-tailor, mtstailor \- system customization for MH message handler
|
|
6
|
|
7 .SY
|
|
8 \fI@(MHETCPATH)/mtstailor\fP
|
|
9 .DE
|
|
10 The file @(MHETCPATH)/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.
|
|
15
|
|
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:
|
|
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 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.
|
|
31
|
|
32 .ti -.5i
|
|
33 localdomain:
|
|
34 .br
|
|
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 `.').
|
|
42
|
|
43 .ti -.5i
|
|
44 clientname:
|
|
45 .br
|
|
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.
|
|
53 .sp
|
|
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.
|
|
59
|
|
60 .ti -.5i
|
|
61 systemname:
|
|
62 .br
|
|
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.
|
|
67
|
|
68 .ti -.5i
|
|
69 mmdfldir: @(MHDROPATH)
|
|
70 .br
|
|
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.
|
|
74
|
|
75 .ti -.5i
|
|
76 mmdflfil: @(MHDROPFIL)
|
|
77 .br
|
|
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.
|
|
81
|
|
82 .ti -.5i
|
|
83 mmdelim1: \\001\\001\\001\\001\\n
|
|
84 .br
|
|
85 The beginning-of-message delimiter for maildrops.
|
|
86
|
|
87 .ti -.5i
|
|
88 mmdelim2: \\001\\001\\001\\001\\n
|
|
89 .br
|
|
90 The end-of-message delimiter for maildrops.
|
|
91
|
|
92 .ti -.5i
|
|
93 mmailid: 0
|
|
94 .br
|
|
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
|
|
97
|
|
98 .ti +.5i
|
|
99 My Full Name <mailid>
|
|
100
|
|
101 The \fIMH\fR internal routines that deal with user and full names will return
|
|
102 \*(lqmailid\*(rq and \*(lqMy Full Name\*(rq respectively.
|
|
103 @BEGIN: MH_PLUS
|
|
104
|
|
105 .ti -.5i
|
|
106 localuser: 0
|
|
107 .br
|
|
108 If non-zero, then make effective \*(lqSendername\*(rq in \fB.mh_profile\fR.
|
|
109 @END: MH_PLUS
|
|
110
|
|
111 .ti -.5i
|
|
112 lockstyle: 0
|
|
113 .br
|
|
114 The locking discipline to perform.
|
|
115 A value of \*(lq0\*(rq means to use kernel-level locking
|
|
116 if available.
|
|
117 (See below for more details.)
|
|
118 On systems compiled without kernel-level locking,
|
|
119 standard \fIBellMail\fR locking is used.
|
|
120 A value of \*(lq1\*(rq means to use \fIBellMail\fR locking always
|
|
121 (the name of the lock is based on the file name).
|
|
122 A value of \*(lq2\*(rq means to use \fIMMDF\fR locking always
|
|
123 (the name of the lock is based on device/inode pairs).
|
|
124
|
|
125 .ti -.5i
|
|
126 lockldir:
|
|
127 .br
|
|
128 The name of the directory for making locks.
|
|
129 If your system isn't configured to use kernel-level locking,
|
|
130 then this directory is used when creating locks.
|
|
131 If the value is empty,
|
|
132 then the directory of the file to be locked is used.
|
|
133
|
|
134 .ti -.5i
|
|
135 maildelivery: @(MHETCPATH)/maildelivery
|
|
136 .br
|
|
137 The name of the system-wide default \fI\&.maildelivery\fR file.
|
|
138 See \fImhook\fR\0(1) for the details.
|
|
139
|
|
140 .ti -.5i
|
|
141 everyone: 200
|
|
142 .br
|
|
143 The highest user-id which should NOT receive mail addressed to
|
|
144 \*(lqeveryone\*(rq.
|
|
145
|
|
146 .ti -.5i
|
|
147 noshell:
|
|
148 .br
|
|
149 If set, then each user-id greater than \*(lqeveryone\*(rq
|
|
150 that has a login shell equivalent to the given value (e.g.,
|
|
151 \*(lq/bin/csh\*(rq)
|
|
152 indicates that mail for \*(lqeveryone\*(rq should not be sent to them.
|
|
153 This is useful for handling admin, dummy, and guest logins.
|
|
154 .\" @BEGIN: MF
|
|
155 .in -.5i
|
|
156 .Uh "Mail Filtering"
|
|
157 These options are only available if you compiled \fIMH\fP with
|
|
158 \*(lqoptions\ MF\*(rq.
|
|
159
|
|
160 .in +.5i
|
|
161 .ti -.5i
|
|
162 uucpchan: name of \fIUUCP\fR channel
|
|
163 .br
|
|
164 Usually \*(lqUUCP\*(rq.
|
|
165 This has no equivalent in the \fIMH\fR configuration file.
|
|
166
|
|
167 .ti -.5i
|
|
168 uucpldir: /usr/spool/mail
|
|
169 .br
|
|
170 The name of the directory where \fIUUCP\fR maildrops are kept.
|
|
171 This has no equivalent in the \fIMH\fR configuration file.
|
|
172
|
|
173 .ti -.5i
|
|
174 uucplfil:
|
|
175 .br
|
|
176 The name of the maildrop file in the directory where \fIUUCP\fR maildrops are
|
|
177 kept.
|
|
178 If this is empty, the user's login name is used.
|
|
179 This has no equivalent in the \fIMH\fR configuration file.
|
|
180
|
|
181 .ti -.5i
|
|
182 umincproc: @(MHETCPATH)/uminc
|
|
183 .br
|
|
184 The path to the program that filters \fIUUCP\fR\^-style maildrops to
|
|
185 \fIMMDF\fR\^-style maildrops.
|
|
186 .\" @END: MF
|
|
187 .\" @BEGIN: MHMTS
|
|
188 .in -.5i
|
|
189 .Uh "Stand-Alone Delivery"
|
|
190 These options are only available if you compiled \fIMH\fP
|
|
191 to use stand-alone delivery (i.e., \*(lqmts:\ mh\*(rq).
|
|
192
|
|
193 .in +.5i
|
|
194 .ti -.5i
|
|
195 mailqdir: /usr/spool/netmail
|
|
196 .br
|
|
197 The directory where network mail is queued.
|
|
198
|
|
199 .ti -.5i
|
|
200 tmailqdir: /usr/tmp
|
|
201 .br
|
|
202 The directory where network mail queue files are built.
|
|
203
|
|
204 .ti -.5i
|
|
205 syscpy: 1
|
|
206 .br
|
|
207 If ON, unauthorized mail is copied to the overseer.
|
|
208
|
|
209 .ti -.5i
|
|
210 overseer: root
|
|
211 .br
|
|
212 The user that receives reports of unauthorized mail.
|
|
213
|
|
214 .ti -.5i
|
|
215 mailer: root
|
|
216 .br
|
|
217 The user acting for the mail system.
|
|
218
|
|
219 .ti -.5i
|
|
220 fromtmp: /tmp/rml.f.XXXXXX
|
|
221 .br
|
|
222 The \fImktemp\fR template for storing from lines.
|
|
223
|
|
224 .ti -.5i
|
|
225 msgtmp: /tmp/rml.m.XXXXXX
|
|
226 .br
|
|
227 The \fImktemp\fR template for storing the rest of the message.
|
|
228
|
|
229 .ti -.5i
|
|
230 errtmp: /tmp/rml.e.XXXXXX
|
|
231 .br
|
|
232 The \fImktemp\fR template for storing error messages from other mailers.
|
|
233
|
|
234 .ti -.5i
|
|
235 tmpmode: 0600
|
|
236 .br
|
|
237 The octal mode which temporary files are set to.
|
|
238
|
|
239 .ti -.5i
|
|
240 okhosts: @(MHETCPATH)/Rmail.OKHosts
|
|
241 .br
|
|
242 A file containing a list of hosts that can send ARPAnet mail.
|
|
243
|
|
244 .ti -.5i
|
|
245 okdests: @(MHETCPATH)/RMail.OKDests
|
|
246 .br
|
|
247 A file containing a list of hosts that can always receive mail.
|
|
248 .\" @END: MHMTS
|
|
249 .\" @BEGIN: SMTP
|
|
250 .in -.5i
|
|
251 .Uh "The `/smtp' MTS Suffix"
|
|
252 These options are only available if you compiled \fIMH\fP with
|
|
253 the \*(lq/smtp\*(rq suffix to your \*(lqmts:\*(rq configuration.
|
|
254
|
|
255 .in +.5i
|
|
256 .ti -.5i
|
|
257 hostable: @(MHETCPATH)/hosts
|
|
258 .br
|
|
259 The exceptions file for /etc/hosts used by \fIpost\fR to try to find official
|
|
260 names.
|
|
261 The format of this file is quite simple:
|
|
262
|
|
263 .in +.5i
|
|
264 1. Comments are surrounded by sharp (`#') and newline.
|
|
265 .br
|
|
266 2. Words are surrounded by white space.
|
|
267 .br
|
|
268 3. The first word on the line is the official name of a host.
|
|
269 .br
|
|
270 4. All words following the official names are aliases for that host.
|
|
271 .in -.5i
|
|
272
|
|
273 .ti -.5i
|
|
274 servers: localhost \\01localnet
|
|
275 .br
|
|
276 A lists of hosts and networks which to look for SMTP servers
|
|
277 when posting local mail.
|
|
278 It turns out this is a major win for hosts which don't run an message
|
|
279 transport system.
|
|
280 The value of \*(lqservers\*(rq should be one or more items.
|
|
281 Each item is the name of either a host or a net
|
|
282 (in the latter case, precede the name of the net by a \\01).
|
|
283 This list is searched when looking for a smtp server to post mail.
|
|
284 If a host is present, the SMTP port on that host is tried.
|
|
285 If a net is present,
|
|
286 the SMTP port on each host in that net is tried.
|
|
287 Note that if you are running with the BIND code,
|
|
288 then any networks specified are ignored
|
|
289 (sorry, the interface went away under BIND).
|
|
290 .\" @END: SMTP
|
|
291 .\" @BEGIN: SENDMTS
|
|
292 .in -.5i
|
|
293 .Uh "SendMail"
|
|
294 This option is only available if you compiled \fIMH\fP to
|
|
295 use \fISendMail\fP as your delivery agent (i.e., \*(lqmts:\ sendmail\*(rq).
|
|
296
|
|
297 .in +.5i
|
|
298 .ti -.5i
|
|
299 sendmail: /usr/lib/sendmail
|
|
300 .br
|
|
301 The pathname to the \fIsendmail\fR program.
|
|
302 .\" @END: SENDMTS
|
|
303 .\" @BEGIN: POP
|
|
304 .in -.5i
|
|
305 .Uh "Post Office Protocol"
|
|
306 This option is only available if you compiled \fIMH\fP with POP
|
|
307 support enabled (i.e., \*(lqpop:\ on\*(rq).
|
|
308
|
|
309 .in +.5i
|
|
310 .ti -.5i
|
|
311 pophost:
|
|
312 .br
|
|
313 The name of the default POP service host.
|
|
314 If this is not set,
|
|
315 then \fIMH\fR looks in the standard maildrop areas for waiting mail,
|
|
316 otherwise the named POP service host is consulted.
|
|
317 .\" @END: POP
|
|
318 .\" @BEGIN: BBSERVER
|
|
319 .in -.5i
|
|
320 .Uh "BBoards Delivery"
|
|
321 This option is only available if you compiled \fIMH\fP with
|
|
322 \*(lqbbdelivery:\ on\*(rq.
|
|
323
|
|
324 .in +.5i
|
|
325 .ti -.5i
|
|
326 bbdomain:
|
|
327 .br
|
|
328 The local BBoards domain (a UCI hack).
|
|
329 .\" @END: BBSERVER
|
|
330 .\" @BEGIN: BPOP
|
|
331 .in -.5i
|
|
332 .Uh "BBoards & The POP"
|
|
333 These options are only available if you compiled \fIMH\fP with
|
|
334 \*(lqbboards:\ pop\*(rq and \*(lqpop:\ on\*(rq.
|
|
335
|
|
336 .in +.5i
|
|
337 .ti -.5i
|
|
338 popbbhost:
|
|
339 .br
|
|
340 The POP service host which also acts as a BBoard server.
|
|
341 This variable should be set on the POP BBoards client host.
|
|
342
|
|
343 .ti -.5i
|
|
344 popbbuser:
|
|
345 .br
|
|
346 The guest account on the POP/BB service host.
|
|
347 This should be a different login ID than either the POP user or the BBoards
|
|
348 user.
|
|
349 (The user-id \*(lqftp\*(rq is highly recommended.)
|
|
350 This variable should be set on both the POP BBoards client and service hosts.
|
|
351
|
|
352 .ti -.5i
|
|
353 popbblist: @(MHETCPATH)/hosts.popbb
|
|
354 .br
|
|
355 A file containing of lists of hosts that are allowed to use the POP facility
|
|
356 to access BBoards using the guest account.
|
|
357 If this file is not present,
|
|
358 then no check is made.
|
|
359 This variable should be set on the POP BBoards service host.
|
|
360 .\" @END: BPOP
|
|
361 .\" @BEGIN: NNTP
|
|
362 .in -.5i
|
|
363 .if n .ne 8
|
|
364 .Uh "BBoards & The NNTP"
|
|
365 This option is only available if you compiled \fIMH\fP with
|
|
366 \*(lqbboards:\ nntp\*(rq and \*(lqpop:\ on\*(rq.
|
|
367
|
|
368 .in +.5i
|
|
369 .ti -.5i
|
|
370 nntphost:
|
|
371 .br
|
|
372 The host which provides the NNTP service.
|
|
373 This variable should be set on the NNTP BBoards client host.
|
|
374 .\" @END: NNTP
|
|
375 .in -.5i
|
|
376 .Uh "File Locking"
|
|
377 A few words on locking:
|
|
378 \fIMH\fR has a flexible locking system for making locks on files.
|
|
379 There are two \fBmtstailor\fR variables you should be aware of
|
|
380 \*(lqlockstyle\*(rq and \*(lqlockldir\*(rq.
|
|
381 The first controls the method of locking,
|
|
382 the second says where lock files should be created.
|
|
383
|
|
384 The \*(lqlockstyle\*(rq variable can take on three values: 0, 1, 2.
|
|
385 A value of 0 is useful on systems with kernel-level locking.
|
|
386 If you are on a \fBBSD42\fP system, \fIMH\fP assumes
|
|
387 you have the \fIflock\fR system call.
|
|
388 On other systems:
|
|
389 define \fBFLOCK\fP if you want to use the \fIflock\fP system call;
|
|
390 define \fBLOCKF\fP if you want to use the \fIlockf\fP system call;
|
|
391 or define \fBFCNTL\fP if you want to use the \fIfcntl\fP system call
|
|
392 for kernel-level locking.
|
|
393 If you haven't configured \fIMH\fP to use kernel-level locking,
|
|
394 a locking style of 0 is considered the same as locking style 1.
|
|
395
|
|
396 A value of 1 or 2 specifies that a file should be created whose existence
|
|
397 means \*(lqlocked\*(rq and whose non-existence means \*(lqunlocked\*(rq.
|
|
398 A value of 1 says to construct the lockname by appending \*(lq.lock\*(rq to
|
|
399 the name of the file being locked.
|
|
400 A value of 2 says to construct the lockname by looking at the device and
|
|
401 inode numbers of the file being locked.
|
|
402 If the \*(lqlockldir\*(rq variable is not specified,
|
|
403 lock files will be created in the directory where the file being locked
|
|
404 resides.
|
|
405 Otherwise, lock files will be created in the directory specified by
|
|
406 \*(lqlockldir\*(rq.
|
|
407 Prior to installing \fIMH\fR,
|
|
408 you should see how locking is done at your site,
|
|
409 and set the appropriate values.
|
|
410 .Fi
|
|
411 ^@(MHETCPATH)/mtstailor~^tailor file
|
|
412 .Pr
|
|
413 None
|
|
414 .Sa
|
|
415 mh\-gen(8), mh\-mts(8)
|
|
416 .De
|
|
417 As listed above
|
|
418 .Co
|
|
419 None
|
|
420 .En
|