Removed the last masquerading type: username_extension.
[mmh] / man / mh-tailor.man5
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 post ,
21 .BR rcvdist ,
22 and
23 .BR rcvpack .
24 .PP
25 Each option should be given on a single line.  Blank lines and lines
26 which begin with `#' are ignored.  The options available along with
27 default values and a description of their meanings are listed below:
28 .PP
29 .B spost
30 will send messages by forking a
31 local copy of
32 .BR sendmail .
33 .PP
34 When a user explicitly specifies a \*(lqFrom:\*(rq header in a draft,
35 .B nmh
36 uses it
37 rather than constructing its own.  However, to discourage email forgery, the
38 SMTP envelope \*(lqFrom:\*(rq and a \*(lqSender:\*(rq header are set to the user's real address.
39 .RE
40 .PP
41 .BR maildelivery :
42 %libdir%/maildelivery
43 .RS 5
44 The name of the system-wide default
45 .I maildelivery
46 file.
47 See
48 .BR slocal (1)
49 for the details.
50 .SS "File Locking"
51 A few words on locking:
52 .B nmh
53 has several methods for creating locks
54 on files.  When configuring
55 .BR nmh ,
56 you will need to decide on the
57 locking style and locking directory (if any).  The first controls the
58 method of locking, the second says where lock files should be created.
59 .PP
60 To configure
61 .B nmh
62 for kernel locking, use the \*(lq--with-locking=flock\*(rq configure option if
63 you want to use the
64 .B flock
65 system call; use \*(lq--with-locking=lockf\*(rq if
66 you want to use the
67 .B lockf
68 system call; or use \*(lq--with-locking=fcntl\*(rq
69 if you want to use the
70 .B fcntl
71 system call for kernel-level locking.
72 .PP
73 Instead of kernel locking, you can configure
74 .B nmh
75 to use dot locking by using \*(lq--with-locking=dot\*(rq.  Dot locking
76 specifies that
77 a file should be created whose existence means \*(lqlocked\*(rq and
78 whose non-existence means \*(lqunlocked\*(rq.  The name of this file is
79 constructed by appending \*(lq.lock\*(rq to the name of the file being
80 locked.  If
81 .B LOCKDIR
82 is not specified, lock files will be created
83 in the directory where the file being locked resides.  Otherwise, lock
84 files will be created in the directory specified by
85 .BR LOCKDIR .
86 .PP
87 Prior to installing
88 .BR nmh ,
89 you should see how locking is done at
90 your site, and set the appropriate values.
91
92 .SH FILES
93 .fc ^ ~
94 .nf
95 .ta \w'%etcdir%/ExtraBigFileName  'u
96 ^%etcdir%/mts.conf~^nmh mts configuration file
97 .fi
98
99 .SH "PROFILE COMPONENTS"
100 None
101
102 .SH "SEE ALSO"
103 mh\-mts(8), post(8)
104
105 .SH DEFAULTS
106 As listed above