Commit | Line | Data |
---|---|---|
64c19a68 KM |
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 | .\" | |
31c2d36c | 5 | .\" @(#)sa.8 6.2 (Berkeley) %G% |
64c19a68 | 6 | .\" |
ecd14fb4 | 7 | .TH SA 8 "" |
64c19a68 | 8 | .UC 4 |
31c2d36c | 9 | .SH NAME |
64c19a68 KM |
10 | sa, accton \- system accounting |
11 | .SH SYNOPSIS | |
12 | .B /etc/sa | |
13 | [ | |
14 | .B \-abcdDfijkKlnrstuv | |
ecd14fb4 KM |
15 | ] [ |
16 | .B \-S | |
17 | savacctfile ] [ | |
18 | .B \-U | |
19 | usracctfile ] [ file ] | |
64c19a68 KM |
20 | .PP |
21 | .B /etc/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 | |
9e110635 | 32 | reports on, cleans up, and generally maintains accounting files. |
64c19a68 KM |
33 | .PP |
34 | .I Sa | |
9e110635 | 35 | is able to condense the information in |
64c19a68 KM |
36 | .I /usr/adm/acct |
37 | into a summary file | |
38 | .I /usr/adm/savacct | |
39 | which contains a count of the | |
9e110635 | 40 | number of times each command was called and the time resources consumed. |
64c19a68 KM |
41 | This condensation is desirable because on a large system |
42 | .I /usr/adm/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 | |
9e110635 | 47 | If a file name is given as the last argument, that file will be treated |
64c19a68 KM |
48 | as the accounting file; |
49 | .I /usr/adm/acct | |
50 | is the default. | |
51 | .PP | |
9e110635 | 52 | Output fields are labeled: \*(lqcpu\*(rq for the sum of user+system time |
64c19a68 KM |
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. | |
9e110635 | 56 | With options fields labeled \*(lqtio\*(rq for total i/o operations, |
64c19a68 | 57 | \*(lqk*sec\*(rq for cpu storage integral (kilo-core seconds), \*(lqu\*(rq and \*(lqs\*(rq |
9e110635 | 58 | for user and system cpu time alone (both in minutes) will sometimes appear. |
64c19a68 KM |
59 | .PP |
60 | There are near a googol of options: | |
61 | .PP | |
62 | .TP | |
63 | a | |
ecd14fb4 KM |
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.' | |
64c19a68 KM |
67 | .TP |
68 | b | |
9e110635 | 69 | Sort output by sum of user and system time divided by number of calls. |
64c19a68 KM |
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 | |
9e110635 | 89 | Instead of total minutes time for each category, give seconds per call. |
64c19a68 KM |
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 /usr/adm/savacct | |
112 | when done. | |
113 | .TP | |
114 | t | |
9e110635 | 115 | For each command report ratio of real time to the sum of user and system times. |
64c19a68 KM |
116 | .TP |
117 | u | |
9e110635 | 118 | Superseding all other flags, print for each command in the accounting file the |
64c19a68 KM |
119 | user ID and command name. |
120 | .TP | |
121 | v | |
122 | Followed by a number | |
123 | .I n, | |
9e110635 | 124 | types the name of each command used |
64c19a68 KM |
125 | .I n |
126 | times or fewer. | |
9e110635 KM |
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. | |
ecd14fb4 KM |
129 | .TP |
130 | S | |
131 | The following filename is used as the command summary file instead of | |
132 | .I /usr/adm/savacct. | |
133 | .TP | |
134 | U | |
135 | The following filename is used instead of | |
136 | .I /usr/adm/usracct | |
137 | to accumulate the per-user statistics printed by the \-m option. | |
64c19a68 KM |
138 | .dt |
139 | .SH FILES | |
140 | .ta 2i | |
141 | /usr/adm/acct raw accounting | |
142 | .br | |
143 | /usr/adm/savacct summary | |
144 | .br | |
145 | /usr/adm/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. |