Return to sa.8 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man8

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

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