[unix-history] / usr / man / man1 / sa.1m

.TH SA 1M 
.SH NAME
sa, accton \- system accounting
.SH SYNOPSIS
.B sa
[
.B \-abcjlnrstuv
] [ file ]
.PP
.B /etc/accton 
[ file ]
.SH DESCRIPTION
With an argument naming an existing
.I file,
.I accton
causes system accounting information for
every process executed to be placed at the end of the file.
If no arguemnt is given, accounting is turned off.
.PP
.I Sa
reports on, cleans up, and generally maintains
accounting files.
.PP
.I Sa
is able to condense
the information in
.I /usr/adm/acct
into a summary file
.I /usr/adm/savacct
which contains a count of the
number of times each command was called and the time resources
consumed.
This condensation is desirable because on a large system
.I /usr/adm/acct
can grow by 100 blocks per day.
The summary file is read before the accounting file,
so the reports include all available information.
.PP
If a file name is given as the last argument,
that file will be treated
as the accounting file;
.I /usr/adm/acct
is the default.
There are zillions of options:
.PP
.TP
a
Place all command names containing unprintable characters
and those used only once under the name `***other.'
.TP
b
Sort output by sum of user and system time divided by number of
calls.
Default sort is by sum of user and system times.
.TP
c
Besides total user, system, and real time for each command print percentage
of total time over all commands.
.TP
j
Instead of total minutes time for each category,
give seconds per call.
.TP
l
Separate system and user time; normally they are combined.
.TP
m
Print number of processes and number of CPU minutes for each user.
.TP
n
Sort by number of calls.
.TP
r
Reverse order of sort.
.TP
s
Merge accounting file into summary file
.I /usr/adm/savacct
when done.
.TP
t
For each command report ratio of real time to the sum of user and
system times.
.TP
u
Superseding all other flags,
print for each command in the accounting file the
user ID and command name.
.TP
v
If the next character is a digit
.I n,
then type the name of
each command used
.I n
times or fewer.
Await a reply from the terminal;
if it begins with `y', add the command to
the category `**junk**.'
This is used to strip out garbage.
.dt
.SH FILES
.ta 2i
/usr/adm/acct	raw accounting
.br
/usr/adm/savacct	summary
.br
/usr/adm/usracct	per-user summary
.SH "SEE ALSO"
ac(1), acct(2)
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)