File: READ-ME

package info (click to toggle)
mh 6.8.4-28
  • links: PTS
  • area: main
  • in suites: slink
  • size: 7,012 kB
  • ctags: 7,496
  • sloc: ansic: 75,211; sh: 3,112; lisp: 2,205; ml: 1,894; makefile: 724; perl: 482; csh: 150; tcl: 66; sed: 43; awk: 7
file content (1452 lines) | stat: -rw-r--r-- 58,077 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
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
1450
1451
1452



MH-GEN(8)                                               MH-GEN(8)


NNAAMMEE
       mh-gen - generating the MH system

RREEAADD TTHHIISS
       This documentation describes how to configure, generate,
       and install the UCI version of the RAND _M_H system.  BBee
       cceerrttaaiinn to read this document completely before you begin.
       You probably will also want to familiarize yourself with
       the _M_H Administrator's Guide before you install _M_H.  A
       copy can be found in the file ddoocc//AADDMMIINN..ddoocc is the _M_H
       sources.

DDIISSCCLLAAIIMMEERR
       Although the _M_H system was originally developed by the
       RAND Corporation, and is now in the public domain, the
       RAND Corporation assumes no responsibility for _M_H or this
       particular modification of _M_H.

       In addition, the Regents of the University of California
       issue the following ddiissccllaaiimmeerr in regard to the UCI ver-
       sion of _M_H:
            "Although each program has been tested by its con-
            tributor, no warranty, express or implied, is made by
            the contributor or the University of California, as
            to the accuracy and functioning of the program and
            related program material, nor shall the fact of dis-
            tribution constitute any such warranty, and no
            responsibility is assumed by the contributor or the
            University of California in connection herewith."

       This version of _M_H is in the public domain, and as such,
       there are no real restrictions on its use.  The _M_H source
       code and documentation have no licensing restrictions
       whatsoever.  As a courtesy, the authors ask only that you
       provide appropriate credit to the RAND Corporation and the
       University of California for having developed the soft-
       ware.

GGEETTTTIINNGG HHEELLPP
       _M_H is a software package that is neither supported by the
       RAND Corporation nor the University of California.  How-
       ever, since we do use the software ourselves and plan to
       continue using (and improving) _M_H, bug reports and their
       associated fixes should be reported back to us so that we
       may include them in future releases.  The current computer
       mailbox for _M_H is BBuugg--MMHH@@IICCSS..UUCCII..EEDDUU.  Current information
       about MH can be obtained from the MMHH HHoommee PPaaggee on the
       World Wide Web at hhttttpp::////wwwwww..iiccss..uuccii..eedduu//~~mmhh.

       Presently, there are two Internet discussion groups,
       MMHH--UUsseerrss@@IICCSS..UUCCII..EEDDUU and MMHH--WWoorrkkeerrss@@IICCSS..UUCCII..EEDDUU.  MMHH--WWoorrkk--
       eerrss is for people discussing code changes to _M_H.  MMHH--UUsseerrss
       is for general discussion about how to use _M_H.  MMHH--UUsseerrss
       is bi-directionally gatewayed into USENET as ccoommpp..mmaaiill..mmhh.



[mh.6]                       MH.6.8.4                           1





MH-GEN(8)                                               MH-GEN(8)


HHOOWW TTOO GGEETT MMHH
       Since you probably already have _M_H, you may not need to
       read this unless you suspect you have an old version.
       There are two ways to get the latest release:

       1.  If you can FTP to the ARPA Internet, use anonymous FTP
       to ftp.ics.uci.edu and retrieve the file
       pub/mh/mh-6.8.tar.Z.  This is a tar image after being run
       through the compress program (approximately 1.8MB).  There
       should also be a RREEAADDMMEE file in that directory which tells
       what the current release of _M_H is, and how to get updates.

       You may also find MH on various other hosts; to make sure
       you get the latest version and don't waste your time re-
       fixing bugs, it's best to get it from either
       ftp.ics.uci.edu or a site that mirrors ftp.ics.uci.edu.

       2.  You can send $75 US to the address below.  This covers
       the cost of a 6250 BPI 9-track magtape, handling, and
       shipping.  In addition, you'll get a laser-printed hard-
       copy of the entire MH documentation set.  Be sure to
       include your USPS address with your check.  Checks must be
       drawn on U.S. funds and should be made payable to:

                 Regents of the University of California

       The distribution address is:

                 Attn: MH distribution
                 Office of Academic Computing
                 Univeristy of California at Irvine
                 Irvine, CA  92717-2225  USA

                 +1 714 824 5153

       Sadly, if you just want the hard-copies of the documenta-
       tion, you still have to pay the $75.  The tar image has
       the documentation source (the manual is in roff format,
       but the rest are in TeX format).  Postscript formatted
       versions of the TeX papers are available, as are crude
       tty-conversions of those papers.

SSYYNNOOPPSSIISS
       MAKE

DDEESSCCRRIIPPTTIIOONN
       This is a description of how one can bring up an _M_H sys-
       tem.  It is assumed that you have super-user privileges in
       order to (re-)install _M_H.  Super-user privileges are not
       required to configure or generate _M_H.

       Become the super-user and cd to /usr/src/local/ (or what-
       ever you keep your local sources).  The distribution tape
       contains the hierarchy for the mh.6-8/ directory.  Bring



[mh.6]                       MH.6.8.4                           2





MH-GEN(8)                                               MH-GEN(8)


       the sources on-line:

       # cd /usr/src/local
       % tar xv
       % cd mh-6.8

CCOONNFFIIGGUURRAATTIIOONN
       First, go to the conf/ directory.

       % cd conf/

       This directory contains files that will produce source
       files tailored for your choice of _M_H configuration.  You
       should edit only the file MMHH.  This file contains configu-
       ration directives.  These configuration directives are
       read by the _m_h_c_o_n_f_i_g program to produce customized files.

       For examples of various configurations, look in the direc-
       tory ccoonnff//eexxaammpplleess//.  The file MMHH provided in ccoonnff// is a
       reasonable default.  Lines beginning with `#' are com-
       ments, and are not otherwise interpreted.

       Here are the _M_H configuration directives available.  Be
       sure to read through this list completely before attempt-
       ing to decide what directives are appropriate for your
       system.

       More information on some of these options is available in
       the the _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e.  If you do not have a
       printed copy, you should configure your system with the
       default configuration file, MMHH, then generate and print a
       copy of the guide (as described below).

     IInnssttaallllaattiioonn ppaatthhss
       bin: /usr/local
            The directory where user-invoked programs go (see
            manual section 1).

       etc: /usr/local/lib/mh
            The directory where pgm-invoked programs go (see man-
            ual section 8).

       mail: /usr/spool/mail
            The directory where the maildrops are stored.  If
            this pathname is absolute (i.e., begins with a // ),
            then the user's maildrop is a file called $$UUSSEERR in
            this directory.  If the pathname is not absolute,
            then the user's maildrop is in the user's home direc-
            tory under the given name.

       mandir: /usr/man
            The parent directory of the manual entries.

       manuals: standard



[mh.6]                       MH.6.8.4                           3





MH-GEN(8)                                               MH-GEN(8)


            Where manual entries should be installed, relative to
            the directory given with "mandir".  Either "local" to
            install manual entries under mmaannll//, or "new" to
            install manual entries under mmaannnn//, or "old" to
            install manual entries under mmaannoo//, or "standard" to
            install manual entries under mmaann??//, or "bsd44" to
            install manual entries as mmaann??//_p_a_g_e..00, or "gen" to
            generate but not install them, or "none" to neither
            generate nor install them.

            Any of these values may have the suffix "/cat"
            appended to it.   In that case, the manual entries
            will be formatted with "nroff -man" and they will be
            installed in the corresponding "cat?" directories.

            For example, to install manual entries under
            //uussrr//mmaann//uu__mmaann//mmaann??, use "standard" and
            //uussrr//mmaann//uu__mmaann for "mandir".  To install formatted
            manual entires under //uussrr//ccoonnttrriibb//mmaann//ccaatt??, use
            "standard/cat" and //uussrr//ccoonnttrriibb//mmaann for "mandir".  To
            install formatted manual entries using the BSD44 con-
            vention, use "bsd44/cat".

       chown: /etc/chown
            The location of the _c_h_o_w_n(8) on your system.  If
            _c_h_o_w_n is in your search path, just use the value of
            "chown".  On SYS5 systems, this should probably be
            "/bin/chown".

       cp: cp
            The command to copy files when installing, if not
            "cp".  (Some sites use "cp -p".)

       ln: ln
            The command to link files together in the source
            tree, if not "ln".  If you're using something like
            llnnddiirr to keep your compile tree separate from your
            source tree, set this to "ln -s" or "cp".

       remove: mv -f
            How _M_H should make backup copies of existing files
            when installing new files.  To simply remove the old
            files, use "rm -f".

     CCoommppiilleerr//llooaaddeerr
       cc: cc
            The name of your C compiler, if not "cc".

       ccoptions: -O
            Options given directly to _c_c(1).  The most common is
            "-M" if you're running _M_H on an ALTOS.  This defaults
            to "-O".  If you define this and want to keep "-O",
            be sure to include it explicitly.  If you're using
            the _G_N_U C compiler, it should include `-traditional'.



[mh.6]                       MH.6.8.4                           4





MH-GEN(8)                                               MH-GEN(8)


            See "options:" for `-D' options.

       curses: -lcurses -ltermlib
            This should be the loader option required to load the
            _t_e_r_m_c_a_p(3) and _c_u_r_s_e_s(3) libraries on your system.
            On SYS5 systems, it probably should be just
            "-lcurses".  Some sites have reported that both
            "-lcurses" and "-ltermlib" are necessary.

       ldoptions: -s
            Options given directly to _l_d(1) (via _c_c) at the
            beginning of the command line.  Useful for machines
            which require arguments to tell _l_d to increase the
            stack space (e.g. the Gould, which uses "-m 8").
            Usually, "-s" is a good choice in any event.

       ldoptlibs:
            Options given directly to _l_d(1) (via _c_c) at the end
            of the command line.  The two most common are:
            "-ldbm" if you're running MMDF with the _d_b_m package;
            and, "-lndir" if you are generating _M_H on a system
            which does not load the new directory access mecha-
            nism by default (e.g., 4.1BSD, SYS5).  If you don't
            have _l_i_b_n_d_i_r on your system, the sources are in mmiiss--
            cceellllaannyy//lliibbnnddiirr//.

       lex: lex -nt
            Alternative version of _l_e_x.  Used in zzoottnneett//ttwwss//.

       oldload: off
            This controls how _M_H will try to process library
            object files to eliminate local symbols.  Support for
            the ALTOS loader if "on".  Support for loaders not
            handling `-x -r' correctly if "none".

       ranlib: on
            Support for systems with _r_a_n_l_i_b(1).  For SYSTEM 5
            systems, this should be "off" which tells _M_H to use
            _l_o_r_d_e_r and _t_s_o_r_t instead.  Some SYSTEM 5 sites
            reported that running this isn't always sufficient.
            If this is the case, then you should edit ccoonnff//mmaakkee--
            ffiilleess//uuiipp to include ....//ssbbrr//lliibbmmhh..aa and ....//zzoott--
            nneett//lliibbzzoott..aa twice in the LIBES variable.

     MMeessssaaggee TTrraannssppoorrtt SSyysstteemm
       mts: sendmail
            Which message transport system to use.  Either "mmdf"
            to use _M_M_D_F as the transport system, "mmdf2" to use
            _M_M_D_F_-_I_I as the transport system, "sendmail" to have
            _S_e_n_d_M_a_i_l as the transport system, "zmailer" to have
            _Z_M_A_I_L_E_R as the transport system, or, "mh" to have _M_H
            as the transport system.

            On UNIX systems supporting TCP/IP networking via



[mh.6]                       MH.6.8.4                           5





MH-GEN(8)                                               MH-GEN(8)


            sockets you can add the suffix "/smtp" to the mts
            setting.  This often yields a superior interface as
            _M_H will post mail with the local _S_M_T_P server instead
            of interacting directly with _M_M_D_F or _S_e_n_d_M_a_i_l.
            Hence, for TCP/IP UNIX systems, the "/smtp" suffix to
            either "sendmail" or "mmdf2" is the preferred MTS
            configuration.  The "/smtp" suffix is described in
            detail in the _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e; be sure to set
            "servers:" as described in _m_h_-_t_a_i_l_o_r(8) if you use
            this option.

       mf: off
            Support for mail filtering on those systems in which
            the message transport system isn't integrated with
            _U_U_C_P This option is strictly for an _M_H system using
            either _M_M_D_F_-_I as its transport system or one using
            "stand-alone delivery".

     UUCCII BBBBooaarrddss FFaacciilliittyy
       bboards: off
            If "on", include support for the UCI BBoards facil-
            ity.  BBoards may be enabled with any mts setting.
            If "off", the BBoard reading program _b_b_c will not be
            installed.  If "nntp", include support for the UCI
            BBoards facility to read the Network News via the
            NNTP.  If "pop" (formerly "popbboards: on"), include
            support for the UCI BBoards facility via the POP3
            service; this setting requires "pop: on".

       bbdelivery: off
            If "off", the BBoards delivery agent and library
            files will not be installed.  If "on", and you set
            "bboards:" to something besides "off", then the
            BBoards delivery agent and library files will be
            installed in the _b_b_h_o_m_e directory (see below).  To
            read remote BBoards, the usual configuration would
            have _b_b_c talk to a _P_O_P_3 or _N_N_T_P server.  However, it
            may be useful to set this to "off" if you NFS mount
            the _b_b_h_o_m_e directory from another host and want to
            use _b_b_c to read those files directly.

       bbhome: /usr/spool/bboards
            The home directory for the BBoards user.

     PPoosstt OOffffiiccee PPrroottooccooll
       pop: off
            Support for POP service.  This allows local delivery
            for non-local users (a major win).  See ssuupp--
            ppoorrtt//ppoopp//ppoopp..rrffcc for more information on the POP.
            This option currently works only on UNIX systems with
            TCP/IP sockets.  (It doesn't hurt to enable this
            option regardless of whether or not you intend to use
            POP.)  See also "bboards: pop" to enable reading
            bboards with the POP.



[mh.6]                       MH.6.8.4                           6





MH-GEN(8)                                               MH-GEN(8)


       popdir: /usr/etc
            The directory where the POP daemon (ppooppdd) will be
            installed.

       options:
            `-D' options to _c_c(1).

         APOP='"/etc/pop.auth"'
              This option indicates that the POP daemon will sup-
              port the non-standard AAPPOOPP command, and specifies
              the name of AAPPOOPP authorization database.  The AAPPOOPP
              command provides a challenge-based authentication
              system using the MMDD55 message digest algorithm.
              This facility is documented in _T_h_e _I_n_t_e_r_n_e_t _M_e_s_s_a_g_e
              (ISBN 0-13-092941-7), a book by Marshall T. Rose.

              This option also causes the ppooppaauutthh program to be
              installed, which allows the administrator to manip-
              ulate the AAPPOOPP authorization database.  For more
              details, see ssuuppppoorrtt//ppoopp//ppoopp--mmoorree..ttxxtt and the
              _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e.

         DPOP
              This option indicates that POP subscribers do not
              have entries in the _p_a_s_s_w_d(5) file, and instead
              have their own separate database (a win).

         KPOP
              Support for KERBEROS with POP.  This code builds
              _p_o_p_d, _i_n_c and _m_s_g_c_h_k to support only the "kpop"
              protocol.  This code is still experimental, but is
              available for those sites wishing to test it.

         MPOP
              This option indicates that the POP daemon will sup-
              port the non-standard XXTTNNDD SSCCAANN command which pro-
              vides performance enhancements when using the POP
              over low-speed connections.  This option also
              causes an interactive POP client program, ppooppii, to
              be compiled and installed.  A man page for the ppooppii
              program is also provided.

              These extensions are described in _T_h_e _I_n_t_e_r_n_e_t _M_e_s_-
              _s_a_g_e, a book by Marshall T. Rose.  For more
              details, see ssuuppppoorrtt//ppoopp//ppoopp--mmoorree..ttxxtt.  NNoottee:: this
              option requires "bboards: pop".

         POP2
              Have the POP daemon understand the older POP2 pro-
              tocol as well as the _M_H POP3 protocol - a major
              win.  The POP daemon auto-magically determines
              which POP protocol your client is using.  If you're
              enabling POP service, there's no reason not to
              enable this option as well.  See also _P_O_P_S_E_R_V_I_C_E.



[mh.6]                       MH.6.8.4                           7





MH-GEN(8)                                               MH-GEN(8)


         POPSERVICE
              The port name the _M_H POP will use.  For historical
              reasons, this defaults to "pop".

              In 1987, the _M_H POP protocol (POP version 3) was
              published as RFC1081 and was assigned its own port
              number (110), which differs from the original POP
              (version 1 and 2) port number (109).

              To have _M_H POP use the new assigned port number,
              set POPSERVICE='"pop3"', and be sure that this ser-
              vice name is listed in your //eettcc//sseerrvviicceess file on
              both POP client and server hosts as "110/tcp".  If
              you enable _P_O_P_2, you can safely leave _P_O_P_S_E_R_V_I_C_E
              undefined unless you are using POP3 clients besides
              _M_H.

         RPOP
              This option indicates that support for the UNIX
              variant of POP, RPOP, which uses privileged sockets
              for authentication be enabled.  This peacefully co-
              exists with the standard POP.

         SHADOW
              Indicates that the ppooppdd POP server can find
              encrypted passwords in the //eettcc//sshhaaddooww file (and
              not in the //eettcc//ppaasssswwdd file).  It should be used
              only for some (newer) SYSTEM 5 systems.

            The "APOP" and "MPOP" non-standard POP facilities are
            documented in _T_h_e _I_n_t_e_r_n_e_t _M_e_s_s_a_g_e (ISBN
            0-13-092941-7), a book by Marshall T. Rose.  For more
            details, see ssuuppppoorrtt//ppoopp//ppoopp--mmoorree..ttxxtt.  The "APOP"
            option peacefully co-exists with the standard POP.
            The "MPOP" option requires "bboards: pop".

     SShhaarreedd lliibbrraarriieess
       sharedlib: off
            If "sun4", makes libmh.a into a SunOS 4.0 (and later)
            shared library.  If you enable this, be sure to also
            use "options SUN40".  If "sys5", makes libmh.a into a
            SYS5 R4 (and later) shared library.  If you enable
            this, be sure to also use "options SVR4".

       slflags: -pic
            The compiler flags to produce position independent
            code.

       slibdir: /usr/local/lib
            The directory where the _M_H shared library should go.







[mh.6]                       MH.6.8.4                           8





MH-GEN(8)                                               MH-GEN(8)


          Under SunOS (sun4)
            Since some _M_H programs are setuid, they'll only look
            for the library in "trusted" locations.  Putting the
            library somewhere besides //uussrr//lliibb or //uussrr//llooccaall//lliibb
            is not advisable.

            If you mmuusstt do this, be sure that you add the path
            given by sslliibbddiirr to the compiler's library search
            list (e.g., "ldoptions: -L/usr/mh/lib") and make sure
            the path starts with a leading `/'.

            You may need to run _l_d_c_o_n_f_i_g(8) manually whenever a
            new shared object is installed on the system.  See
            _l_d(1) for more information about using shared
            libraries.

          Under Solaris 2.0 (and newer)
            The above instructions for SunOS apply, except you
            should set the run-time library search path using
            `-R' instead of `-L' (e.g., "ldoptions:
            -R/usr/mh/lib").

     GGeenneerraall SSyysstteemm DDeeppeennddeenncciieess
       You should include the following directives which are
       appropriate for your version of UNIX.  If you don't know
       what an option does, it probably doesn't apply to you.

       mailgroup: off
            If set, _i_n_c is made set-group-id to this group name.
            Some SYS5 systems want this to be set to "mail".  Set
            this if your //uussrr//ssppooooll//mmaaiill is not world-writeable.

            Note that ssllooccaall doesn't know how to deal with this,
            and will not work under these systems; just making it
            set-group-id will open a security hole.  If you're
            using "mailgroup", you should remove ssllooccaall (and its
            man page) from your system.

       signal: int
            The base type (int or void) of the function parame-
            ter/return value of _s_i_g_n_a_l(2).  The default is iinntt.
            Set "signal void" on systems which use this type
            (e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and
            later).

       sprintf: char *
            The return value of the _s_p_r_i_n_t_f library routine.
            This defaults to "char *".  Set this to "int" if you
            have an older version of SYSTEM 5 which has this rou-
            tine return an "int" type.







[mh.6]                       MH.6.8.4                           9





MH-GEN(8)                                               MH-GEN(8)


       options:
            `-D' options to _c_c(1).

         ALTOS
              Use on XENIX/v7 systems.  Also, be sure to use
              "options V7".

         ATTVIBUG
              This option causes _M_H to return to the "What now?"
              prompt if your initial editor is vvii and it exits
              with non-zero status.  Use on Sun OS 4.1 and other
              systems where the //uussrr//uuccbb//vvii editor was changed to
              exit with its status equal to the number of
              pseudo-"errors" encountered during the edit.  This
              causes a problem for programs that test the exit
              status of their editor and abort if the status is
              non-zero.  (This includes _M_H and programs like
              //uussrr//eettcc//vviippww).

         AUX
              Use with AUX systems.

         BIND
              If you are running with the BIND code on UNIX sys-
              tems with TCP/IP sockets (e.g. 4.{2,3}BSD), be sure
              to define this.

         BSD41A
              Use on 4.1a Berkeley UNIX systems.

         BSD42
              Use on Berkeley UNIX systems on or after 4.2BSD.

         BSD43
              Use on 4.3 Berkeley UNIX systems.  Also, be sure to
              use "options BSD42".  If _o_p_e_n_l_o_g(3) (see "man 3
              syslog") takes three arguments instead of two, and
              your _w_r_i_t_e(1) command is set-group-id to group
              "tty", use this option.  If only one of these con-
              ditions is true, you lose.

         BSD44
              Use on Berkeley UNIX systems on or after 4.4BSD.
              Also, be sure to use "options BSD43" and "options
              BSD42".

         DBMPWD
              Use this option if your _g_e_t_p_w_e_n_t(3) routines read a
              dbm database (such as with Yellow Pages) instead of
              doing a sequential read of //eettcc//ppaasssswwdd.  Without
              DBMPWD the entire passwd file is read into memory
              one entry at a time for alias expansion.  This is a
              performance improvement when reading a standard
              //eettcc//ppaasssswwdd file, but is _v_e_r_y slow on systems with



[mh.6]                       MH.6.8.4                          10





MH-GEN(8)                                               MH-GEN(8)


              a dbm database.  At one site that runs YP on a
              large passwd file, it showed a 6:1 performance
              improvement.

         GCOS_HACK
              The so-called "gcos" field of the password file is
              used as a last resort to find the user's full name
              (see _m_h_-_p_r_o_f_i_l_e(5) for details).  Enable this
              option if your _p_a_s_s_w_d(5) man page notes that the
              `&' character in the "gcos" field stands for the
              login name.

         FCNTL
              Directs _M_H to use the ffccnnttll(()) system call for ker-
              nel-level locking.  If you're using a SYS5 system,
              you may want this option.  (See also `FLOCK' and
              `LOCKF').

         FLOCK
              Directs _M_H to use the fflloocckk(()) system call for ker-
              nel-level locking.  If you're on a BSD42 system,
              and you're not using NFS to read or write mail-
              drops, you should enable this option.  (See also
              `FCNTL' and `LOCKF').

         HESIOD
              Support for HESIOD.  This code was contributed, and
              included no documentation.

         LOCKF
              Directs _M_H to use the lloocckkff(()) system call for ker-
              nel-level locking.  If you're using NFS to read or
              write maildrops, you should enable this option.
              (See also `FLOCK' and `FCNTL').

         locname
              Hard-wires the local name for the host _M_H is run-
              ning on.  For example, locname='"PICKLE"'.  It's
              probably better to either let UNIX tell _M_H this
              information, or to put the information in the host
              specific mmttssttaaiilloorr file.

         MORE
              Defines  the location of the _m_o_r_e(1) program.  On
              ALTOS and DUAL systems, set MORE='"/usr/bin/more"'.
              The default is "/usr/ucb/more".

         NDIR
              For non-Berkeley UNIX systems, this _M_H will try to
              find the new directory access mechanism by looking
              in <<nnddiirr..hh>> if this option is given.  Otherwise, _M_H
              will try <<ddiirr..hh>>.  If you still can't get this to
              work on your system, edit hh//llooccaall..hh as appropriate.
              (See also `SYS5DIR'.)



[mh.6]                       MH.6.8.4                          11





MH-GEN(8)                                               MH-GEN(8)


         NFS
              Tells _M_H to hack around a problem in the NFS C
              library.  If you get an undefined symbol "ruser-
              pass" when compiling _M_H, you probably need this
              option.  If, however, you include this option and
              get an undefined symbol "__ruserpass" when compil-
              ing, then you should omit this option.  (See also
              `NORUSERPASS'.)

         NLINK_HACK
              This is a (rather dramatic under certain circum-
              stances) speed hack.  If this is set then an opti-
              mization is used when scanning for folders recur-
              sively:  For any directory which has at least 2
              links it's assumed that the number of subdirecto-
              ries is st_nlink - 2.  This is true for most Unix
              file systems, but isn't true for AFS file systems
              and might not be true for file systems remotely
              mounted from non-Unix systems.  If the st_nlink
              value returned by these systems is 0 or 1 all will
              be well (I don't know if this is the case or not),
              but if it's at least 2 but not always n_subdirs + 2
              then _M_H will miss some subfolders.  Another way
              that this can be broken is if you have a folder
              whose subfolders are all symbolic links to other
              directories (if there's at least one real subdirec-
              tory then the code will handle it).

              Note that the code which implements this option
              assumes that you've got symbolic links (or more
              precisely, lstat(2)).  If you don't have lstat(2)
              the algorithm can be made both more correct and
              more efficient, but I haven't bothered to code this
              up in a selectable manner.

         NOIOCTLH
              Tells _M_H not to include the file <<ssyyss//iiooccttll..hh>>.  To
              be used on systems where this file is not present.

         NORUSERPASS
              Tells _M_H that your system doesn't have the
              _r_u_s_e_r_p_a_s_s(3) routine; _M_H will include its own copy
              of this routine in its library.  (See also `NFS'.)

         NTOHLSWAP
              Tells _M_H to use the nnttoohhll(()) macro when processing
              _m_s_h binary map files.  _M_H can use this macro on
              systems with the include file nneettiinneett//iinn..hh, to
              byte-swap the binary information in these map
              files.  If you're using the same map files on
              machines of different architectures, enable this
              option.

         RENAME



[mh.6]                       MH.6.8.4                          12





MH-GEN(8)                                               MH-GEN(8)


              Include this option if your system has a rreennaammee(())
              library call.  This is true on BSD42 and newer and
              some SYS5 systems.

         SENDMAILBUG
              Causes SMTP reply code 451 (failure) to be consid-
              ered the same as code 250 (OK).  Since this might
              cause problems, only enable this if you are certain
              that your SendMail will return this code even when
              it doesn't mean to indicate a failure.

         SOCKETS
              Indicates the availability of a socket interface
              for TCP/IP networking that is compatible with
              4.{2,3}BSD UNIX.  It is not necessary to define
              this when BSD42 is already defined, but it might be
              useful for SYSTEM 5 or HPUX systems with TCP/IP
              sockets.

         SUN40
              Use on Sun OS 4.0 (and later?) systems.  You also
              will need "options BSD42", "options BSD43", and
              "signal void".

              If you're using Sun's brain-damaged approach to
              offering Domain Name Service through NIS, be sure
              to include "options BIND" and "ldoptions -lresolv"
              to work around some NIS/DNS bugs.

         SYS5
              Use on AT&T SYSTEM 5 R3 (and newer?) UNIX systems.
              See also _m_a_i_l_g_r_o_u_p.

         SYS5DIR
              Define this if your system uses "struct dirent"
              instead of "struct direct".  This is true of System
              V Release 3.0 and later.  Uses include file
              <<ddiirreenntt..hh>> and the routines _m_k_d_i_r, _r_m_d_i_r and
              _g_e_t_c_w_d.

         SVR4
              Use on AT&T SYSTEM 5 R4 (and newer?) UNIX systems.
              You should also include "options SYS5" and "options
              SYS5DIR".  See also _m_a_i_l_g_r_o_u_p.  You will also need
              to include "oldload none" if your lldd doesn't handle
              `-x -r' correctly.

         TERMINFO
              Define TERMINFO if you have it.  You get it auto-
              matically if you're running SYS5, and you don't get
              it if you're not.  (If you're not SYS5, you proba-
              bly have termcap.)

         TZNAME



[mh.6]                       MH.6.8.4                          13





MH-GEN(8)                                               MH-GEN(8)


              Use time zone names from the _t_z_n_a_m_e variable, set
              via _t_z_s_e_t.  Only applicable on SYSTEM 5 systems and
              only effective when you have asked for alpha-time-
              zones (see the ATZ option).  See also ZONEINFO.

         UNISTD
              Include this option if your system has the file
              <<uunniissttdd..hh>>.  If not specified, the LOCKF option
              will include <<ssyyss//ffccnnttll..hh>>.

         V7
              Use on V7 UNIX systems.  Also, be sure to use
              "options void=int".

         VSPRINTF
              Include this option if your system has the
              _v_s_p_r_i_n_t_f(3) library routine; otherwise, ___d_o_p_r_n_t(3)
              will be used.

         WAITINT
              BSD42 based systems call the _w_a_i_t(2) system routine
              with a pointer to type _u_n_i_o_n _w_a_i_t.  Include this
              option if you included "options BSD42", but your
              system calls the _w_a_i_t(2) system routine with a
              pointer to type _i_n_t (the non-BSD42 default).

         ZONEINFO
              Specify this if you have a BSD43 based system that
              keeps time zone information /etc/zoneinfo or
              /usr/lib/zoneinfo (SunOS), and where the _s_t_r_u_c_t _t_m
              returned by _l_o_c_a_l_t_i_m_e(3) contains a _t_m___g_m_t_o_f_f ele-
              ment (see //uussrr//iinncclluuddee//ttiimmee..hh).  With this fix the
              GMT offset specified in outgoing mail will be cor-
              rected when the TZ enviornment variable is set to a
              different time zone.  See also TZNAME.

     SSiittee PPrreeffeerreenncceess
       These options change the default behavior of _M_H or enable
       optional features.  Add the options which are appropriate
       for your configuration or your site preferences.

       editor: prompter
            The default editor for _M_H.

       options:
            `-D' options to _c_c(1).

         ATZ
              Directs _M_H to use alpha-timezones whenever possi-
              ble.  You should not use this option if you are on
              the Internet, since it will make your host non-com-
              pliant with RFC-1123 (Requirements for Internet
              Hosts).




[mh.6]                       MH.6.8.4                          14





MH-GEN(8)                                               MH-GEN(8)


         ATHENA
              Makes _r_e_p_l `-nocc all' the default instead of
              `-cc all'.  You may want to enable this if you're
              using _x_m_h.

         BANG
              Directs _M_H to favor `!' over `@' in addressing.

         BERK
              Optional for for 4.{2,3}BSD sites running SendMail.
              Disables nearly all of the RFC822 address and
              header-parsing routines in favor of recognizing
              such formats as ASCnet, and so on.  If you don't
              need to disable the parser for this reason, you
              probably want to use "options DUMB" instead.

         COMPAT
              If you previously ran a version of _M_H earlier than
              mh.4 use this option.  After a short grace period,
              remove it and re-{configure,generate,install}
              everything.

         DUMB
              Directs _M_H not to try and rewrite addresses to
              their "official" form.

         FOLDPROT
              Defines the octal value for default folder-protec-
              tion.  For example, FOLDPROT='"0700"'.  The default
              is "0711".

         ISI
              When using "repl -ccme", only "cc:" the first
              address found which belongs to the user; any other
              _A_l_t_e_r_n_a_t_e_-_M_a_i_l_b_o_x_e_s do not receive "cc:"s.

         LINK
              Defines the filename for alternate file name for
              _d_i_s_t and _r_e_p_l.  For example, LINK='"\\043"' to use
              the pound-sign character.  The default is "@".

         MHE
              Enables crude support for Brien Reid's MHE inter-
              face.  Recommended for use with the GNU Emacs mh-e
              package.

         MHRC
              Enables _M_H to recognize the _C_S_h_e_l_l's `~'-construct.
              This is useful for sites that run with a ~/.mhrc
              for their users.

         MIME
              Enables support for multi-media messages, as speci-
              fied in RFC 1341 -- a major win.  This allows you



[mh.6]                       MH.6.8.4                          15





MH-GEN(8)                                               MH-GEN(8)


              to include things like audio, graphics, and the
              like, in your mail messages.  Several _M_H commands
              are extended to support these multi-media messages,
              and the _m_h_n command is provided to encode and
              decode MMIIMMEE messages.  For more details, see mmiiss--
              cceellllaannyy//mmuullttii--mmeeddiiaa//RREEAADD--MMEE and _m_h_n(1).

         MSGID
              Enables ssllooccaall to detect and surpress duplicate
              messages received.  This code uses the <<nnddbbmm..hh>>
              library, and requires "options BSD42" since it uses
              the _f_l_o_c_k(2) system call for locking.  (Note that
              this means its database locking does not work over
              NFS.)  It has only been tested under SUN40.

         MSGPROT
              Defines the octal value for default folder-protec-
              tion.  For example, MSGPROT='"0600"'.  The default
              is "0644".

         NOMHSEQ
              Directs _M_H to make private sequences the default.

         OVERHEAD
              Enable _M_H commands to read profile/context from
              open fd:s without doing an open(); see
              _m_h_-_p_r_o_f_i_l_e(5) for the details.

         RPATHS
              Directs _i_n_c to note UNIX "From " lines as Return-
              Path: info.

         SBACKUP
              Defines the prefix string for backup file names.
              For example, SBACKUP='"\\043"'.  The default is
              ",".

         TMA
              Support for the TTI _t_r_u_s_t_e_d _m_a_i_l _a_g_e_n_t (TMA).
              Although the TTI TMA is nnoott in the public domain,
              the _M_H support for the TTI TMA iiss in the public
              domain.  You should enable this option only if you
              are licensed to run the TMA software (otherwise,
              you don't have the software in your _M_H source
              tree).

         TTYD
              Support for TTYD.  This is no longer in wide use,
              and is not recommended.

         UCI
              First, "_" and "#" are recognized as the prefixes
              for scratch files.  Second, support for the UCI
              group-leadership mechanism is enabled in _c_o_n_f_l_i_c_t.



[mh.6]                       MH.6.8.4                          16





MH-GEN(8)                                               MH-GEN(8)


              Third, the first line of the file file $$HHOOMMEE//..ssiigg--
              nnaattuurree is used as the _F_u_l_l _N_a_m_e part of your
              "From:" header.  This may conflict with the inter-
              pretation of this file by _N_e_w_s.  If you're not at
              UCI, you probably don't want this option.

         UK
              Directs the _s_c_a_n program to generate UK-style dates
              by default.

         WHATNOW
              Enable certain _M_H commands to act differently when
              $mhdraft set.

         YEARMOD
              This option makes the _m_h_-_f_o_r_m_a_t %%((yyeeaarr)) function
              always return a value less than 100.  Enable this
              option if you have local _m_h_-_f_o_r_m_a_t(5) files which
              cannot handle 4-digit years.  You should convert
              these files to use a 4-character field width, or
              use the %%((mmoodduulloo 110000)) function to obtain a 2-digit
              year value.  After a short grace period, remove
              `YEARMOD' and re-{configure,generate,install}
              everything.

     TTeessttiinngg//ddeebbuuggggiinngg
       debug: off
            Support for debug mode of _M_H.  Don't use this unless
            you know what you're doing, which isn't likely if
            you're reading this document!

       regtest: off
            Set this to "on" if you are doing regression testing
            among different compilations of _M_H, and you do not
            want the hostname and compile date included in _M_H
            binaries.



       Now edit ccoonnff//ccoonnffiigg//mmttssttaaiilloorr, depending on your choice
       of the setting for mts in the _M_H configuration file.  for
       an mts setting of "mh", look at the file ccoonnff//ttaaii--
       lloorr//mmhhmmttss; for an mts setting of "sendmail", "send-
       mail/smtp", "mmdf/smtp", or "mmdf2/smtp", look at the file
       ccoonnff//ttaaiilloorr//sseennddmmttss; and, for an mts setting of "mmdf", or
       "mmdf2", look at the file ccoonnff//ttaaiilloorr//mmmmddff.

       Now install the configured files into the source areas.
       (On SYS5 systems, or other systems where you get com-
       plaints about "_index" and "_rindex" being undefined, you
       should use "make sys5" to compile mhconfig.)

       % make
       % ./mhconfig MH



[mh.6]                       MH.6.8.4                          17





MH-GEN(8)                                               MH-GEN(8)


       BBeeffoorree pprroocceeeeddiinngg, you should familiarize yourself with
       the _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e.  To generate an _n_r_o_f_f version,
       go to the doc/ directory and type:

       % (cd ../doc/; make ADMIN.doc)


       If you're already running _M_H at your site, you should also
       read the _m_h changes document CCHHAANNGGEESS.  The source is in
       ppaappeerrss//cchhaannggeess//.

       After reading the _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e, you may decide to
       change your MH configuration.  If so, cd back to the ccoonnff//
       directory, re-edit the files MMHH and ccoonnff//ccoonnffiigg//mmttssttaaiilloorr,
       and re-run _m_h_c_o_n_f_i_g.

       You now proceed based on your choice of a transport system
       (the setting for mts above).  The best interface is
       achieved with "sendmail" followed by "mmdf" or ("mmdf2"),
       and then "mh" (stand-alone delivery, not recommended).

   SSEENNDDMMAAIILL
       If you have not enabled BBoards or POP then no further
       MTS-specific action is required on your part!

       If you have enabled POP, but you want to let _S_e_n_d_M_a_i_l
       deliver mail POP mail using its standard delivery program
       //bbiinn//mmaaiill, then, again, no further MTS-specific action is
       required on your part!

       Otherwise, go to the mts/sendmail/ directory.

       % cd ../mts/sendmail/

       This directory contains files whose definitions correspond
       to the configuration of your _S_e_n_d_M_a_i_l system.  If you have
       enabled BBoards or POP service, then you will need to
       re-configure _S_e_n_d_M_a_i_l.  First, in the "local info" section
       of your site's _S_e_n_d_M_a_i_l configuration file, choose a free
       macro/class (B is used in this distribution), and add
       these lines:

            # BBoards support
            DBbboards
            CBbboards

       Second, immediately after the inclusion of the zerobase
       file, in the "machine dependent part of ruleset zero" sec-
       tion, add these lines:

            # resolve names for the BBoards system
            R$+<@$=B>      $#bboards$@$2$:$1        topic@bboards

       Be sure to use tabs when separating these fields.  Third,



[mh.6]                       MH.6.8.4                          18





MH-GEN(8)                                               MH-GEN(8)


       add the line

            include(bboardsMH.m4)

       after the line

            include(localm.m4)

       in your site's _S_e_n_d_M_a_i_l configuration file.  Finally, you
       should link the file mmttss//sseennddmmaaiill//bbbbooaarrddssMMHH..mm44 into your
       _S_e_n_d_M_a_i_l cf/ directory and re-configure _S_e_n_d_M_a_i_l.

       If you have enabled POP service, a similar procedure must
       be used on the POP service host, to re-configure _S_e_n_d_M_a_i_l.
       First, in the "local info" section of your site's _S_e_n_d_M_a_i_l
       configuration file, choose a free macro/class (P is used
       in this distribution), and add these lines:

            # POP support
            DPpop
            CPpop

       Second, immediately after the inclusion of the zerobase
       file, in the "machine dependent part of ruleset zero" sec-
       tion, add these lines:

            # resolve names for the POP system
            R$+<@$=P>      $#pop$@$2$:$1            subscriber@pop

       Be sure to use tabs when separating these fields.  Third,
       add the line

            include(popMH.m4)

       after the line

            include(localm.m4)

       in your site's _S_e_n_d_M_a_i_l configuration file.  Finally, you
       should link the file mmttss//sseennddmmaaiill//ppooppMMHH..mm44 into your _S_e_n_d_-
       _M_a_i_l cf/ directory and re-configure _S_e_n_d_M_a_i_l.

   MMMMDDFF
       If you want _M_M_D_F to be your transport service, and have
       NNOOTT specified "mmdf/smtp" (or "mmdf2/smtp") as your mts
       setting, then go to the mmdf/ directory.  (If you're using
       "mmdf/smtp" or "mmdf2/smtp" as your mts setting, then skip
       to the next section.)

       % cd ../mts/mmdf/

       This directory contains files whose definitions correspond
       to the configuration of your _M_M_D_F system.




[mh.6]                       MH.6.8.4                          19





MH-GEN(8)                                               MH-GEN(8)


       If you're running _M_M_D_F_-_I, then copy the following files
       from wherever you keep the _M_M_D_F sources to this directory:
       mmdf/h/ch.h, mmdf/h/conf.h, utildir/conf_util.h,
       utildir/ll_log.h, mmdf/h/mmdf.h, utildir/util.h,
       mmdf/mmdf_lib.a, and utildir/util_lib.a.

       If you're running _M_M_D_F_-_I_I, then copy the following files
       from where you keep the _M_M_D_F sources to this directory:
       h/ch.h, h/conf.h, h/dm.h, h/ll_log.h, h/mmdf.h, h/util.h,
       and lib/libmmdf.a

       If you have enabled bboards, then the directories ssuupp--
       ppoorrtt//bbbbooaarrddss//mmmmddffII and ssuuppppoorrtt//bbbbooaarrddss//mmmmddffIIII contain
       information you'll need to put a UCI BBoards channel in
       your _M_M_D_F configuration.  Similarly, if you have enabled
       option "mf" and are running _M_M_D_F_-_I, then the zzoott--
       nneett//mmff//mmmmddffII// directory contains information you'll need
       to put a _U_U_C_P channel in your _M_M_D_F_-_I configuration.
       Finally, the directory ssuuppppoorrtt//ppoopp//mmmmddffIIII contains infor-
       mation you'll need to put a POP channel in your _M_M_D_F_-_I_I
       configuration.

       Note that _M_M_D_F_-_I_I is distributed with the BBoards channel,
       although the version in the _M_H distribution might be more
       current, the version in the _M_M_D_F_-_I_I distribution has been
       tested with that revision of _M_M_D_F.

   MMMMDDFF//SSMMTTPP
       If you are using "mmdf/smtp" as your mts setting, then no
       further MTS-specific action is required on your part!

   MMMMDDFF22//SSMMTTPP
       If you are using "mmdf2/smtp" as your mts setting, then no
       further MTS-specific action is required on your part!

   SSTTAANNDD--AALLOONNEE DDEELLIIVVEERRYY
       If, instead, you want _M_H to handle its own mail delivery,
       then no further MTS-specific action is required on your
       part!

GGEENNEERRAATTIIOONN
       Go to the _M_H top-level directory and generate the system.

       % cd ../; make

       This will cause a complete generation of the _M_H system.
       If all goes well, proceed with installation.  If not, com-
       plain, as there "should be no problems" at this step.

IINNSSTTAALLLLAATTIIOONN
       If the directories you chose for the user-programs, sup-
       port-programs and manuals ("bin", "etc", "popdir", "slib-
       dir", and "mandir" in the ccoonnff//MMHH file) don't exist, you
       should create them at this point.



[mh.6]                       MH.6.8.4                          20





MH-GEN(8)                                               MH-GEN(8)


       Next, if you enabled support for the UCI BBoards facility,
       then create a login called "bboards" with the following
       characteristics: home directory is //uussrr//ssppooooll//bbbbooaarrddss//
       with mode 755 (actually, use the value for "bbhome" given
       in the _M_H configuration file), login shell is //bbiinn//ccsshh (or
       //bbiinn//sshh), and, encrypted password field is "*".  The
       "bboards" login should own the //uussrr//ssppooooll//bbbbooaarrddss// direc-
       tory.  In addition to creating //uussrr//ssppooooll//bbbbooaarrddss//, also
       create //uussrr//ssppooooll//bbbbooaarrddss//eettcc// and
       //uussrr//ssppooooll//bbbbooaarrddss//aarrcchhiivvee//.  These directories should
       also be owned by the "bboards" login.

       If you enabled support for POP, then on the POP service
       host, create a login called "pop" with the following char-
       acteristics: home directory is //uussrr//ssppooooll//ppoopp// with mode
       755, login shell is //bbiinn//ccsshh, and, encrypted password
       field is "*".  If you don't have //bbiinn//ccsshh on your system
       (V7), then //bbiinn//sshh is just fine.  The "pop" login should
       own the //uussrr//ssppooooll//ppoopp// directory.  You'll also need to
       add a line to the //eettcc//sseerrvviicceess file and the //eettcc//rrcc..llooccaall
       file, see the _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e  for more details.

       If this is not the first time you have installed _M_H, these
       files will need particular attention:

            _D_i_r_e_c_t_o_r_y                 _F_i_l_e_s
            "etc/"                    MailAliases, BBoardAliases, mtstailor
            /usr/spool/bboards/       BBoards, .cshrc, .mh_profile
            /usr/spool/bboards/etc/   *

       The MMaaiillAAlliiaasseess, BBBBooaarrddAAlliiaasseess, mmttssttaaiilloorr and BBBBooaarrddss
       files will NNOOTT be installed over existing copies; you will
       need to edit these by hand and merge in any changes from
       your previous _M_H release.  The other files under
       //uussrr//ssppooooll//bbbbooaarrddss// will be overwritten if they exist.
       You may wish to preserve your old versions of these before
       installing _M_H.

       As the super-user, and from the mh.6/ directory, install
       the system.

       # make inst-all

       This will cause the _M_H processes and files to be trans-
       ferred to the appropriate areas with the appropriate
       attributes.

TTAAIILLOORRIINNGG
       See the _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e for information on tailoring
       _M_H for the MTS, BBoards, and POP.

DDOOCCUUMMEENNTTAATTIIOONN
       In addition to this document, the _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e,
       and the _U_s_e_r_'_s _M_a_n_u_a_l, there are several documents



[mh.6]                       MH.6.8.4                          21





MH-GEN(8)                                               MH-GEN(8)


       referenced by the user's manual which may be useful.  The
       sources for all of these can be found under the ppaappeerrss//
       directory.

OOTTHHEERR TTHHIINNGGSS
       Consult the directory mmiisscceellllaannyy// for the sources to a
       number of things which aren't part of the mainstream _M_H
       distribution, but which are still quite useful.

FFIILLEESS
       Too numerous to mention.  Really.

SSEEEE AALLSSOO
       make(1)

BBUUGGSS
       The _m_h_c_o_n_f_i_g program should be smarter.

       There's no way to print the _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e until
       after you have configured the system; it is difficult to
       configure the system without the _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s _G_u_i_d_e.

       The Makefiles should know when _m_h_c_o_n_f_i_g has been run and
       force "make clean" behavior.

































[mh.6]                       MH.6.8.4                          22