SA(8)                                                                    SA(8)



NAME
       sa, accton - system accounting

SYNOPSIS
       /etc/sa  [ -abcdDfijkKlnrstuv ] [ -S savacctfile ] [ -U usracctfile ] [
       file ]

       /etc/accton [ file ]

DESCRIPTION
       With an argument naming an existing _f_i_l_e_, _a_c_c_t_o_n causes system account‐
       ing  information  for every process executed to be placed at the end of
       the file.  If no argument is given, accounting is turned off.

       _S_a reports on, cleans up, and generally maintains accounting files.

       _S_a is able to condense the information in _/_u_s_r_/_a_d_m_/_a_c_c_t into a  summary
       file  _/_u_s_r_/_a_d_m_/_s_a_v_a_c_c_t  which  contains  a count of the number of times
       each command was called and the time resources consumed.  This  conden‐
       sation is desirable because on a large system _/_u_s_r_/_a_d_m_/_a_c_c_t can grow by
       100 blocks per day.  The summary  file  is  normally  read  before  the
       accounting file, so the reports include all available information.

       If a file name is given as the last argument, that file will be treated
       as the accounting file; _/_u_s_r_/_a_d_m_/_a_c_c_t is the default.

       Output fields are labeled: “cpu” for the sum of  user+system  time  (in
       minutes),  “re” for real time (also in minutes), “k” for cpu-time aver‐
       aged core usage (in 1k units), “avio” for average number of i/o  opera‐
       tions  per  execution.  With options fields labeled “tio” for total i/o
       operations, “k*sec” for cpu storage integral (kilo-core  seconds),  “u”
       and “s” for user and system cpu time alone (both in minutes) will some‐
       times appear.

       There are near a googol of options:


       a      Print all command names, even those containing unprintable char‐
              acters  and  those used only once.  By default, those are placed
              under the name ‘***other.’

       b      Sort output by sum of user and system time divided by number  of
              calls.  Default sort is by sum of user and system times.

       c      Besides total user, system, and real time for each command print
              percentage of total time over all commands.

       d      Sort by average number of disk i/o operations.

       D      Print and sort by total number of disk i/o operations.

       f      Force no interactive threshold compression with -v flag.

       i      Don’t read in summary file.

       j      Instead of total minutes time for each  category,  give  seconds
              per call.

       k      Sort by cpu-time average memory usage.

       K      Print and sort by cpu-storage integral.

       l      Separate system and user time; normally they are combined.

       m      Print  number  of  processes  and number of CPU minutes for each
              user.

       n      Sort by number of calls.

       r      Reverse order of sort.

       s      Merge accounting file into summary  file  _/_u_s_r_/_a_d_m_/_s_a_v_a_c_c_t  when
              done.

       t      For  each  command  report ratio of real time to the sum of user
              and system times.

       u      Superseding all other flags,  print  for  each  command  in  the
              accounting file the user ID and command name.

       v      Followed  by  a  number _n_, types the name of each command used _n
              times or fewer.  Await a reply from the terminal; if  it  begins
              with  ‘y’,  add  the command to the category ‘**junk**.’ This is
              used to strip out garbage.

       S      The following filename is  used  as  the  command  summary  file
              instead of _/_u_s_r_/_a_d_m_/_s_a_v_a_c_c_t_.

       U      The  following  filename  is used instead of _/_u_s_r_/_a_d_m_/_u_s_r_a_c_c_t to
              accumulate the per-user statistics printed by the -m option.

FILES
       /usr/adm/acct       raw accounting
       /usr/adm/savacct    summary
       /usr/adm/usracct    per-user summary

SEE ALSO
       ac(8), acct(2)

BUGS
       The number of options to this program is absurd.



4th Berkeley Distribution        July 29, 1985                           SA(8)