![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to sa.8 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / sa|
Return to sa.8 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / sa |
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.