3963e4b94af58599e573405ce3e7b518c0618111
[mmh] / mh-tailor.man
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH MH-TAILOR %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 mh-tailor, mts.conf \- mail transport customization for nmh message handler
7 .SH SYNOPSIS
8 .I %etcdir%/mts.conf
9 .SH DESCRIPTION
10 The file
11 .I %etcdir%/mts.conf
12 defines run-time options for those
13 .B nmh
14 programs which interact (in some form) with the message transport system.
15 At present, these (user) programs are:
16 .BR ap ,
17 .BR conflict ,
18 .BR inc ,
19 .BR msgchk ,
20 .BR msh ,
21 .BR post ,
22 .BR rcvdist ,
23 and
24 .BR rcvpack .
25 .PP
26 Each option should be given on a single line.  Blank lines and lines
27 which begin with `#' are ignored.  The options available along with
28 default values and a description of their meanings are listed below:
29 .PP
30 .BR mts :
31 .RS 5
32 The mail transport method to use.  The two acceptable options are
33 .B smtp
34 (which is the default), and
35 .BR sendmail .
36 .PP
37 If you use
38 .BR smtp ,
39 this will enable a direct SMTP (simple mail transport
40 protocol) interface in
41 .BR nmh .
42 When sending mail, instead of passing the
43 message to the mail transport agent,
44 .B post
45 will open a socket connection
46 to the mail port on the machine specified in the
47 .B servers
48 entry.
49 .PP
50 If you use
51 .BR sendmail ,
52 then
53 .B post
54 will send messages by forking a
55 local copy of
56 .BR sendmail .
57 Currently it will still speak SMTP with this local
58 copy of
59 .BR sendmail .
60 .RE
61 .PP
62 .BR localname :
63 .RS 5
64 The hostname
65 .B nmh
66 considers local.  It should typically be a fully
67 qualified hostname.  If this is not set, depending on the version of
68 UNIX you're running,
69 .B nmh
70 will query the system for this value
71 (e.g. uname, gethostname, etc.), and attempt to fully qualify this
72 value.
73 .PP
74 If you are using POP to retrieve new messages, you may want to set this
75 value to the name of the POP server, so that outgoing message appear to
76 have originated on the POP server.
77 .RE
78 .PP
79 .BR localdomain :
80 .RS 5
81 If this is set, a `.' followed by this string will be appended to your
82 hostname.
83 .PP
84 This should only be needed, if for some reason
85 .B nmh
86 is not able to
87 fully qualify the hostname returned by the system (e.g. uname,
88 gethostname, etc.).
89 .RE
90 .PP
91 .BR clientname :
92 .RS 5
93 This option specifies the host name that
94 .B nmh
95 will give in the
96 SMTP
97 .B HELO
98 (and
99 .BR EHLO )
100 command, when posting mail.  If not
101 set, the default is to use the host name that
102 .B nmh
103 considers local
104 (see
105 .B localname
106 above).  If this option is set, but empty, no
107 .B HELO
108 command will be given.
109 .PP
110 Although the
111 .B HELO
112 command is required by RFC\-821, many SMTP servers
113 do not require it.  Early versions of
114 .I SendMail
115 will fail if the hostname
116 given in the
117 .B HELO
118 command is the local host.  Later versions of
119 .I SendMail
120 will complain if you omit the
121 .B HELO
122 command.  If you run
123 .IR SendMail ,
124 find out what your system expects and set this field if needed.
125 .RE
126 .PP
127 .BR systemname :
128 .RS 5
129 This option is only used for UUCP mail.  It specifies the name of the
130 local host in the UUCP \*(lqdomain\*(rq.  If not set, depending
131 on the version of UNIX you're running,
132 .B nmh
133 will query the system
134 for this value.  This has no equivalent in the
135 .B nmh
136 configuration
137 file.
138 .RE
139 .PP
140 .BR mmdfldir :
141 %mailspool%
142 .RS 5
143 The directory where maildrops are kept.  If this option is set, but empty,
144 the user's home directory is used.  This overrides the default value
145 chosen at the time of compilation.
146 .RE
147 .PP
148 .BR mmdflfil :
149 .RS 5
150 The name of the maildrop file in the directory where maildrops are kept.
151 If this is empty, the user's login name is used.  This overrides the default
152 value (which is empty).
153 .RE
154 .PP
155 .BR mmdelim1 :
156 \&\\001\\001\\001\\001\\n
157 .RS 5
158 The beginning-of-message delimiter for maildrops.
159 .RE
160 .PP
161 .BR mmdelim2 :
162 \&\\001\\001\\001\\001\\n
163 .RS 5
164 The end-of-message delimiter for maildrops.
165 .RE
166 .PP
167 .BR maildelivery :
168 %libdir%/maildelivery
169 .RS 5
170 The name of the system-wide default
171 .I maildelivery
172 file.
173 See
174 .BR slocal (1)
175 for the details.
176 .RE
177 .PP
178 .BR everyone :
179 200
180 .RS 5
181 The highest user-id which should NOT receive mail addressed to
182 \*(lqeveryone\*(rq.
183 .RE
184 .PP
185 .BR noshell :
186 .RS 5
187 If set, then each user-id greater than \*(lqeveryone\*(rq that has a
188 login shell equivalent to the given value (e.g., \*(lq/bin/csh\*(rq)
189 indicates that mail for \*(lqeveryone\*(rq should not be sent to them.
190 This is useful for handling admin, dummy, and guest logins.
191 .RE
192 .SS "SMTP support"
193 These options are only available if you set
194 .B mts
195 to
196 .BR smtp .
197 .PP
198 .BR hostable :
199 %etcdir%/hosts
200 .RS 5
201 The exceptions file for /etc/hosts used by
202 .B post
203 to try to find
204 official names.  The format of this file is quite simple:
205 .PP
206 .IP 1. 4
207 Comments are surrounded by sharp (`#') and newline.
208 .IP 2. 4
209 Words are surrounded by white space.
210 .IP 3. 4
211 The first word on the line is the official name of a host.
212 .IP 4. 4
213 All words following the official names are aliases for that host.
214 .RE
215 .PP
216 .BR servers :
217 localhost
218 .RS 5
219 A lists of hosts and networks which to look for SMTP servers when
220 posting local mail.  It turns out this is a major win for hosts which
221 don't run an message transport system.  The value of
222 .B servers
223 should be one or more items.  Each item is the name of a host which
224 is (hopefully) running a SMTP server.
225 .SS "SendMail"
226 This option is only available if you set
227 .B mts
228 to
229 .BR sendmail .
230 .PP
231 .BR sendmail :
232 %sendmailpath%
233 .RS 5
234 The pathname to the
235 .B sendmail
236 program.
237 .RE
238 .SS "Post Office Protocol"
239 This option is only available if you have compiled
240 .B nmh
241 with POP support enabled (i.e., \*(lq--enable-pop\*(rq).
242 .PP
243 .BR pophost :
244 .RS 5
245 The name of the default POP service host.  If this is not set, then
246 .B nmh
247 looks in the standard maildrop areas for waiting mail, otherwise
248 the named POP service host is consulted.
249 .RE
250 \"  .SS "BBoards Delivery"
251 \"  This option is only available if you compiled \fInmh\fP with
252 \"  \*(lqbbdelivery:\ on\*(rq.
253 \"  .PP
254 \"  .BR bbdomain :
255 \"  .RS 5
256 \"  The local BBoards domain (a UCI hack).
257 \"  .RE
258
259 \"  .SS "BBoards & The POP"
260 \"  These options are only available if you compiled \fInmh\fP with
261 \"  \*(lqbboards:\ pop\*(rq and \*(lqpop:\ on\*(rq.
262
263 \"  .PP
264 \"  .BR popbbhost :
265 \"  .RS 5
266 \"  The POP service host which also acts as a BBoard server.  This variable
267 \"  should be set on the POP BBoards client host.
268 \"  .RE
269 \"  .PP
270 \"  .BR popbbuser :
271 \"  .RS 5
272 \"  The guest account on the POP/BB service host.  This should be a different
273 \"  login ID than either the POP user or the BBoards user.  (The user-id
274 \"  \*(lqftp\*(rq is highly recommended.)  This variable should be set on
275 \"  both the POP BBoards client and service hosts.
276 \"  .RE
277 \"  .PP
278 \"  .BR popbblist :
279 \"  %etcdir%/hosts.popbb
280 \"  .RS 5
281 \"  A file containing of lists of hosts that are allowed to use the POP
282 \"  facility to access BBoards using the guest account.  If this file is not
283 \"  present, then no check is made.  This variable should be set on the POP
284 \"  BBoards service host.
285 \"  .RE
286
287 .SS "File Locking"
288 A few words on locking:
289 .B nmh
290 has several methods for creating locks
291 on files.  When configuring
292 .BR nmh ,
293 you will need to decide on the
294 locking style and locking directory (if any).  The first controls the
295 method of locking, the second says where lock files should be created.
296 .PP
297 To configure
298 .B nmh
299 for kernel locking, use the \*(lq--with-locking=flock\*(rq configure option if
300 you want to use the
301 .B flock
302 system call; use \*(lq--with-locking=lockf\*(rq if
303 you want to use the
304 .B lockf
305 system call; or use \*(lq--with-locking=fcntl\*(rq
306 if you want to use the
307 .B fcntl
308 system call for kernel-level locking.
309 .PP
310 Instead of kernel locking, you can configure
311 .B nmh
312 to use dot locking by using \*(lq--with-locking=dot\*(rq.  Dot locking
313 specifies that
314 a file should be created whose existence means \*(lqlocked\*(rq and
315 whose non-existence means \*(lqunlocked\*(rq.  The name of this file is
316 constructed by appending \*(lq.lock\*(rq to the name of the file being
317 locked.  If \*(lq--enable-lockdir=directory\*(rq
318 is not specified at build time, lock files will be created
319 in the directory where the file being locked resides.  Otherwise, lock
320 files will be created in the directory specified by
321 \*(lq--enable-lockdir\*(rq.
322 .PP
323 Prior to installing
324 .BR nmh ,
325 you should see how locking is done at
326 your site, and set the appropriate values.
327
328 .SH FILES
329 .fc ^ ~
330 .nf
331 .ta \w'%etcdir%/ExtraBigFileName  'u
332 ^%etcdir%/mts.conf~^nmh mts configuration file
333 .fi
334
335 .SH "PROFILE COMPONENTS"
336 None
337
338 .SH "SEE ALSO"
339 mh\-mts(8), post(8)
340
341 .SH DEFAULTS
342 As listed above