


CHECKERR(8)                                           CHECKERR(8)


NNAAMMEE
       checkerr - check for serious errors encountered by smail

SSYYNNOOPPSSIISS
       //uussrr//lliibb//mmaaiill//cchheecckkeerrrr

DDEESSCCRRIIPPTTIIOONN
       _C_h_e_c_k_e_r_r reads through the spool area used by _s_m_a_i_l(8) and
       looks for serious processing  errors  detected  by  smail.
       Whenever  new  errors are detected, a summary is mailed to
       ``Postmaster,'' which is assumed to be an address for  the
       user who is responsible for maintaining the smail software
       and configuration.  In  addition  to  this,  a  number  of
       cleanup operations are performed.

       _C_h_e_c_k_e_r_r  should  be  run periodically from _c_r_o_n(8).  Once
       per day should be sufficient.  Make certain that  checkerr
       is  executed  under  a user and group ID that can write to
       the directories in the smail spool areas.

       The _c_h_e_c_k_e_r_r detects message spool files under  the  smail
       _e_r_r_o_r  directory.   If  any  files have appeared since the
       last time _c_h_e_c_k_e_r_r was executed, a summary  is  mailed  to
       the  Postmaster.   A  quick  check is made to determine if
       mail to ``Postmaster'' will actually succeed.  If not, the
       error summary is left in the file _._c_h_e_c_k_e_r_r_o_r in the _e_r_r_o_r
       directory.

       The error summary mailed to the  Postmaster  will  include
       any  logged information pertaining to the failed messages.
       The per-message transaction log, the smail transaction log
       and the panic log are all used as sources of this informa-
       tion.

FFIILLEESS
       _/_u_s_r_/_l_i_b_/_m_a_i_l_/_c_o_n_f_i_g
                      The main smail configuration file.  A  sec-
                      ond  smail  configuration  file can also be
                      specified in _c_o_n_f_i_g.

       _/_b_i_n_/_s_m_a_i_l     The default executable used for  attempting
                      to  deliver error summaries to the postmas-
                      ter.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_l_o_g_/_l_o_g_f_i_l_e
                      The default name for  the  transaction  log
                      file.   This  can  be  changed in the smail
                      config file.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_l_o_g_/_O_L_D _/_l_o_g_f_i_l_e_._0
                      Archived version  of  the  transaction  log
                      file.              The            directory
                      "/usr/spool/smail/log/OLD" is changed to be
                      under   the  directory  where  the  logfile



Local                    31 January 1988                        1





CHECKERR(8)                                           CHECKERR(8)


                      resides, and thus can  be  changed  in  the
                      smail config file.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_l_o_g_/_O_L_D _/_l_o_g_f_i_l_e_._1_._Z
                      Previous  compressed archive version of the
                      transaction  log   file.    The   directory
                      "/usr/spool/smail/log/OLD" is changed to be
                      under  the  directory  where  the   logfile
                      resides,  and  thus  can  be changed in the
                      smail config file.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_l_o_g_/_p_a_n_i_c_l_o_g
                      The default name for the  panic  log  file.
                      This  can  be  changed  in the smail config
                      file.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_l_o_g_/_O_L_D _/_p_a_n_i_c_l_o_g_._0
                      Archive for the panic log file.   This  can
                      be changed in the smail config file.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_l_o_g_/_O_L_D _/_p_a_n_i_c_l_o_g_._1_._Z
                      Previous  compressed  archive for the panic
                      log file.  This can be changed in the smail
                      config file.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l
                      The  top  of the default smail spool direc-
                      tory tree.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_i_n_p_u_t
                      The directory into which incoming  messages
                      are  spooled.   Each file in this directory
                      has a unique 14 character name derived from
                      the message ID used internally by the _s_m_a_i_l
                      program.  Delivery is attempted  at  inter-
                      vals for each of these files.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_l_o_c_k
                      A directory containing lock files.  On sys-
                      tems which do not have  an  efficient  file
                      locking  primative, files are created under
                      this directory to prevent simultaneous pro-
                      cessing  of  messages by concurrant invoca-
                      tions of the _s_m_a_i_l program.

       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_m_s_g_l_o_g
                      A directory containing per-message transac-
                      tion  logs.  _S_m_a_i_l maintains these logfiles
                      to keep  track  of  which  recipients  have
                      received  a  particular  mail  message, and
                      what errors have so far  been  found  while
                      delivering.   These files are removed auto-
                      matically by smail processing of a  message
                      has completed.



Local                    31 January 1988                        2





CHECKERR(8)                                           CHECKERR(8)


       _/_u_s_r_/_s_p_o_o_l_/_s_m_a_i_l_/_e_r_r_o_r
                      If  a mail messages fails for a reason that
                      requires attendance by the site administra-
                      tor,  it  is  moved  into this directory to
                      prevent smail from  continuing  to  attempt
                      delivery.

SSEEEE AALLSSOO
       _c_r_o_n(8), _s_m_a_i_l(5) and _s_m_a_i_l(8).

CCOOPPYYRRIIGGHHTT
       Copyright(C)1987, 1988 Ronald S. Karr and Landon Curt Noll
       Copyright(C)1992 Ronald S. Karr
       See a file COPYING, distributed with the source  code,  or
       type  _s_m_a_i_l  _-_b_c  for distribution rights and restrictions
       associated with this software.









































Local                    31 January 1988                        3


