Annotation of researchv10dc/man/man8/sa.8, revision 1.1.1.1

1.1       root        1: .TH SA 8
                      2: .CT 1 sa_nonmortals
                      3: .SH NAME
                      4: sa, accton \- system accounting
                      5: .SH SYNOPSIS
                      6: .B /etc/sa
                      7: [
                      8: .B -abcdDfgijkKlnrstuv
                      9: ]
                     10: [
                     11: .B -e prefix
                     12: ]
                     13: [
                     14: .I file
                     15: ]
                     16: .PP
                     17: .B /etc/accton
                     18: [
                     19: .I file
                     20: ]
                     21: .SH DESCRIPTION
                     22: With an argument naming an existing
                     23: .I file,
                     24: .I accton
                     25: causes system accounting information for
                     26: every process executed to be placed at the end of the file.
                     27: If no argument is given, accounting is turned off.
                     28: .PP
                     29: .I Sa
                     30: reports on, cleans up, and generally maintains
                     31: accounting files.
                     32: .PP
                     33: .I Sa
                     34: is able to condense
                     35: the information in
                     36: .F /usr/adm/acct
                     37: into a summary file
                     38: .F /usr/adm/savacct
                     39: which contains a count of the
                     40: number of times each command was called and the time resources
                     41: consumed.
                     42: This condensation is desirable because on a large system
                     43: .F /usr/adm/acct
                     44: can grow by 10000 blocks per day.
                     45: The summary file is normally read before the accounting file,
                     46: so the reports include all available information.
                     47: .PP
                     48: If a file name is given as the last argument,
                     49: that file will be treated
                     50: as the accounting file;
                     51: .F /usr/adm/acct
                     52: is the default.
                     53: .PP
                     54: Output fields are labeled:
                     55: .L cpu
                     56: for the sum of user and system times
                     57: (in minutes),
                     58: .L re
                     59: for real time (also in minutes),
                     60: .L k
                     61: for cpu-time averaged core usage (in 1K units),
                     62: .L avio
                     63: for average number of IO operations per execution.
                     64: With options fields labelled
                     65: .L tio
                     66: for total IO operations,
                     67: .L k*sec
                     68: for cpu storage integral (kilo-core seconds), 
                     69: .L u
                     70: and 
                     71: .L s
                     72: for user and system cpu time alone (both in minutes) will sometimes
                     73: appear.
                     74: .PP
                     75: There are zillions of options:
                     76: .TP
                     77: .B a
                     78: Place all command names containing unprintable characters
                     79: and those used only once under the name
                     80: .LR ***other .
                     81: .TP
                     82: .B b
                     83: Sort output by sum of user and system time divided by number of
                     84: calls.
                     85: Default sort is by sum of user and system times.
                     86: .TP
                     87: .B c
                     88: Besides total user, system, and real time for each command print percentage
                     89: of total time over all commands.
                     90: .TP
                     91: .B d
                     92: Sort by average number of disk IO operations.
                     93: .TP
                     94: .B D
                     95: Sort by total number of disk IO operations.
                     96: .TP
                     97: .B e
                     98: Set the prefix for accounting file names to the next argument
                     99: .RB ( /usr/adm/
                    100: is the default).
                    101: .TP
                    102: .B f
                    103: Assume answer
                    104: .L y
                    105: for option
                    106: .BR -v .
                    107: .TP
                    108: .B g
                    109: Ignore
                    110: .BR /usr/adm/acct .
                    111: Useful for processing only
                    112: .L savacct
                    113: and
                    114: .LR usracct .
                    115: .TP
                    116: .B i
                    117: Don't read in summary file.
                    118: .TP
                    119: .B j
                    120: Instead of total minutes time for each category,
                    121: give seconds per call.
                    122: .TP
                    123: .B k
                    124: Sort by cpu-time average memory usage.
                    125: .TP
                    126: .B K
                    127: Print and sort by cpu-storage integral.
                    128: .TP
                    129: .B l
                    130: Separate system and user time; normally they are combined.
                    131: .TP
                    132: .B m
                    133: (money) Print number of processes and number of CPU minutes for each user.
                    134: .TP
                    135: .B n
                    136: Sort by number of calls.
                    137: .TP
                    138: .B r
                    139: Reverse order of sort.
                    140: .TP
                    141: .B s
                    142: Merge accounting file into summary file
                    143: .F /usr/adm/savacct
                    144: when done.
                    145: .TP
                    146: .B t
                    147: For each command report ratio of real time to the sum of user and
                    148: system times.
                    149: .TP
                    150: .B u
                    151: Superseding all other flags,
                    152: print for each command in the accounting file the
                    153: userid and command name.
                    154: .TP
                    155: .B v
                    156: Followed by a number
                    157: .I n,
                    158: types the name of
                    159: each command used
                    160: .I n
                    161: times or fewer.
                    162: Await a reply from the terminal;
                    163: if it begins with 
                    164: .LR y ,
                    165: add the command to
                    166: the category
                    167: .LR **junk** .
                    168: This is used to strip out garbage.
                    169: .SH FILES
                    170: .TF /usr/adm/usracct
                    171: .TP
                    172: .F /usr/adm/acct
                    173: raw accounting
                    174: .TP
                    175: .F /usr/adm/savacct
                    176: summary
                    177: .TP
                    178: .F /usr/adm/usracct
                    179: per-user summary
                    180: .SH "SEE ALSO"
                    181: .IR ac (8), 
                    182: .IR acct (2)
                    183: .SH BUGS
                    184: .I Sa
                    185: needs more options.

unix.superglobalmegacorp.com

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