|
|
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.