read-me

早期freebsd实现

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



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

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

      NOIOCTLH
           Tells _M_H not to include the file <sys/ioctl.h>.  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 ntohl() macro when processing _m_s_h
           binary map files.  _M_H can use this macro on systems
           with the include file netinet/in.h, 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
           Include this option if your system has a rename()
           library call.  This is true on BSD42 and newer and
           some SYS5 systems.

      SENDMAILBUG
           Causes SMTP reply code 451 (failure) to be considered
           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



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






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



           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 offer-
           ing 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 <dirent.h>
           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 ld doesn't handle
           `-x -r' correctly.

      TERMINFO
           Define TERMINFO if you have it.  You get it automati-
           cally if you're running SYS5, and you don't get it if
           you're not.  (If you're not SYS5, you probably have
           termcap.)

      TZNAME
           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-timezones (see
           the ATZ option).  See also ZONEINFO.

      UNISTD
           Include this option if your system has the file
           <unistd.h>.  If not specified, the LOCKF option will
           include <sys/fcntl.h>.

      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



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






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



           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 sys-
           tem 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 element
           (see /usr/include/time.h).  With this fix the GMT
           offset specified in outgoing mail will be corrected
           when the TZ enviornment variable is set to a different
           time zone.  See also TZNAME.

Site Preferences
   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 possible.
          You should not use this option if you are on the Inter-
          net, since it will make your host non-compliant with
          RFC-1123 (Requirements for Internet Hosts).

     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



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






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



          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-protection.
          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 interface.
          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 specified
          in RFC 1341 -- a major win.  This allows you 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 pro-
          vided to encode and decode MIME messages.  For more
          details, see miscellany/multi-media/READ-ME and _m_h_n(1).

     MSGID
          Enables slocal to detect and surpress duplicate mes-
          sages received.  This code uses the <ndbm.h> 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-protection.
          For example, MSGPROT='"0600"'.  The default is "0644".

     NOMHSEQ
          Directs _M_H to make private sequences the default.



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






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



     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 not in the public domain, the _M_H support
          for the TTI TMA is 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.
          Third, the first line of the file file $HOME/.signature
          is used as the _F_u_l_l _N_a_m_e part of your "From:" header.
          This may conflict with the interpretation 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 %(year) 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 %(modulo 100) func-
          tion to obtain a 2-digit year value.  After a short
          grace period, remove `YEARMOD' and re-
          {configure,generate,install} everything.



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






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



Testing/debugging
  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 read-
       ing 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 conf/config/mtstailor, 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 conf/tailor/mhmts; for
     an mts setting of "sendmail", "sendmail/smtp", "mmdf/smtp",
     or "mmdf2/smtp", look at the file conf/tailor/sendmts; and,
     for an mts setting of "mmdf", or  "mmdf2", look at the file
     conf/tailor/mmdf.

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

     % make
     % ./mhconfig MH