git.marmaro.de Git - mmh/blob - man/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