SA(VIII) 6/1/74 SA(VIII)
NAME
sa - Shell accounting
SYNOPSIS
sa [ -abcjlnrstuv ] [ file ]
DESCRIPTION
When a user logs in, if the Shell is able to open the file
/usr/adm/sh_acct, then as each command completes the Shell
writes at the end of this file the name of the command, the
user, system, and real time consumed, and the user ID. Sa
reports on, cleans up, and generally maintains this and
other accounting files. To turn accounting on and off, the
accounting file must be created or destroyed externally.
Sa is able to condense the information in /usr/adm/sh_acct
into a summary file /usr/adm/sht_acct 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 sh_acct can grow by 100 blocks per day.
The summary file is 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; sh_acct is the default.
There are zillions 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.
j Instead of total minutes time for each category, give
seconds per call.
l Separate system and user time; normally they are
combined.
n Sort by number of calls.
r Reverse order of sort.
s Merge accounting file into summary file
/usr/adm/sht_acct 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 day of the year, time, day of the
week, user ID and command name.
v If the next character is a digit n, then type the name
of each command used n times or fewer. Await a reply
from the typewriter; if it begins with ``y'', add the
command to the category ``**junk**.'' This is used to
strip out garbage.
FILES
/usr/adm/sh_acct accounting
/usr/adm/sht_acct summary
SEE ALSO
ac (VIII)
BUGS