2.11BSD#431 - /usr/man/cat8/sa.0

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


NAME
     sa - system accounting

SYNOPSIS
     sa [ -abcdDfijkKlnrstu ] [ -v threshold ] [ -S savacctfile ]
     [ -U usracctfile ] [ file ]

DESCRIPTION
     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 100 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 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.

     There are near a googol of options:

     a	  Print all command names, even those containing unprint-
	  able characters 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 com-
	  mand 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/26/99	November 16, 1996			1


SA(8)		    UNIX 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 com-
	  bined.

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

     U	  The following filename is used instead of
	  /usr/adm/usracct 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), accton(8), acctd(8)

BUGS
     The number of options to this program is absurd.


Printed 11/26/99	November 16, 1996			2