Return to sa.8 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / sa

Annotation of 43BSDReno/usr.sbin/sa/sa.8, revision 1.1

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