SA(1M)                               SysV                               SA(1M)



NAME
     sa, accton - system accounting

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

     /etc/accton [ file ]

DESCRIPTION
     When you specify 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.

     The sa command 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 100 blocks
     per day.  The summary file is normally read before the accounting file,
     so the reports include all available information.

     If a filename is given as the last argument, that file is treated as the
     accounting file; /usr/adm/acct 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 averaged
     core usage (in 1k units), "avio" for average number of I/O operations 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 sometimes appear.

OPTIONS
     -a        Prints all command names, even those containing unprintable
               characters and those used only once.  By default, those are
               placed under the name "***other."

     -b        Sorts output by sum of user and system time divided by number
               of calls.  The default sort is by sum of user and system times.

     -c        Prints percentage of total time over all commands, in addition
               to total user, system, and real time for each command.

     -d        Sorts by average number of disk I/O operations.

     -D        Prints and sorts by total number of disk I/O operations.

     -f        Forces no interactive threshold compression with -v flag.

     -i        Does not read in summary file.

     -j        Givse seconds per call, instead of total minutes time for each
               category.

     -k        Sorts by cpu-time average memory usage.

     -K        Prints and sort by cpu-storage integral.

     -l        Separates system and user time; normally they are combined.

     -m        Prints number of processes and number of CPU minutes for each
               user.

     -n        Sorts by number of calls.

     -r        Reverses order of sort.

     -s        Merges accounting file into summary file /usr/adm/savacct when
               done.

     -t        Reports ratio of real time to sum of user and system times for
               each command.

     -u        Prints user ID and command name for each command in the
               accounting file, superseding all other flags.

     -vn       Followed by a number n, types the name of each command used n
               times or fewer.  Awaits a reply from the terminal; if it begins
               with "y", adds the command to the category "**junk**."  This is
               used to strip out garbage.

     -S savacctfile
               The file savacctfile becomes the command summary file instead
               of /usr/adm/savacct.

     -U usracctfile
               The file usracctfile becomes the per-user statistics file
               instead of /usr/adm/usracct to accumulate the -m option output.

FILES
     /usr/adm/acct       Raw accounting

     /usr/adm/savacct
                         Summary

     /usr/adm/usracct
                         Per-user summary

NOTES
     The /usr/adm directory is usually a link to `node_data/system_logs.  This
     allows you to have a separate accounting file for each node, if you run
     accounting on diskless nodes.

SEE ALSO
     acct(2)