Annotation of cci/usr/src/man/man8/sa.8, revision 1.1.1.1

1.1       root        1: .TH SA 8 "20 April 1980"
                      2: .SH NAME
                      3: sa, accton \- system accounting
                      4: .SH SYNOPSIS
                      5: .B /etc/sa
                      6: [
                      7: .B \-abcdDfijkKlnrstuv
                      8: ] [ file ]
                      9: .PP
                     10: .B /etc/accton 
                     11: [ file ]
                     12: .SH DESCRIPTION
                     13: With an argument naming an existing
                     14: .I file,
                     15: .I accton
                     16: causes system accounting information for
                     17: every process executed to be placed at the end of the file.
                     18: If no argument is given, accounting is turned off.
                     19: .PP
                     20: .I Sa
                     21: reports on, cleans up, and generally maintains accounting files.
                     22: .PP
                     23: .I Sa
                     24: is able to condense the information in
                     25: .I /usr/adm/acct
                     26: into a summary file
                     27: .I /usr/adm/savacct
                     28: which contains a count of the
                     29: number of times each command was called and the time resources consumed.
                     30: This condensation is desirable because on a large system
                     31: .I /usr/adm/acct
                     32: can grow by 100 blocks per day.
                     33: The summary file is normally read before the accounting file,
                     34: so the reports include all available information.
                     35: .PP
                     36: If a file name is given as the last argument, that file will be treated
                     37: as the accounting file;
                     38: .I /usr/adm/acct
                     39: is the default.
                     40: .PP
                     41: Output fields are labeled: \*(lqcpu\*(rq for the sum of user+system time
                     42: (in minutes), \*(lqre\*(rq for real time (also in minutes),
                     43: \*(lqk\*(rq for cpu-time averaged core usage (in 1k units),
                     44: \*(lqavio\*(rq for average number of i/o operations per execution.
                     45: With options fields labeled \*(lqtio\*(rq for total i/o operations,
                     46: \*(lqk*sec\*(rq for cpu storage integral (kilo-core seconds), \*(lqu\*(rq and \*(lqs\*(rq
                     47: for user and system cpu time alone (both in minutes) will sometimes appear.
                     48: .PP
                     49: There are near a googol of options:
                     50: .PP
                     51: .TP
                     52: a
                     53: Place all command names containing unprintable characters
                     54: and those used only once under the name `***other.'
                     55: .TP
                     56: b
                     57: Sort output by sum of user and system time divided by number of calls.
                     58: Default sort is by sum of user and system times.
                     59: .TP
                     60: c
                     61: Besides total user, system, and real time for each command print percentage
                     62: of total time over all commands.
                     63: .TP
                     64: d
                     65: Sort by average number of disk i/o operations.
                     66: .TP
                     67: D
                     68: Print and sort by total number of disk i/o operations.
                     69: .TP
                     70: f
                     71: Force no interactive threshold compression with \-v flag.
                     72: .TP
                     73: i
                     74: Don't read in summary file.
                     75: .TP
                     76: j
                     77: Instead of total minutes time for each category, give seconds per call.
                     78: .TP
                     79: k
                     80: Sort by cpu-time average memory usage.
                     81: .TP
                     82: K
                     83: Print and sort by cpu-storage integral.
                     84: .TP
                     85: l
                     86: Separate system and user time; normally they are combined.
                     87: .TP
                     88: m
                     89: Print number of processes and number of CPU minutes for each user.
                     90: .TP
                     91: n
                     92: Sort by number of calls.
                     93: .TP
                     94: r
                     95: Reverse order of sort.
                     96: .TP
                     97: s
                     98: Merge accounting file into summary file
                     99: .I /usr/adm/savacct
                    100: when done.
                    101: .TP
                    102: t
                    103: For each command report ratio of real time to the sum of user and system times.
                    104: .TP
                    105: u
                    106: Superseding all other flags, print for each command in the accounting file the
                    107: user ID and command name.
                    108: .TP
                    109: v
                    110: Followed by a number
                    111: .I n,
                    112: types the name of each command used
                    113: .I n
                    114: times or fewer.
                    115: Await a reply from the terminal; if it begins with `y', add the command to
                    116: the category `**junk**.' This is used to strip out garbage.
                    117: .dt
                    118: .SH FILES
                    119: .ta 2i
                    120: /usr/adm/acct  raw accounting
                    121: .br
                    122: /usr/adm/savacct       summary
                    123: .br
                    124: /usr/adm/usracct       per-user summary
                    125: .SH "SEE ALSO"
                    126: ac(8), acct(2)
                    127: .SH BUGS
                    128: The number of options to this program is absurd.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.