mhbuild -check would always fail because it tried to build the
[mmh] / docs / historical / mh-6.8.5 / READ-ME
1
2
3
4 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
5
6
7
8 NAME
9      mh-gen - generating the MH system
10
11 READ THIS
12      This documentation describes how to configure, generate, and
13      install the UCI version of the RAND _\bM_\bH system.  Be certain
14      to read this document completely before you begin.  You
15      probably will also want to familiarize yourself with the _\bM_\bH
16      Administrator's Guide before you install _\bM_\bH.  A copy can be
17      found in the file doc/ADMIN.doc is the _\bM_\bH sources.
18
19 DISCLAIMER
20      Although the _\bM_\bH system was originally developed by the RAND
21      Corporation, and is now in the public domain, the RAND Cor-
22      poration assumes no responsibility for _\bM_\bH or this particular
23      modification of _\bM_\bH.
24
25      In addition, the Regents of the University of California
26      issue the following disclaimer in regard to the UCI version
27      of _\bM_\bH:
28           "Although each program has been tested by its contribu-
29           tor, no warranty, express or implied, is made by the
30           contributor or the University of California, as to the
31           accuracy and functioning of the program and related
32           program material, nor shall the fact of distribution
33           constitute any such warranty, and no responsibility is
34           assumed by the contributor or the University of Cali-
35           fornia in connection herewith."
36
37      This version of _\bM_\bH is in the public domain, and as such,
38      there are no real restrictions on its use.  The _\bM_\bH source
39      code and documentation have no licensing restrictions what-
40      soever.  As a courtesy, the authors ask only that you pro-
41      vide appropriate credit to the RAND Corporation and the
42      University of California for having developed the software.
43
44 GETTING HELP
45      _\bM_\bH is a software package that is neither supported by the
46      RAND Corporation nor the University of California.  However,
47      since we do use the software ourselves and plan to continue
48      using (and improving) _\bM_\bH, bug reports and their associated
49      fixes should be reported back to us so that we may include
50      them in future releases.  The current computer mailbox for
51      _\bM_\bH is Bug-MH@ICS.UCI.EDU.  Current information about MH can
52      be obtained from the MH Home Page on the World Wide Web at
53      http://www.ics.uci.edu/~mh.
54
55      Presently, there are two Internet discussion groups,
56      MH-Users@ICS.UCI.EDU and MH-Workers@ICS.UCI.EDU.  MH-Workers
57      is for people discussing code changes to _\bM_\bH.  MH-Users is
58      for general discussion about how to use _\bM_\bH.  MH-Users is
59      bi-directionally gatewayed into USENET as comp.mail.mh.
60
61
62
63 [mh.6]                Last change: MH.6.8.4                     1
64
65
66
67
68
69
70 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
71
72
73
74 HOW TO GET MH
75      Since you probably already have _\bM_\bH, you may not need to read
76      this unless you suspect you have an old version.  There are
77      two ways to get the latest release:
78
79      1.  If you can FTP to the ARPA Internet, use anonymous FTP
80      to ftp.ics.uci.edu and retrieve the file pub/mh/mh-
81      6.8.tar.Z.  This is a tar image after being run through the
82      compress program (approximately 1.8MB).  There should also
83      be a README file in that directory which tells what the
84      current release of _\bM_\bH is, and how to get updates.
85
86      You may also find MH on various other hosts; to make sure
87      you get the latest version and don't waste your time re-
88      fixing bugs, it's best to get it from either ftp.ics.uci.edu
89      or a site that mirrors ftp.ics.uci.edu.
90
91      2.  You can send $75 US to the address below.  This covers
92      the cost of a 6250 BPI 9-track magtape, handling, and ship-
93      ping.  In addition, you'll get a laser-printed hard-copy of
94      the entire MH documentation set.  Be sure to include your
95      USPS address with your check.  Checks must be drawn on U.S.
96      funds and should be made payable to:
97
98                Regents of the University of California
99
100      The distribution address is:
101
102                Attn: MH distribution
103                Office of Academic Computing
104                Univeristy of California at Irvine
105                Irvine, CA  92717-2225  USA
106
107                +1 714 824 5153
108
109      Sadly, if you just want the hard-copies of the documenta-
110      tion, you still have to pay the $75.  The tar image has the
111      documentation source (the manual is in roff format, but the
112      rest are in TeX format).  Postscript formatted versions of
113      the TeX papers are available, as are crude tty-conversions
114      of those papers.
115
116 SYNOPSIS
117      MAKE
118
119 DESCRIPTION
120      This is a description of how one can bring up an _\bM_\bH system.
121      It is assumed that you have super-user privileges in order
122      to (re-)install _\bM_\bH.  Super-user privileges are not required
123      to configure or generate _\bM_\bH.
124
125
126
127
128
129 [mh.6]                Last change: MH.6.8.4                     2
130
131
132
133
134
135
136 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
137
138
139
140      Become the super-user and cd to /usr/src/local/ (or whatever
141      you keep your local sources).  The distribution tape con-
142      tains the hierarchy for the mh.6-8/ directory.  Bring the
143      sources on-line:
144
145      # cd /usr/src/local
146      % tar xv
147      % cd mh-6.8
148
149 CONFIGURATION
150      First, go to the conf/ directory.
151
152      % cd conf/
153
154      This directory contains files that will produce source files
155      tailored for your choice of _\bM_\bH configuration.  You should
156      edit only the file MH.  This file contains configuration
157      directives.  These configuration directives are read by the
158      _\bm_\bh_\bc_\bo_\bn_\bf_\bi_\bg program to produce customized files.
159
160      For examples of various configurations, look in the direc-
161      tory conf/examples/.  The file MH provided in conf/ is a
162      reasonable default.  Lines beginning with `#' are comments,
163      and are not otherwise interpreted.
164
165      Here are the _\bM_\bH configuration directives available.  Be sure
166      to read through this list completely before attempting to
167      decide what directives are appropriate for your system.
168
169      More information on some of these options is available in
170      the the _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be.  If you do not have a printed
171      copy, you should configure your system with the default con-
172      figuration file, MH, then generate and print a copy of the
173      guide (as described below).
174
175   Installation paths
176      bin: /usr/local
177           The directory where user-invoked programs go (see
178           manual section 1).
179
180      etc: /usr/local/lib/mh
181           The directory where pgm-invoked programs go (see manual
182           section 8).
183
184      mail: /usr/spool/mail
185           The directory where the maildrops are stored.  If this
186           pathname is absolute (i.e., begins with a / ), then the
187           user's maildrop is a file called $USER in this direc-
188           tory.  If the pathname is not absolute, then the user's
189           maildrop is in the user's home directory under the
190           given name.
191
192
193
194
195 [mh.6]                Last change: MH.6.8.4                     3
196
197
198
199
200
201
202 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
203
204
205
206      mandir: /usr/man
207           The parent directory of the manual entries.
208
209      manuals: standard
210           Where manual entries should be installed, relative to
211           the directory given with "mandir".  Either "local" to
212           install manual entries under manl/, or "new" to install
213           manual entries under mann/, or "old" to install manual
214           entries under mano/, or "standard" to install manual
215           entries under man?/, or "bsd44" to install manual
216           entries as man?/_\bp_\ba_\bg_\be.0, or "gen" to generate but not
217           install them, or "none" to neither generate nor install
218           them.
219
220           Any of these values may have the suffix "/cat" appended
221           to it.   In that case, the manual entries will be for-
222           matted with "nroff -man" and they will be installed in
223           the corresponding "cat?" directories.
224
225           For example, to install manual entries under
226           /usr/man/u_man/man?, use "standard" and /usr/man/u_man
227           for "mandir".  To install formatted manual entires
228           under /usr/contrib/man/cat?, use "standard/cat" and
229           /usr/contrib/man for "mandir".  To install formatted
230           manual entries using the BSD44 convention, use
231           "bsd44/cat".
232
233      chown: /etc/chown
234           The location of the _\bc_\bh_\bo_\bw_\bn(8) on your system.  If _\bc_\bh_\bo_\bw_\bn
235           is in your search path, just use the value of "chown".
236           On SYS5 systems, this should probably be "/bin/chown".
237
238      cp: cp
239           The command to copy files when installing, if not "cp".
240           (Some sites use "cp -p".)
241
242      ln: ln
243           The command to link files together in the source tree,
244           if not "ln".  If you're using something like lndir to
245           keep your compile tree separate from your source tree,
246           set this to "ln -s" or "cp".
247
248      remove: mv -f
249           How _\bM_\bH should make backup copies of existing files when
250           installing new files.  To simply remove the old files,
251           use "rm -f".
252
253   Compiler/loader
254      cc: cc
255           The name of your C compiler, if not "cc".
256
257      ccoptions: -O
258
259
260
261 [mh.6]                Last change: MH.6.8.4                     4
262
263
264
265
266
267
268 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
269
270
271
272           Options given directly to _\bc_\bc(1).  The most common is
273           "-M" if you're running _\bM_\bH on an ALTOS.  This defaults
274           to "-O".  If you define this and want to keep "-O", be
275           sure to include it explicitly.  If you're using the _\bG_\bN_\bU
276           C compiler, it should include `-traditional'.  See
277           "options:" for `-D' options.
278
279      curses: -lcurses -ltermlib
280           This should be the loader option required to load the
281           _\bt_\be_\br_\bm_\bc_\ba_\bp(3) and _\bc_\bu_\br_\bs_\be_\bs(3) libraries on your system.  On
282           SYS5 systems, it probably should be just "-lcurses".
283           Some sites have reported that both "-lcurses" and
284           "-ltermlib" are necessary.
285
286      ldoptions: -s
287           Options given directly to _\bl_\bd(1) (via _\bc_\bc) at the begin-
288           ning of the command line.  Useful for machines which
289           require arguments to tell _\bl_\bd to increase the stack
290           space (e.g. the Gould, which uses "-m 8").  Usually,
291           "-s" is a good choice in any event.
292
293      ldoptlibs:
294           Options given directly to _\bl_\bd(1) (via _\bc_\bc) at the end of
295           the command line.  The two most common are: "-ldbm" if
296           you're running MMDF with the _\bd_\bb_\bm package; and, "-lndir"
297           if you are generating _\bM_\bH on a system which does not
298           load the new directory access mechanism by default
299           (e.g., 4.1BSD, SYS5).  If you don't have _\bl_\bi_\bb_\bn_\bd_\bi_\br on
300           your system, the sources are in miscellany/libndir/.
301
302      lex: lex -nt
303           Alternative version of _\bl_\be_\bx.  Used in zotnet/tws/.
304
305      oldload: off
306           This controls how _\bM_\bH will try to process library object
307           files to eliminate local symbols.  Support for the
308           ALTOS loader if "on".  Support for loaders not handling
309           `-x -r' correctly if "none".
310
311      ranlib: on
312           Support for systems with _\br_\ba_\bn_\bl_\bi_\bb(1).  For SYSTEM 5 sys-
313           tems, this should be "off" which tells _\bM_\bH to use _\bl_\bo_\br_\bd_\be_\br
314           and _\bt_\bs_\bo_\br_\bt instead.  Some SYSTEM 5 sites reported that
315           running this isn't always sufficient.  If this is the
316           case, then you should edit conf/makefiles/uip to
317           include ../sbr/libmh.a and ../zotnet/libzot.a twice in
318           the LIBES variable.
319
320   Message Transport System
321      mts: sendmail
322           Which message transport system to use.  Either "mmdf"
323           to use _\bM_\bM_\bD_\bF as the transport system, "mmdf2" to use
324
325
326
327 [mh.6]                Last change: MH.6.8.4                     5
328
329
330
331
332
333
334 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
335
336
337
338           _\bM_\bM_\bD_\bF-_\bI_\bI as the transport system, "sendmail" to have
339           _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl as the transport system, "zmailer" to have
340           _\bZ_\bM_\bA_\bI_\bL_\bE_\bR as the transport system, or, "mh" to have _\bM_\bH as
341           the transport system.
342
343           On UNIX systems supporting TCP/IP networking via sock-
344           ets you can add the suffix "/smtp" to the mts setting.
345           This often yields a superior interface as _\bM_\bH will post
346           mail with the local _\bS_\bM_\bT_\bP server instead of interacting
347           directly with _\bM_\bM_\bD_\bF or _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl.  Hence, for TCP/IP UNIX
348           systems, the "/smtp" suffix to either "sendmail" or
349           "mmdf2" is the preferred MTS configuration.  The
350           "/smtp" suffix is described in detail in the
351           _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be; be sure to set "servers:" as
352           described in _\bm_\bh-_\bt_\ba_\bi_\bl_\bo_\br(8) if you use this option.
353
354      mf: off
355           Support for mail filtering on those systems in which
356           the message transport system isn't integrated with _\bU_\bU_\bC_\bP
357           This option is strictly for an _\bM_\bH system using either
358           _\bM_\bM_\bD_\bF-_\bI as its transport system or one using
359           "stand-alone delivery".
360
361   UCI BBoards Facility
362      bboards: off
363           If "on", include support for the UCI BBoards facility.
364           BBoards may be enabled with any mts setting.  If "off",
365           the BBoard reading program _\bb_\bb_\bc will not be installed.
366           If "nntp", include support for the UCI BBoards facility
367           to read the Network News via the NNTP.  If "pop" (form-
368           erly "popbboards: on"), include support for the UCI
369           BBoards facility via the POP3 service; this setting
370           requires "pop: on".
371
372      bbdelivery: off
373           If "off", the BBoards delivery agent and library files
374           will not be installed.  If "on", and you set "bboards:"
375           to something besides "off", then the BBoards delivery
376           agent and library files will be installed in the _\bb_\bb_\bh_\bo_\bm_\be
377           directory (see below).  To read remote BBoards, the
378           usual configuration would have _\bb_\bb_\bc talk to a _\bP_\bO_\bP_\b3 or
379           _\bN_\bN_\bT_\bP server.  However, it may be useful to set this to
380           "off" if you NFS mount the _\bb_\bb_\bh_\bo_\bm_\be directory from
381           another host and want to use _\bb_\bb_\bc to read those files
382           directly.
383
384      bbhome: /usr/spool/bboards
385           The home directory for the BBoards user.
386
387
388
389
390
391
392
393 [mh.6]                Last change: MH.6.8.4                     6
394
395
396
397
398
399
400 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
401
402
403
404   Post Office Protocol
405      pop: off
406           Support for POP service.  This allows local delivery
407           for non-local users (a major win).  See
408           support/pop/pop.rfc for more information on the POP.
409           This option currently works only on UNIX systems with
410           TCP/IP sockets.  (It doesn't hurt to enable this option
411           regardless of whether or not you intend to use POP.)
412           See also "bboards: pop" to enable reading bboards with
413           the POP.
414
415      popdir: /usr/etc
416           The directory where the POP daemon (popd) will be
417           installed.
418
419      options:
420           `-D' options to _\bc_\bc(1).
421
422        APOP='"/etc/pop.auth"'
423             This option indicates that the POP daemon will sup-
424             port the non-standard APOP command, and specifies the
425             name of APOP authorization database.  The APOP com-
426             mand provides a challenge-based authentication system
427             using the MD5 message digest algorithm.  This facil-
428             ity is documented in _\bT_\bh_\be _\bI_\bn_\bt_\be_\br_\bn_\be_\bt _\bM_\be_\bs_\bs_\ba_\bg_\be (ISBN
429             0-13-092941-7), a book by Marshall T. Rose.
430
431             This option also causes the popauth program to be
432             installed, which allows the administrator to manipu-
433             late the APOP authorization database.  For more
434             details, see support/pop/pop-more.txt and the
435             _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be.
436
437        DPOP
438             This option indicates that POP subscribers do not
439             have entries in the _\bp_\ba_\bs_\bs_\bw_\bd(5) file, and instead have
440             their own separate database (a win).
441
442        KPOP
443             Support for KERBEROS with POP.  This code builds
444             _\bp_\bo_\bp_\bd, _\bi_\bn_\bc and _\bm_\bs_\bg_\bc_\bh_\bk to support only the "kpop" pro-
445             tocol.  This code is still experimental, but is
446             available for those sites wishing to test it.
447
448        MPOP
449             This option indicates that the POP daemon will sup-
450             port the non-standard XTND SCAN command which pro-
451             vides performance enhancements when using the POP
452             over low-speed connections.  This option also causes
453             an interactive POP client program, popi, to be com-
454             piled and installed.  A man page for the popi program
455             is also provided.
456
457
458
459 [mh.6]                Last change: MH.6.8.4                     7
460
461
462
463
464
465
466 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
467
468
469
470             These extensions are described in _\bT_\bh_\be _\bI_\bn_\bt_\be_\br_\bn_\be_\bt _\bM_\be_\bs_\b-
471             _\bs_\ba_\bg_\be, a book by Marshall T. Rose.  For more details,
472             see support/pop/pop-more.txt.  Note: this option
473             requires "bboards: pop".
474
475        POP2
476             Have the POP daemon understand the older POP2 proto-
477             col as well as the _\bM_\bH POP3 protocol - a major win.
478             The POP daemon auto-magically determines which POP
479             protocol your client is using.  If you're enabling
480             POP service, there's no reason not to enable this
481             option as well.  See also _\bP_\bO_\bP_\bS_\bE_\bR_\bV_\bI_\bC_\bE.
482
483        POPSERVICE
484             The port name the _\bM_\bH POP will use.  For historical
485             reasons, this defaults to "pop".
486
487             In 1987, the _\bM_\bH POP protocol (POP version 3) was pub-
488             lished as RFC1081 and was assigned its own port
489             number (110), which differs from the original POP
490             (version 1 and 2) port number (109).
491
492             To have _\bM_\bH POP use the new assigned port number, set
493             POPSERVICE='"pop3"', and be sure that this service
494             name is listed in your /etc/services file on both POP
495             client and server hosts as "110/tcp".  If you enable
496             _\bP_\bO_\bP_\b2, you can safely leave _\bP_\bO_\bP_\bS_\bE_\bR_\bV_\bI_\bC_\bE undefined
497             unless you are using POP3 clients besides _\bM_\bH.
498
499        RPOP
500             This option indicates that support for the UNIX vari-
501             ant of POP, RPOP, which uses privileged sockets for
502             authentication be enabled.  This peacefully co-exists
503             with the standard POP.
504
505        SHADOW
506             Indicates that the popd POP server can find encrypted
507             passwords in the /etc/shadow file (and not in the
508             /etc/passwd file).  It should be used only for some
509             (newer) SYSTEM 5 systems.
510
511          The "APOP" and "MPOP" non-standard POP facilities are
512          documented in _\bT_\bh_\be _\bI_\bn_\bt_\be_\br_\bn_\be_\bt _\bM_\be_\bs_\bs_\ba_\bg_\be (ISBN 0-13-092941-7),
513          a book by Marshall T. Rose.  For more details, see
514          support/pop/pop-more.txt.  The "APOP" option peacefully
515          co-exists with the standard POP.  The "MPOP" option
516          requires "bboards: pop".
517
518  Shared libraries
519     sharedlib: off
520          If "sun4", makes libmh.a into a SunOS 4.0 (and later)
521          shared library.  If you enable this, be sure to also use
522
523
524
525 [mh.6]                Last change: MH.6.8.4                     8
526
527
528
529
530
531
532 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
533
534
535
536          "options SUN40".  If "sys5", makes libmh.a into a SYS5
537          R4 (and later) shared library.  If you enable this, be
538          sure to also use "options SVR4".
539
540     slflags: -pic
541          The compiler flags to produce position independent code.
542
543     slibdir: /usr/local/lib
544          The directory where the _\bM_\bH shared library should go.
545
546       Under SunOS (sun4)
547          Since some _\bM_\bH programs are setuid, they'll only look for
548          the library in "trusted" locations.  Putting the library
549          somewhere besides /usr/lib or /usr/local/lib is not
550          advisable.
551
552          If you must do this, be sure that you add the path given
553          by slibdir to the compiler's library search list (e.g.,
554          "ldoptions: -L/usr/mh/lib") and make sure the path
555          starts with a leading `/'.
556
557          You may need to run _\bl_\bd_\bc_\bo_\bn_\bf_\bi_\bg(8) manually whenever a new
558          shared object is installed on the system.  See _\bl_\bd(1) for
559          more information about using shared libraries.
560
561       Under Solaris 2.0 (and newer)
562          The above instructions for SunOS apply, except you
563          should set the run-time library search path using `-R'
564          instead of `-L' (e.g., "ldoptions: -R/usr/mh/lib").
565
566  General System Dependencies
567     You should include the following directives which are
568     appropriate for your version of UNIX.  If you don't know what
569     an option does, it probably doesn't apply to you.
570
571     mailgroup: off
572          If set, _\bi_\bn_\bc is made set-group-id to this group name.
573          Some SYS5 systems want this to be set to "mail".  Set
574          this if your /usr/spool/mail is not world-writeable.
575
576          Note that slocal doesn't know how to deal with this, and
577          will not work under these systems; just making it set-
578          group-id will open a security hole.  If you're using
579          "mailgroup", you should remove slocal (and its man page)
580          from your system.
581
582     signal: int
583          The base type (int or void) of the function
584          parameter/return value of _\bs_\bi_\bg_\bn_\ba_\bl(2).  The default is
585          int.  Set "signal void" on systems which use this type
586          (e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and later).
587
588
589
590
591 [mh.6]                Last change: MH.6.8.4                     9
592
593
594
595
596
597
598 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
599
600
601
602     sprintf: char *
603          The return value of the _\bs_\bp_\br_\bi_\bn_\bt_\bf library routine.  This
604          defaults to "char *".  Set this to "int" if you have an
605          older version of SYSTEM 5 which has this routine return
606          an "int" type.
607
608     options:
609          `-D' options to _\bc_\bc(1).
610
611       ALTOS
612            Use on XENIX/v7 systems.  Also, be sure to use
613            "options V7".
614
615       ATTVIBUG
616            This option causes _\bM_\bH to return to the "What now?"
617            prompt if your initial editor is vi and it exits with
618            non-zero status.  Use on Sun OS 4.1 and other systems
619            where the /usr/ucb/vi editor was changed to exit with
620            its status equal to the number of pseudo-"errors"
621            encountered during the edit.  This causes a problem
622            for programs that test the exit status of their editor
623            and abort if the status is non-zero.  (This includes
624            _\bM_\bH and programs like /usr/etc/vipw).
625
626       AUX
627            Use with AUX systems.
628
629       BIND
630            If you are running with the BIND code on UNIX systems
631            with TCP/IP sockets (e.g. 4.{2,3}BSD), be sure to
632            define this.
633
634       BSD41A
635            Use on 4.1a Berkeley UNIX systems.
636
637       BSD42
638            Use on Berkeley UNIX systems on or after 4.2BSD.
639
640       BSD43
641            Use on 4.3 Berkeley UNIX systems.  Also, be sure to
642            use "options BSD42".  If _\bo_\bp_\be_\bn_\bl_\bo_\bg(3) (see "man 3 sys-
643            log") takes three arguments instead of two, and your
644            _\bw_\br_\bi_\bt_\be(1) command is set-group-id to group "tty", use
645            this option.  If only one of these conditions is true,
646            you lose.
647
648       BSD44
649            Use on Berkeley UNIX systems on or after 4.4BSD.
650            Also, be sure to use "options BSD43" and "options
651            BSD42".
652
653       DBMPWD
654
655
656
657 [mh.6]                Last change: MH.6.8.4                    10
658
659
660
661
662
663
664 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
665
666
667
668            Use this option if your _\bg_\be_\bt_\bp_\bw_\be_\bn_\bt(3) routines read a
669            dbm database (such as with Yellow Pages) instead of
670            doing a sequential read of /etc/passwd.  Without
671            DBMPWD the entire passwd file is read into memory one
672            entry at a time for alias expansion.  This is a per-
673            formance improvement when reading a standard
674            /etc/passwd file, but is _\bv_\be_\br_\by slow on systems with a
675            dbm database.  At one site that runs YP on a large
676            passwd file, it showed a 6:1 performance improvement.
677
678       GCOS_HACK
679            The so-called "gcos" field of the password file is
680            used as a last resort to find the user's full name
681            (see _\bm_\bh-_\bp_\br_\bo_\bf_\bi_\bl_\be(5) for details).  Enable this option
682            if your _\bp_\ba_\bs_\bs_\bw_\bd(5) man page notes that the `&' charac-
683            ter in the "gcos" field stands for the login name.
684
685       FCNTL
686            Directs _\bM_\bH to use the fcntl() system call for kernel-
687            level locking.  If you're using a SYS5 system, you may
688            want this option.  (See also `FLOCK' and `LOCKF').
689
690       FLOCK
691            Directs _\bM_\bH to use the flock() system call for kernel-
692            level locking.  If you're on a BSD42 system, and
693            you're not using NFS to read or write maildrops, you
694            should enable this option.  (See also `FCNTL' and
695            `LOCKF').
696
697       HESIOD
698            Support for HESIOD. This code was contributed, and
699            included no documentation.
700
701       LOCKF
702            Directs _\bM_\bH to use the lockf() system call for kernel-
703            level locking.  If you're using NFS to read or write
704            maildrops, you should enable this option.  (See also
705            `FLOCK' and `FCNTL').
706
707       locname
708            Hard-wires the local name for the host _\bM_\bH is running
709            on.  For example, locname='"PICKLE"'.  It's probably
710            better to either let UNIX tell _\bM_\bH this information, or
711            to put the information in the host specific mtstailor
712            file.
713
714       MORE
715            Defines  the location of the _\bm_\bo_\br_\be(1) program.  On
716            ALTOS and DUAL systems, set MORE='"/usr/bin/more"'.
717            The default is "/usr/ucb/more".
718
719       NDIR
720
721
722
723 [mh.6]                Last change: MH.6.8.4                    11
724
725
726
727
728
729
730 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
731
732
733
734            For non-Berkeley UNIX systems, this _\bM_\bH will try to
735            find the new directory access mechanism by looking in
736            <ndir.h> if this option is given.  Otherwise, _\bM_\bH will
737            try <dir.h>.  If you still can't get this to work on
738            your system, edit h/local.h as appropriate.  (See also
739            `SYS5DIR'.)
740
741       NFS
742            Tells _\bM_\bH to hack around a problem in the NFS C
743            library.  If you get an undefined symbol "ruserpass"
744            when compiling _\bM_\bH, you probably need this option.  If,
745            however, you include this option and get an undefined
746            symbol "__ruserpass" when compiling, then you should
747            omit this option.  (See also `NORUSERPASS'.)
748
749       NOIOCTLH
750            Tells _\bM_\bH not to include the file <sys/ioctl.h>.  To be
751            used on systems where this file is not present.
752
753       NORUSERPASS
754            Tells _\bM_\bH that your system doesn't have the _\br_\bu_\bs_\be_\br_\b-
755            _\bp_\ba_\bs_\bs(3) routine; _\bM_\bH will include its own copy of this
756            routine in its library.  (See also `NFS'.)
757
758       NTOHLSWAP
759            Tells _\bM_\bH to use the ntohl() macro when processing _\bm_\bs_\bh
760            binary map files.  _\bM_\bH can use this macro on systems
761            with the include file netinet/in.h, to byte-swap the
762            binary information in these map files.  If you're
763            using the same map files on machines of different
764            architectures, enable this option.
765
766       RENAME
767            Include this option if your system has a rename()
768            library call.  This is true on BSD42 and newer and
769            some SYS5 systems.
770
771       SENDMAILBUG
772            Causes SMTP reply code 451 (failure) to be considered
773            the same as code 250 (OK).  Since this might cause
774            problems, only enable this if you are certain that
775            your SendMail will return this code even when it
776            doesn't mean to indicate a failure.
777
778       SOCKETS
779            Indicates the availability of a socket interface for
780            TCP/IP networking that is compatible with 4.{2,3}BSD
781            UNIX.  It is not necessary to define this when BSD42
782            is already defined, but it might be useful for SYSTEM
783            5 or HPUX systems with TCP/IP sockets.
784
785       SUN40
786
787
788
789 [mh.6]                Last change: MH.6.8.4                    12
790
791
792
793
794
795
796 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
797
798
799
800            Use on Sun OS 4.0 (and later?) systems.  You also will
801            need "options BSD42", "options BSD43", and "signal
802            void".
803
804            If you're using Sun's brain-damaged approach to offer-
805            ing Domain Name Service through NIS, be sure to
806            include "options BIND" and "ldoptions -lresolv" to
807            work around some NIS/DNS bugs.
808
809       SYS5
810            Use on AT&T SYSTEM 5 R3 (and newer?) UNIX systems.
811            See also _\bm_\ba_\bi_\bl_\bg_\br_\bo_\bu_\bp.
812
813       SYS5DIR
814            Define this if your system uses "struct dirent"
815            instead of "struct direct".  This is true of System V
816            Release 3.0 and later.  Uses include file <dirent.h>
817            and the routines _\bm_\bk_\bd_\bi_\br, _\br_\bm_\bd_\bi_\br and _\bg_\be_\bt_\bc_\bw_\bd.
818
819       SVR4
820            Use on AT&T SYSTEM 5 R4 (and newer?) UNIX systems. You
821            should also include "options SYS5" and "options
822            SYS5DIR".  See also _\bm_\ba_\bi_\bl_\bg_\br_\bo_\bu_\bp.  You will also need to
823            include "oldload none" if your ld doesn't handle
824            `-x -r' correctly.
825
826       TERMINFO
827            Define TERMINFO if you have it.  You get it automati-
828            cally if you're running SYS5, and you don't get it if
829            you're not.  (If you're not SYS5, you probably have
830            termcap.)
831
832       TZNAME
833            Use time zone names from the _\bt_\bz_\bn_\ba_\bm_\be variable, set via
834            _\bt_\bz_\bs_\be_\bt.  Only applicable on SYSTEM 5 systems and only
835            effective when you have asked for alpha-timezones (see
836            the ATZ option).  See also ZONEINFO.
837
838       UNISTD
839            Include this option if your system has the file
840            <unistd.h>.  If not specified, the LOCKF option will
841            include <sys/fcntl.h>.
842
843       V7
844            Use on V7 UNIX systems.  Also, be sure to use "options
845            void=int".
846
847       VSPRINTF
848            Include this option if your system has the _\bv_\bs_\bp_\br_\bi_\bn_\bt_\bf(3)
849            library routine; otherwise, __\bd_\bo_\bp_\br_\bn_\bt(3) will be used.
850
851       WAITINT
852
853
854
855 [mh.6]                Last change: MH.6.8.4                    13
856
857
858
859
860
861
862 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
863
864
865
866            BSD42 based systems call the _\bw_\ba_\bi_\bt(2) system routine
867            with a pointer to type _\bu_\bn_\bi_\bo_\bn _\bw_\ba_\bi_\bt.  Include this
868            option if you included "options BSD42", but your sys-
869            tem calls the _\bw_\ba_\bi_\bt(2) system routine with a pointer to
870            type _\bi_\bn_\bt (the non-BSD42 default).
871
872       ZONEINFO
873            Specify this if you have a BSD43 based system that
874            keeps time zone information /etc/zoneinfo or
875            /usr/lib/zoneinfo (SunOS), and where the _\bs_\bt_\br_\bu_\bc_\bt _\bt_\bm
876            returned by _\bl_\bo_\bc_\ba_\bl_\bt_\bi_\bm_\be(3) contains a _\bt_\bm__\bg_\bm_\bt_\bo_\bf_\bf element
877            (see /usr/include/time.h).  With this fix the GMT
878            offset specified in outgoing mail will be corrected
879            when the TZ enviornment variable is set to a different
880            time zone.  See also TZNAME.
881
882 Site Preferences
883    These options change the default behavior of _\bM_\bH or enable
884    optional features.  Add the options which are appropriate for
885    your configuration or your site preferences.
886
887    editor: prompter
888         The default editor for _\bM_\bH.
889
890    options:
891         `-D' options to _\bc_\bc(1).
892
893      ATZ
894           Directs _\bM_\bH to use alpha-timezones whenever possible.
895           You should not use this option if you are on the Inter-
896           net, since it will make your host non-compliant with
897           RFC-1123 (Requirements for Internet Hosts).
898
899      ATHENA
900           Makes _\br_\be_\bp_\bl `-nocc all' the default instead of
901           `-cc all'.  You may want to enable this if you're using
902           _\bx_\bm_\bh.
903
904      BANG
905           Directs _\bM_\bH to favor `!' over `@' in addressing.
906
907      BERK
908           Optional for for 4.{2,3}BSD sites running SendMail.
909           Disables nearly all of the RFC822 address and header-
910           parsing routines in favor of recognizing such formats
911           as ASCnet, and so on.  If you don't need to disable the
912           parser for this reason, you probably want to use
913           "options DUMB" instead.
914
915      COMPAT
916           If you previously ran a version of _\bM_\bH earlier than mh.4
917           use this option.  After a short grace period, remove it
918
919
920
921 [mh.6]                Last change: MH.6.8.4                    14
922
923
924
925
926
927
928 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
929
930
931
932           and re-{configure,generate,install} everything.
933
934      DUMB
935           Directs _\bM_\bH not to try and rewrite addresses to their
936           "official" form.
937
938      FOLDPROT
939           Defines the octal value for default folder-protection.
940           For example, FOLDPROT='"0700"'.  The default is "0711".
941
942      ISI
943           When using "repl -ccme", only "cc:" the first address
944           found which belongs to the user; any other _\bA_\bl_\bt_\be_\br_\bn_\ba_\bt_\be-
945           _\bM_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs do not receive "cc:"s.
946
947      LINK
948           Defines the filename for alternate file name for _\bd_\bi_\bs_\bt
949           and _\br_\be_\bp_\bl.  For example, LINK='"\\043"' to use the
950           pound-sign character.  The default is "@".
951
952      MHE
953           Enables crude support for Brien Reid's MHE interface.
954           Recommended for use with the GNU Emacs mh-e package.
955
956      MHRC
957           Enables _\bM_\bH to recognize the _\bC_\bS_\bh_\be_\bl_\bl's `~'-construct.
958           This is useful for sites that run with a ~/.mhrc for
959           their users.
960
961      MIME
962           Enables support for multi-media messages, as specified
963           in RFC 1341 -- a major win.  This allows you to include
964           things like audio, graphics, and the like, in your mail
965           messages.  Several _\bM_\bH commands are extended to support
966           these multi-media messages, and the _\bm_\bh_\bn command is pro-
967           vided to encode and decode MIME messages.  For more
968           details, see miscellany/multi-media/READ-ME and _\bm_\bh_\bn(1).
969
970      MSGID
971           Enables slocal to detect and surpress duplicate mes-
972           sages received.  This code uses the <ndbm.h> library,
973           and requires "options BSD42" since it uses the _\bf_\bl_\bo_\bc_\bk(2)
974           system call for locking.  (Note that this means its
975           database locking does not work over NFS.) It has only
976           been tested under SUN40.
977
978      MSGPROT
979           Defines the octal value for default folder-protection.
980           For example, MSGPROT='"0600"'.  The default is "0644".
981
982      NOMHSEQ
983           Directs _\bM_\bH to make private sequences the default.
984
985
986
987 [mh.6]                Last change: MH.6.8.4                    15
988
989
990
991
992
993
994 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
995
996
997
998      OVERHEAD
999           Enable _\bM_\bH commands to read profile/context from open
1000           fd:s without doing an open(); see _\bm_\bh-_\bp_\br_\bo_\bf_\bi_\bl_\be(5) for the
1001           details.
1002
1003      RPATHS
1004           Directs _\bi_\bn_\bc to note UNIX "From " lines as Return-Path:
1005           info.
1006
1007      SBACKUP
1008           Defines the prefix string for backup file names.  For
1009           example, SBACKUP='"\\043"'.  The default is ",".
1010
1011      TMA
1012           Support for the TTI _\bt_\br_\bu_\bs_\bt_\be_\bd _\bm_\ba_\bi_\bl _\ba_\bg_\be_\bn_\bt (TMA).  Although
1013           the TTI TMA is not in the public domain, the _\bM_\bH support
1014           for the TTI TMA is in the public domain.  You should
1015           enable this option only if you are licensed to run the
1016           TMA software (otherwise, you don't have the software in
1017           your _\bM_\bH source tree).
1018
1019      TTYD
1020           Support for TTYD.  This is no longer in wide use, and
1021           is not recommended.
1022
1023      UCI
1024           First, "_" and "#" are recognized as the prefixes for
1025           scratch files.  Second, support for the UCI
1026           group-leadership mechanism is enabled in _\bc_\bo_\bn_\bf_\bl_\bi_\bc_\bt.
1027           Third, the first line of the file file $HOME/.signature
1028           is used as the _\bF_\bu_\bl_\bl _\bN_\ba_\bm_\be part of your "From:" header.
1029           This may conflict with the interpretation of this file
1030           by _\bN_\be_\bw_\bs.  If you're not at UCI, you probably don't want
1031           this option.
1032
1033      UK
1034           Directs the _\bs_\bc_\ba_\bn program to generate UK-style dates by
1035           default.
1036
1037      WHATNOW
1038           Enable certain _\bM_\bH commands to act differently when
1039           $mhdraft set.
1040
1041      YEARMOD
1042           This option makes the _\bm_\bh-_\bf_\bo_\br_\bm_\ba_\bt %(year) function always
1043           return a value less than 100.  Enable this option if
1044           you have local _\bm_\bh-_\bf_\bo_\br_\bm_\ba_\bt(5) files which cannot handle
1045           4-digit years.  You should convert these files to use a
1046           4-character field width, or use the %(modulo 100) func-
1047           tion to obtain a 2-digit year value.  After a short
1048           grace period, remove `YEARMOD' and re-
1049           {configure,generate,install} everything.
1050
1051
1052
1053 [mh.6]                Last change: MH.6.8.4                    16
1054
1055
1056
1057
1058
1059
1060 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
1061
1062
1063
1064 Testing/debugging
1065   debug: off
1066        Support for debug mode of _\bM_\bH.  Don't use this unless you
1067        know what you're doing, which isn't likely if you're read-
1068        ing this document!
1069
1070   regtest: off
1071        Set this to "on" if you are doing regression testing among
1072        different compilations of _\bM_\bH, and you do not want the
1073        hostname and compile date included in _\bM_\bH binaries.
1074
1075
1076
1077      Now edit conf/config/mtstailor, depending on your choice of
1078      the setting for mts in the _\bM_\bH configuration file.  for an
1079      mts setting of "mh", look at the file conf/tailor/mhmts; for
1080      an mts setting of "sendmail", "sendmail/smtp", "mmdf/smtp",
1081      or "mmdf2/smtp", look at the file conf/tailor/sendmts; and,
1082      for an mts setting of "mmdf", or  "mmdf2", look at the file
1083      conf/tailor/mmdf.
1084
1085      Now install the configured files into the source areas.  (On
1086      SYS5 systems, or other systems where you get complaints
1087      about "_index" and "_rindex" being undefined, you should use
1088      "make sys5" to compile mhconfig.)
1089
1090      % make
1091      % ./mhconfig MH
1092
1093      Before proceeding, you should familiarize yourself with the
1094      _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be.  To generate an _\bn_\br_\bo_\bf_\bf version, go to
1095      the doc/ directory and type:
1096
1097      % (cd ../doc/; make ADMIN.doc)
1098
1099
1100      If you're already running _\bM_\bH at your site, you should also
1101      read the _\bm_\bh changes document CHANGES.  The source is in
1102      papers/changes/.
1103
1104      After reading the _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be, you may decide to
1105      change your MH configuration.  If so, cd back to the conf/
1106      directory, re-edit the files MH and conf/config/mtstailor,
1107      and re-run _\bm_\bh_\bc_\bo_\bn_\bf_\bi_\bg.
1108
1109      You now proceed based on your choice of a transport system
1110      (the setting for mts above).  The best interface is achieved
1111      with "sendmail" followed by "mmdf" or ("mmdf2"), and then
1112      "mh" (stand-alone delivery, not recommended).
1113
1114   SENDMAIL
1115      If you have not enabled BBoards or POP then no further
1116
1117
1118
1119 [mh.6]                Last change: MH.6.8.4                    17
1120
1121
1122
1123
1124
1125
1126 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
1127
1128
1129
1130      MTS-specific action is required on your part!
1131
1132      If you have enabled POP, but you want to let _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl
1133      deliver mail POP mail using its standard delivery program
1134      /bin/mail, then, again, no further MTS-specific action is
1135      required on your part!
1136
1137      Otherwise, go to the mts/sendmail/ directory.
1138
1139      % cd ../mts/sendmail/
1140
1141      This directory contains files whose definitions correspond
1142      to the configuration of your _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl system.  If you have
1143      enabled BBoards or POP service, then you will need to
1144      re-configure _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl.  First, in the "local info" section
1145      of your site's _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl configuration file, choose a free
1146      macro/class (B is used in this distribution), and add these
1147      lines:
1148
1149           # BBoards support
1150           DBbboards
1151           CBbboards
1152
1153      Second, immediately after the inclusion of the zerobase
1154      file, in the "machine dependent part of ruleset zero" sec-
1155      tion, add these lines:
1156
1157           # resolve names for the BBoards system
1158           R$+<@$=B>      $#bboards$@$2$:$1        topic@bboards
1159
1160      Be sure to use tabs when separating these fields.  Third,
1161      add the line
1162
1163           include(bboardsMH.m4)
1164
1165      after the line
1166
1167           include(localm.m4)
1168
1169      in your site's _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl configuration file.  Finally, you
1170      should link the file mts/sendmail/bboardsMH.m4 into your
1171      _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl cf/ directory and re-configure _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl.
1172
1173      If you have enabled POP service, a similar procedure must be
1174      used on the POP service host, to re-configure _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl.
1175      First, in the "local info" section of your site's _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl
1176      configuration file, choose a free macro/class (P is used in
1177      this distribution), and add these lines:
1178
1179           # POP support
1180           DPpop
1181           CPpop
1182
1183
1184
1185 [mh.6]                Last change: MH.6.8.4                    18
1186
1187
1188
1189
1190
1191
1192 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
1193
1194
1195
1196      Second, immediately after the inclusion of the zerobase
1197      file, in the "machine dependent part of ruleset zero" sec-
1198      tion, add these lines:
1199
1200           # resolve names for the POP system
1201           R$+<@$=P>      $#pop$@$2$:$1            subscriber@pop
1202
1203      Be sure to use tabs when separating these fields.  Third,
1204      add the line
1205
1206           include(popMH.m4)
1207
1208      after the line
1209
1210           include(localm.m4)
1211
1212      in your site's _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl configuration file.  Finally, you
1213      should link the file mts/sendmail/popMH.m4 into your _\bS_\be_\bn_\bd_\b-
1214      _\bM_\ba_\bi_\bl cf/ directory and re-configure _\bS_\be_\bn_\bd_\bM_\ba_\bi_\bl.
1215
1216   MMDF
1217      If you want _\bM_\bM_\bD_\bF to be your transport service, and have NOT
1218      specified "mmdf/smtp" (or "mmdf2/smtp") as your mts setting,
1219      then go to the mmdf/ directory.  (If you're using
1220      "mmdf/smtp" or "mmdf2/smtp" as your mts setting, then skip
1221      to the next section.)
1222
1223      % cd ../mts/mmdf/
1224
1225      This directory contains files whose definitions correspond
1226      to the configuration of your _\bM_\bM_\bD_\bF system.
1227
1228      If you're running _\bM_\bM_\bD_\bF-_\bI, then copy the following files from
1229      wherever you keep the _\bM_\bM_\bD_\bF sources to this directory:
1230      mmdf/h/ch.h, mmdf/h/conf.h, utildir/conf_util.h,
1231      utildir/ll_log.h, mmdf/h/mmdf.h, utildir/util.h,
1232      mmdf/mmdf_lib.a, and utildir/util_lib.a.
1233
1234      If you're running _\bM_\bM_\bD_\bF-_\bI_\bI, then copy the following files
1235      from where you keep the _\bM_\bM_\bD_\bF sources to this directory:
1236      h/ch.h, h/conf.h, h/dm.h, h/ll_log.h, h/mmdf.h, h/util.h,
1237      and lib/libmmdf.a
1238
1239      If you have enabled bboards, then the directories
1240      support/bboards/mmdfI and support/bboards/mmdfII contain
1241      information you'll need to put a UCI BBoards channel in your
1242      _\bM_\bM_\bD_\bF configuration.  Similarly, if you have enabled option
1243      "mf" and are running _\bM_\bM_\bD_\bF-_\bI, then the zotnet/mf/mmdfI/
1244      directory contains information you'll need to put a _\bU_\bU_\bC_\bP
1245      channel in your _\bM_\bM_\bD_\bF-_\bI configuration.  Finally, the direc-
1246      tory support/pop/mmdfII contains information you'll need to
1247      put a POP channel in your _\bM_\bM_\bD_\bF-_\bI_\bI configuration.
1248
1249
1250
1251 [mh.6]                Last change: MH.6.8.4                    19
1252
1253
1254
1255
1256
1257
1258 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
1259
1260
1261
1262      Note that _\bM_\bM_\bD_\bF-_\bI_\bI is distributed with the BBoards channel,
1263      although the version in the _\bM_\bH distribution might be more
1264      current, the version in the _\bM_\bM_\bD_\bF-_\bI_\bI distribution has been
1265      tested with that revision of _\bM_\bM_\bD_\bF.
1266
1267   MMDF/SMTP
1268      If you are using "mmdf/smtp" as your mts setting, then no
1269      further MTS-specific action is required on your part!
1270
1271   MMDF2/SMTP
1272      If you are using "mmdf2/smtp" as your mts setting, then no
1273      further MTS-specific action is required on your part!
1274
1275   STAND-ALONE DELIVERY
1276      If, instead, you want _\bM_\bH to handle its own mail delivery,
1277      then no further MTS-specific action is required on your
1278      part!
1279
1280 GENERATION
1281      Go to the _\bM_\bH top-level directory and generate the system.
1282
1283      % cd ../; make
1284
1285      This will cause a complete generation of the _\bM_\bH system.  If
1286      all goes well, proceed with installation.  If not, complain,
1287      as there "should be no problems" at this step.
1288
1289 INSTALLATION
1290      If the directories you chose for the user-programs,
1291      support-programs and manuals ("bin", "etc", "popdir", "slib-
1292      dir", and "mandir" in the conf/MH file) don't exist, you
1293      should create them at this point.
1294
1295      Next, if you enabled support for the UCI BBoards facility,
1296      then create a login called "bboards" with the following
1297      characteristics: home directory is /usr/spool/bboards/ with
1298      mode 755 (actually, use the value for "bbhome" given in the
1299      _\bM_\bH configuration file), login shell is /bin/csh (or
1300      /bin/sh), and, encrypted password field is "*".  The
1301      "bboards" login should own the /usr/spool/bboards/ direc-
1302      tory.  In addition to creating /usr/spool/bboards/, also
1303      create /usr/spool/bboards/etc/ and
1304      /usr/spool/bboards/archive/.  These directories should also
1305      be owned by the "bboards" login.
1306
1307      If you enabled support for POP, then on the POP service
1308      host, create a login called "pop" with the following charac-
1309      teristics: home directory is /usr/spool/pop/ with mode 755,
1310      login shell is /bin/csh, and, encrypted password field is
1311      "*".  If you don't have /bin/csh on your system (V7), then
1312      /bin/sh is just fine.  The "pop" login should own the
1313      /usr/spool/pop/ directory.  You'll also need to add a line
1314
1315
1316
1317 [mh.6]                Last change: MH.6.8.4                    20
1318
1319
1320
1321
1322
1323
1324 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
1325
1326
1327
1328      to the /etc/services file and the /etc/rc.local file, see
1329      the _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be  for more details.
1330
1331      If this is not the first time you have installed _\bM_\bH, these
1332      files will need particular attention:
1333
1334           _\bD_\bi_\br_\be_\bc_\bt_\bo_\br_\by                 _\bF_\bi_\bl_\be_\bs
1335           "etc/"                    MailAliases, BBoardAliases, mtstailor
1336           /usr/spool/bboards/       BBoards, .cshrc, .mh_profile
1337           /usr/spool/bboards/etc/   *
1338
1339      The MailAliases, BBoardAliases, mtstailor and BBoards files
1340      will NOT be installed over existing copies; you will need to
1341      edit these by hand and merge in any changes from your previ-
1342      ous _\bM_\bH release.  The other files under /usr/spool/bboards/
1343      will be overwritten if they exist.  You may wish to preserve
1344      your old versions of these before installing _\bM_\bH.
1345
1346      As the super-user, and from the mh.6/ directory, install the
1347      system.
1348
1349      # make inst-all
1350
1351      This will cause the _\bM_\bH processes and files to be transferred
1352      to the appropriate areas with the appropriate attributes.
1353
1354 TAILORING
1355      See the _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be for information on tailoring
1356      _\bM_\bH for the MTS, BBoards, and POP.
1357
1358 DOCUMENTATION
1359      In addition to this document, the _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be, and
1360      the _\bU_\bs_\be_\br'_\bs _\bM_\ba_\bn_\bu_\ba_\bl, there are several documents referenced by
1361      the user's manual which may be useful.  The sources for all
1362      of these can be found under the papers/ directory.
1363
1364 OTHER THINGS
1365      Consult the directory miscellany/ for the sources to a
1366      number of things which aren't part of the mainstream _\bM_\bH dis-
1367      tribution, but which are still quite useful.
1368
1369 FILES
1370      Too numerous to mention.  Really.
1371
1372 SEE ALSO
1373      make(1)
1374
1375 BUGS
1376      The _\bm_\bh_\bc_\bo_\bn_\bf_\bi_\bg program should be smarter.
1377
1378      There's no way to print the _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be until
1379      after you have configured the system; it is difficult to
1380
1381
1382
1383 [mh.6]                Last change: MH.6.8.4                    21
1384
1385
1386
1387
1388
1389
1390 MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
1391
1392
1393
1394      configure the system without the _\bA_\bd_\bm_\bi_\bn_\bi_\bs_\bt_\br_\ba_\bt_\bo_\br'_\bs _\bG_\bu_\bi_\bd_\be.
1395
1396      The Makefiles should know when _\bm_\bh_\bc_\bo_\bn_\bf_\bi_\bg has been run and
1397      force "make clean" behavior.
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449 [mh.6]                Last change: MH.6.8.4                    22
1450
1451
1452