.\" SCCSID: @(#)sa.8	8.2	4/9/91.TH sa 8.SH Namesa, accton \- print process accounting statistics.SH Syntax.B /etc/sa[.I options] [ .I file ].PP.B /etc/accton [ .I file ].SH Arguments.IP \fIfile\fR 8With an argument naming an existing.I file,.PN acctoncauses system accounting information forevery process executed to be placed at the end of the file.If no argument is given, accounting is turned off..SH Description.NXR "sa command".NXR "accton command".NXR "accounting file" "maintaining".PPThe.PN sacommandreports on, cleans up, and generally maintains accounting files..PPThe.PN sais able to condense the information in .PN /usr/adm/acctinto a summary file .PN /usr/adm/savacct ,which contains a count of thenumber of times each command was called and the time resources consumed.This condensation is desirable because on a large system.PN /usr/adm/acct can grow by 100 blocks per day.The summary file is normally read before the accounting file,so the reports include all available information..PPIf a file name is given as the last argument, that file will be treatedas the accounting file.  The file .PN /usr/adm/acct is the default..PPOutput fields are labeled: \*(lqcpu\*(rq for the sum of user+system time(in cpu seconds), \*(lqre\*(rq for real time (also in cpu seconds),\*(lqk\*(rq for cpu-time averaged core usage (in 1k units),\*(lqavio\*(rq for average number of I/O operations per execution.With options fields labeled \*(lqtio\*(rq for total I/O operations,\*(lqk*sec\*(rq for cpu storage integral (kilo-core seconds), \*(lqu\*(rq and \*(lqs\*(rqfor user and system cpu time alone (both in cpu seconds) will sometimes appear..SH Options.NXR "sa command" "options".IP \-a 8List all command names including those containing unprintable characters and those used only once. By default,.PN saplaces all command names containing unprintable characters and those used only onceunder the name `***other.'.IP \-bSort output by sum of user and system time divided by number of calls.Default sort is by sum of user and system times..IP \-cBesides total user, system, and real time for each command, print percentageof total time over all commands..IP \-dSort by average number of disk I/O operations..IP \-DPrint and sort by total number of disk I/O operations..IP \-fForce no interactive threshold compression with .PN \-v option..IP \-iDo not read in summary file..IP \-jInstead of total minutes for each category, give seconds per call..IP \-kSort by cpu-time average memory usage..IP \-KPrint and sort by cpu-storage integral..IP \-lSeparate system and user time; normally they are combined..IP \-mPrint number of processes and number of CPU minutes for each user..IP \-nSort by number of calls..IP \-rReverse order of sort..IP \-sMerge accounting file into summary file.PN /usr/adm/savacctwhen done..IP \-tFor each command, report ratio of real time to the sum of user and system times. If the sum of user and system times is too small to report, `*ignore*' appears in this field. .IP \-uSuperseding all other flags, print for each command in the accounting file theuser ID and command name..IP \-vFollowed by a number.I n,types the name of each command used.I ntimes or fewer.Await a reply from the terminal; if it begins with `y', add the command tothe category `**junk**.' This is used to strip out garbage..dt.SH RestrictionsAccounting is suspended when there is less than 2% freespace on disk.  Accounting resumes when free space risesabove 4%..SH Files.TP 17.PN /usr/adm/acctRaw accounting.TP.PN /usr/adm/savacctSummary.TP.PN /usr/adm/usracctPer-user summary.SH See Alsoacct(2), ac(8)