SA(8)                   GENIX Programmer's Manual                   SA(8)



      NAME
           sa, accton - system accounting

      SYNOPSIS
           /etc/sa [ -abcdDfijkKlnrstuv ] [ file ]

           /etc/accton [ file ]

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

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

           Sa is able to condense the information in /usr/adm/acct into a  sum-
           mary  file  /usr/adm/savacct which contains a count of the number of
           times each command was called and the time resources consumed.  This
           condensation  is  desirable  because on a large system /usr/adm/acct
           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; /usr/adm/acct is the default.

           Output fields are labelled: "cpu" for the sum  of  user+system  time
           (in minutes), "re" for real time (also in minutes), "k" for cpu-time
           averaged core usage (in 1k units), "avio" for average number of  i/o
           operations  per  execution.   With options fields labelled "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 sometimes appear.

           There are near a googol of options:

           a    Place all command names containing unprintable  characters  and
                those used only once 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.




      Printed 11/16/83                                                        1

      SA(8)                   GENIX Programmer's Manual                   SA(8)



           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  /usr/adm/savacct  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.

      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.













      Printed 11/16/83                                                        2