read-me

早期freebsd实现

          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" (form-
          erly "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.







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






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



  Post Office Protocol
     pop: off
          Support for POP service.  This allows local delivery
          for non-local users (a major win).  See
          support/pop/pop.rfc 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.

     popdir: /usr/etc
          The directory where the POP daemon (popd) 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 APOP command, and specifies the
            name of APOP authorization database.  The APOP com-
            mand provides a challenge-based authentication system
            using the MD5 message digest algorithm.  This facil-
            ity 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 popauth program to be
            installed, which allows the administrator to manipu-
            late the APOP authorization database.  For more
            details, see support/pop/pop-more.txt 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" pro-
            tocol.  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 XTND SCAN command which pro-
            vides performance enhancements when using the POP
            over low-speed connections.  This option also causes
            an interactive POP client program, popi, to be com-
            piled and installed.  A man page for the popi program
            is also provided.



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






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



            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 support/pop/pop-more.txt.  Note: this option
            requires "bboards: pop".

       POP2
            Have the POP daemon understand the older POP2 proto-
            col 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.

       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 pub-
            lished 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 service
            name is listed in your /etc/services 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 vari-
            ant of POP, RPOP, which uses privileged sockets for
            authentication be enabled.  This peacefully co-exists
            with the standard POP.

       SHADOW
            Indicates that the popd POP server can find encrypted
            passwords in the /etc/shadow file (and not in the
            /etc/passwd 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
         support/pop/pop-more.txt.  The "APOP" option peacefully
         co-exists with the standard POP.  The "MPOP" option
         requires "bboards: pop".

 Shared libraries
    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



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






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



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

      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 /usr/lib or /usr/local/lib is not
         advisable.

         If you must do this, be sure that you add the path given
         by slibdir 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").

 General System Dependencies
    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 /usr/spool/mail is not world-writeable.

         Note that slocal 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 slocal (and its man page)
         from your system.

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




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






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



    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 routine return
         an "int" type.

    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 vi and it exits with
           non-zero status.  Use on Sun OS 4.1 and other systems
           where the /usr/ucb/vi 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 /usr/etc/vipw).

      AUX
           Use with AUX systems.

      BIND
           If you are running with the BIND code on UNIX systems
           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 sys-
           log") 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 conditions 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



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






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



           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 /etc/passwd.  Without
           DBMPWD the entire passwd file is read into memory one
           entry at a time for alias expansion.  This is a per-
           formance improvement when reading a standard
           /etc/passwd file, but is _v_e_r_y slow on systems with 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 `&' charac-
           ter in the "gcos" field stands for the login name.

      FCNTL
           Directs _M_H to use the fcntl() system call for kernel-
           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 flock() system call for kernel-
           level locking.  If you're on a BSD42 system, and
           you're not using NFS to read or write maildrops, 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 lockf() system call for kernel-
           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 running
           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 mtstailor
           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



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