read-me

早期freebsd实现

     Before proceeding, 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 CHANGES.  The source is in
     papers/changes/.

     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 conf/
     directory, re-edit the files MH and conf/config/mtstailor,
     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).

  SENDMAIL
     If you have not enabled BBoards or POP then no further



[mh.6]                Last change: MH.6.8.3                    17






MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)



     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
     /bin/mail, 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,
     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 mts/sendmail/bboardsMH.m4 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



[mh.6]                Last change: MH.6.8.3                    18






MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)



     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 mts/sendmail/popMH.m4 into your _S_e_n_d_-
     _M_a_i_l cf/ directory and re-configure _S_e_n_d_M_a_i_l.

  MMDF
     If you want _M_M_D_F to be your transport service, and have NOT
     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.

     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
     support/bboards/mmdfI and support/bboards/mmdfII 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 zotnet/mf/mmdfI/
     directory contains information you'll need to put a _U_U_C_P
     channel in your _M_M_D_F-_I configuration.  Finally, the direc-
     tory support/pop/mmdfII contains information you'll need to
     put a POP channel in your _M_M_D_F-_I_I configuration.



[mh.6]                Last change: MH.6.8.3                    19






MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)



     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.

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

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

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

GENERATION
     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, complain,
     as there "should be no problems" at this step.

INSTALLATION
     If the directories you chose for the user-programs,
     support-programs and manuals ("bin", "etc", "popdir", "slib-
     dir", and "mandir" in the conf/MH file) don't exist, you
     should create them at this point.

     Next, if you enabled support for the UCI BBoards facility,
     then create a login called "bboards" with the following
     characteristics: home directory is /usr/spool/bboards/ with
     mode 755 (actually, use the value for "bbhome" given in the
     _M_H configuration file), login shell is /bin/csh (or
     /bin/sh), and, encrypted password field is "*".  The
     "bboards" login should own the /usr/spool/bboards/ direc-
     tory.  In addition to creating /usr/spool/bboards/, also
     create /usr/spool/bboards/etc/ and
     /usr/spool/bboards/archive/.  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 charac-
     teristics: home directory is /usr/spool/pop/ with mode 755,
     login shell is /bin/csh, and, encrypted password field is
     "*".  If you don't have /bin/csh on your system (V7), then
     /bin/sh is just fine.  The "pop" login should own the
     /usr/spool/pop/ directory.  You'll also need to add a line



[mh.6]                Last change: MH.6.8.3                    20






MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)



     to the /etc/services file and the /etc/rc.local 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 MailAliases, BBoardAliases, mtstailor and BBoards files
     will NOT be installed over existing copies; you will need to
     edit these by hand and merge in any changes from your previ-
     ous _M_H release.  The other files under /usr/spool/bboards/
     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 transferred
     to the appropriate areas with the appropriate attributes.

TAILORING
     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.

DOCUMENTATION
     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 referenced by
     the user's manual which may be useful.  The sources for all
     of these can be found under the papers/ directory.

OTHER THINGS
     Consult the directory miscellany/ for the sources to a
     number of things which aren't part of the mainstream _M_H dis-
     tribution, but which are still quite useful.

FILES
     Too numerous to mention.  Really.

SEE ALSO
     make(1)

BUGS
     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



[mh.6]                Last change: MH.6.8.3                    21






MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)



     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]                Last change: MH.6.8.3                    22