SA(8) BSD System Manager's Manual SA(8)NAME
sa - process system accounting logs
SYNOPSIS
sa -u [-S saveacctfile] [-U usracctfile] [acctfile]
sa [-s] [-abcdDfijkKlmnrt] [-v threshold] [-S saveacctfile] [-U
usracctfile] [acctfile]
DESCRIPTION
The sa utility is used to maintain and generate reports from the system
accounting files.
The summary accounting file is read before the accounting file so the re-
port includes previous system data.
The optional argument acctfile overrides the default system accounting
file /var/account/acct. By default sa will sort by cpu time.
The default output fields are labeled:
cpu sum of the user plus system time in minutes;
re real (wall clock) time in minutes;
k unused in the current implementation;
avio average number of I/O operations per execution;
cnt number of times the executable was executed.
The optional field labels are:
pct percent of of total time;
tio total I/O operations;
k*sec CPU memory usage integral in kilo-core seconds;
u user time in minutes;
s system time in minutes;
re/cpu real (wall clock) time divided by cpu time in minutes.
The flags are as follows:
-a Print all command names. By default command names containing un-
printable characters and those used only once are placed under
`***other'.
-b Sort by average cpu time used (cpu divided by cnt).
-c Add the percent field (labeled pct) that is the percentage of to-
tal time used by this command.
-d Sort by average number of I/O operations (avio).
-D Print and sort by the total number of I/O operations (tio, re-
places avio).
-f Force compression of junk files if using the -v flag.
-i Ignore the summary file and only report the contents of the
acctfile.
-j Report cpu field as seconds per execution.
-k Sort by CPU-time average memory usage.
-K Print and sort by the CPU memory usage integral (k*sec).
-l Print user and system time separately (under the u and s fields,
replacing the cpu field).
-m Summarize system resource usage by user. Some of the other flags
don't make sense with this option.
-n Sort by number of executions (cnt).
-r Reverse the order of any sort.
-s Merge the accounting records from acctfile into the summary files
savacctfile and usracctfile.
-t Print the ration of real (wall clock) time to cpu (re/cpu)
-u Print the command name and user ID for each record in the ac-
counting file. Overrides any other flags.
-v This argument allows you to filter out garbage. Sa will prompt
you for each command that was executed less than threshold times.
Responding with a y will cause that record to be added to the
`***junk' category. You can force this behavior using the -f
flag.
-S Override the default accounting summary file
/var/account/savacct.
-U Override the default per-user accounting file
/var/account/usracct (printed by -m).
The sa utility exits 0 on success, and >0 if an error occurs.
FILES
/var/account/acct system accounting file
/var/account/savacct accounting summary by command
/var/account/usracct accounting summary by user ID
SEE ALSOlastcomm(1), acct(2), acct(5), accton(8)HISTORY
A sa command appeared in Version 7 AT&T UNIX. This sa was written by
Andrew H. Marrinson <andy@terasil.terasil.com>.
BSDI BSD/OS February 12, 1998 2