Return to sa.8 CVS log

Up to [Research Unix] / researchv10dc / man / man8

Annotation of researchv10dc/man/man8/sa.8, revision 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.

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