SA(8)                                                       SA(8)

     NAME
          sa, accton - system accounting

     SYNOPSIS
          /etc/sa [ -abcdDfgijkKlnrstuv ] [ -e prefix ] [ file ]

          /etc/accton [ file ]

     DESCRIPTION
          With an argument naming an existing file, accton causes sys-
          tem 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 summary 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 10000 blocks per
          day.  The summary file is normally read before the account-
          ing 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 IO operations per execution.  With options
          fields labelled `tio' for total IO 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 zillions of options:

          a    Place all command names containing unprintable charac-
               ters 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 com-
               mand print percentage of total time over all commands.

     SA(8)                                                       SA(8)

          d    Sort by average number of disk IO operations.

          D    Sort by total number of disk IO operations.

          e    Set the prefix for accounting file names to the next
               argument (/usr/adm/ is the default).

          f    Force no interactive threshold compression with -v
               flag.

          g    Ignore /usr/adm/acct.  Useful for processing only
               savacct and usracct.

          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 com-
               bined.

          m    (money) 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 termi-
               nal; if it begins with `y', add the command to the cat-
               egory `**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

     SA(8)                                                       SA(8)

          ac(8), acct(2)

     BUGS
          Needs more options.