4.4BSD/usr/share/man/cat8/sa.0
SA(8) BSD System Manager's Manual SA(8)
NNAAMMEE
sa, accton - system accounting
SSYYNNOOPPSSIISS
ssaa [ --aabbccddDDffiijjkkKKllnnrrssttuuvv ] [ --SS savacctfile ] [ --UU usracct-
file ] [ file ]
aaccccttoonn [ file ]
DDEESSCCRRIIPPTTIIOONN
With an argument naming an existing _f_i_l_e_, _a_c_c_t_o_n 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.
_S_a reports on, cleans up, and generally maintains account-
ing files.
_S_a is able to condense the information in
_/_v_a_r_/_a_c_c_o_u_n_t_/_a_c_c_t into a summary file _/_v_a_r_/_a_c_c_o_u_n_t_/_s_a_v_a_c_c_t
which contains a count of the number of times each command
was called and the time resources consumed. This conden-
sation is desirable because on a large system
_/_v_a_r_/_a_c_c_o_u_n_t_/_a_c_c_t 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 file name is given as the last argument, that file
will be treated as the accounting file; _/_v_a_r_/_a_c_c_o_u_n_t_/_a_c_c_t
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
unprintable 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.
4th Berkeley Distribution June 6, 1993 1
SA(8) BSD System Manager's Manual SA(8)
c Besides total user, system, and real time for each
command 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 opera-
tions.
f Force no interactive threshold compression with -v
flag.
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
combined.
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
_/_v_a_r_/_a_c_c_o_u_n_t_/_s_a_v_a_c_c_t 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 com-
mand used _n times or fewer. Await a reply from the
terminal; 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 sum-
mary file instead of _/_v_a_r_/_a_c_c_o_u_n_t_/_s_a_v_a_c_c_t_.
U The following filename is used instead of
4th Berkeley Distribution June 6, 1993 2
SA(8) BSD System Manager's Manual SA(8)
_/_v_a_r_/_a_c_c_o_u_n_t_/_u_s_r_a_c_c_t to accumulate the per-user
statistics printed by the -m option.
FFIILLEESS
/var/account/acct raw accounting
/var/account/savacctsummary
/var/account/usracctper-user summary
SSEEEE AALLSSOO
ac(8), acct(2)
BBUUGGSS
The number of options to this program is absurd.
4th Berkeley Distribution June 6, 1993 3