Commit | Line | Data |
---|---|---|
52a4e1c9 BJ |
1 | .TH SA 1M |
2 | .SH NAME | |
3 | sa, accton \- system accounting | |
4 | .SH SYNOPSIS | |
5 | .B sa | |
6 | [ | |
7 | .B \-abcjlnrstuv | |
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 arguemnt is given, accounting is turned off. | |
19 | .PP | |
20 | .I Sa | |
21 | reports on, cleans up, and generally maintains | |
22 | accounting files. | |
23 | .PP | |
24 | .I Sa | |
25 | is able to condense | |
26 | the information in | |
27 | .I /usr/adm/acct | |
28 | into a summary file | |
29 | .I /usr/adm/savacct | |
30 | which contains a count of the | |
31 | number of times each command was called and the time resources | |
32 | consumed. | |
33 | This condensation is desirable because on a large system | |
34 | .I /usr/adm/acct | |
35 | can grow by 100 blocks per day. | |
36 | The summary file is read before the accounting file, | |
37 | so the reports include all available information. | |
38 | .PP | |
39 | If a file name is given as the last argument, | |
40 | that file will be treated | |
41 | as the accounting file; | |
42 | .I /usr/adm/acct | |
43 | is the default. | |
44 | There are zillions of options: | |
45 | .PP | |
46 | .TP | |
47 | a | |
48 | Place all command names containing unprintable characters | |
49 | and those used only once under the name `***other.' | |
50 | .TP | |
51 | b | |
52 | Sort output by sum of user and system time divided by number of | |
53 | calls. | |
54 | Default sort is by sum of user and system times. | |
55 | .TP | |
56 | c | |
57 | Besides total user, system, and real time for each command print percentage | |
58 | of total time over all commands. | |
59 | .TP | |
60 | j | |
61 | Instead of total minutes time for each category, | |
62 | give seconds per call. | |
63 | .TP | |
64 | l | |
65 | Separate system and user time; normally they are combined. | |
66 | .TP | |
67 | m | |
68 | Print number of processes and number of CPU minutes for each user. | |
69 | .TP | |
70 | n | |
71 | Sort by number of calls. | |
72 | .TP | |
73 | r | |
74 | Reverse order of sort. | |
75 | .TP | |
76 | s | |
77 | Merge accounting file into summary file | |
78 | .I /usr/adm/savacct | |
79 | when done. | |
80 | .TP | |
81 | t | |
82 | For each command report ratio of real time to the sum of user and | |
83 | system times. | |
84 | .TP | |
85 | u | |
86 | Superseding all other flags, | |
87 | print for each command in the accounting file the | |
88 | user ID and command name. | |
89 | .TP | |
90 | v | |
91 | If the next character is a digit | |
92 | .I n, | |
93 | then type the name of | |
94 | each command used | |
95 | .I n | |
96 | times or fewer. | |
97 | Await a reply from the terminal; | |
98 | if it begins with `y', add the command to | |
99 | the category `**junk**.' | |
100 | This is used to strip out garbage. | |
101 | .dt | |
102 | .SH FILES | |
103 | .ta 2i | |
104 | /usr/adm/acct raw accounting | |
105 | .br | |
106 | /usr/adm/savacct summary | |
107 | .br | |
108 | /usr/adm/usracct per-user summary | |
109 | .SH "SEE ALSO" | |
110 | ac(1), acct(2) |