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 into a summary
file which contains a count of the number of times each com-
mand was called and the time resources consumed. This con-
densation is desirable because on a large system can grow by
10000 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; is the default.
Output fields are labeled: `cpu' for the sum of user and
system times (in minutes), `re' for real time (also in min-
utes), `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 sometimes 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 Assume answer `y' for option -v.
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 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 userid 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
raw accounting
summary
per-user summary
SEE ALSO
ac(8), acct(2)
SA(8) SA(8)
BUGS
Sa needs more options.