








       SSmmaaiill -- IInnssttaallllaattiioonn aanndd AAddmmiinniissttrraattiioonn GGuuiiddee

            _R_o_n_a_l_d _S_. _K_a_r_r _<_t_r_o_n_@_u_t_s_._a_m_d_a_h_l_._c_o_m_>
          _L_a_n_d_o_n _C_u_r_t _N_o_l_l _<_c_h_o_n_g_o_@_u_t_s_._a_m_d_a_h_l_._c_o_m_>
                        Amdahl Corp.
                    1250 E. Arques Ave.
                 Sunnyvale, CA  94088-3470



                          _A_B_S_T_R_A_C_T



          SSmmaaiill33..11  is a router and transport agent for
     mail.  It receives  mail  messages  and  recipient
     addresses  from  local  users  and  remote  hosts,
     routes mail destined for  remote  hosts,  performs
     alias  and  forwarding  transformations  on  local
     addresses and performs  delivery.   SSmmaaiill  can  be
     used  in  any  networking environment that expects
     mail to conform to the DDN mail format  standards;
     for  example, the ARPAnet, CS-Net and the interna-
     tional UUCP network.

          The mailer can be used to route mail  between
     any  number  of conforming networks, and can use a
     variety of methods for determining  the  namespace
     on  those  networks  and performing delivery.  The
     three mutually orthogonal operations of  aliasing,
     host  routing  and  transport are all handled in a
     consistent manner  with  consistent  configuration
     file  formats  and C language drivers to implement
     the basic capabilities.

          A number of tools are included in  the  smail
     distribution  which  are useful in building, main-
     taining and displaying databases.  Some  of  these
     tools  operate  on  databases  used  by the mailer
     itself.  Others are  useful  for  users  and  site
     administrators.

          This  paper  describes the ssmmaaiill installation
     procedure, the methodologies to use in  construct-
     ing  configurations, tools for building databases,
     and   administration   concerns   that   must   be
     addressed.



8 June 1994















                 SSmmaaiill -- IInnssttaallllaattiioonn aanndd AAddmmiinniissttrraattiioonn GGuuiiddee

                      _R_o_n_a_l_d _S_. _K_a_r_r _<_t_r_o_n_@_u_t_s_._a_m_d_a_h_l_._c_o_m_>
                    _L_a_n_d_o_n _C_u_r_t _N_o_l_l _<_c_h_o_n_g_o_@_u_t_s_._a_m_d_a_h_l_._c_o_m_>
                                  Amdahl Corp.
                              1250 E. Arques Ave.
                           Sunnyvale, CA  94088-3470


          11..  IInnttrroodduuccttiioonn

               The  ssmmaaiill33..11 program and its associated utilities were
          developed to provide an extensible mailer that  conforms  to
          the  DDN  mail  format  standards in the ARPAnet _R_e_q_u_e_s_t _F_o_r
          _C_o_m_m_e_n_t documents RFC822, RFC920 and RFC976.   It  can  also
          accept  and  transmit  mail  conforming  to the transmission
          envelope format standard described in RFC821.

               A major design goal was to provide extensibility in the
          methods  employed  for resolving local and remote addresses,
          and in the methods used for performing mail delivery.   This
          extensibility is provided through drivers that provide basic
          services on the level of C language  subroutines,  and  run-
          time  configuration files which define parameters that spec-
          ify how these drivers are to used.  The run-time  configura-
          tion  files  are not required, and if they do not exist then
          pre-loaded configurations are used.  This allows many  sites
          to operate with no run-time configuration files.

               Another  goal  was  to  provide a reliable mail service
          that was tolerant of system crashes and capable of  recover-
          ing  from  configuration errors.  To a limited extent, smail
          was also designed to recover from file systems that run  out
          of  space, and from log files that cannot be opened or writ-
          ten to.

               In addition to these and other goals, we felt  that  it
          was  also important that ssmmaaiill be compatible with the exter-
          nal interface of the Berkeley sseennddmmaaiill program.   This  com-
          patibility  applies to the command line options, to as large
          an extent as was feasible, but does not apply to either  the
          internal   operation  or  the  configuration  file  formats.
          Indeed the configuration files for ssmmaaiill  and  for  sseennddmmaaiill
          differ  not only in their format, but also in their philoso-
          phy and in what they describe.  The  sseennddmmaaiill  configuration
          files  describe a syntax-directed model of recipient address
          routing, while the  ssmmaaiill  configuration  files  describe  a
          database  model  of  recipient  address  routing,  and local
          address matching and expansion.








