BSD 4_4 release

[unix-history] / usr / src / usr.sbin / sa / sa.8

diff --git a/usr/src/usr.sbin/sa/sa.8 b/usr/src/usr.sbin/sa/sa.8
index 7fc8eac..fe5eba9 100644 (file)
--- a/usr/src/usr.sbin/sa/sa.8
+++ b/usr/src/usr.sbin/sa/sa.8
@@ -1,20 +1,27 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.\"    @(#)sa.8        4.1 (Berkeley) %G%
+.\" This module is believed to contain source code proprietary to AT&T.
+.\" Use and redistribution is subject to the Berkeley Software License
+.\" Agreement and your Software Agreement with AT&T (Western Electric).

 .\"
 .\"

-.TH SA 8 4/20/80
+.\"    @(#)sa.8        8.1 (Berkeley) 6/6/93
+.\"
+.TH SA 8 "June 6, 1993"

 .UC 4
 .SH NAME
 sa, accton \- system accounting
 .SH SYNOPSIS
 .UC 4
 .SH NAME
 sa, accton \- system accounting
 .SH SYNOPSIS

-.B /etc/sa
+.B sa

 [
 .B \-abcdDfijkKlnrstuv
 [
 .B \-abcdDfijkKlnrstuv

-] [ file ]
+] [
+.B \-S
+savacctfile ] [
+.B \-U
+usracctfile ] [ file ]

 .PP
 .PP

-.B /etc/accton 
+.B accton 

 [ file ]
 .SH DESCRIPTION
 With an argument naming an existing
 [ file ]
 .SH DESCRIPTION
 With an argument naming an existing


@@ -25,49 +32,44 @@ every process executed to be placed at the end of the file.
 If no argument is given, accounting is turned off.
 .PP
 .I Sa
 If no argument is given, accounting is turned off.
 .PP
 .I Sa

-reports on, cleans up, and generally maintains
-accounting files.
+reports on, cleans up, and generally maintains accounting files.

 .PP
 .I Sa
 .PP
 .I Sa

-is able to condense
-the information in
-.I /usr/adm/acct
+is able to condense the information in
+.I /var/account/acct

 into a summary file
 into a summary file

-.I /usr/adm/savacct
+.I /var/account/savacct

 which contains a count of the
 which contains a count of the

-number of times each command was called and the time resources
-consumed.
+number of times each command was called and the time resources consumed.

 This condensation is desirable because on a large system
 This condensation is desirable because on a large system

-.I /usr/adm/acct
+.I /var/account/acct

 can grow by 100 blocks per day.
 The summary file is normally read before the accounting file,
 so the reports include all available information.
 .PP
 can grow by 100 blocks per day.
 The summary file is normally 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
+If a file name is given as the last argument, that file will be treated

 as the accounting file;
 as the accounting file;

-.I /usr/adm/acct
+.I /var/account/acct

 is the default.
 .PP
 is the default.
 .PP

-Output fields are labelled: \*(lqcpu\*(rq for the sum of user+system time
+Output fields are labeled: \*(lqcpu\*(rq for the sum of user+system time

 (in minutes), \*(lqre\*(rq for real time (also in minutes),
 \*(lqk\*(rq for cpu-time averaged core usage (in 1k units),
 \*(lqavio\*(rq for average number of i/o operations per execution.
 (in minutes), \*(lqre\*(rq for real time (also in minutes),
 \*(lqk\*(rq for cpu-time averaged core usage (in 1k units),
 \*(lqavio\*(rq for average number of i/o operations per execution.

-With options fields labelled \*(lqtio\*(rq for total i/o operations,
+With options fields labeled \*(lqtio\*(rq for total i/o operations,

 \*(lqk*sec\*(rq for cpu storage integral (kilo-core seconds), \*(lqu\*(rq and \*(lqs\*(rq
 \*(lqk*sec\*(rq for cpu storage integral (kilo-core seconds), \*(lqu\*(rq and \*(lqs\*(rq

-for user and system cpu time alone (both in minutes) will sometimes
-appear.
+for user and system cpu time alone (both in minutes) will sometimes appear.

 .PP
 There are near a googol of options:
 .PP
 .TP
 a
 .PP
 There are near a googol of options:
 .PP
 .TP
 a

-Place all command names containing unprintable characters
-and those used only once under the name `***other.'
+Print all command names, even those containing unprintable characters
+and those used only once.  By default, those are placed under the
+name `***other.'

 .TP
 b
 .TP
 b

-Sort output by sum of user and system time divided by number of
-calls.
+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
 Default sort is by sum of user and system times.
 .TP
 c


@@ -87,8 +89,7 @@ i
 Don't read in summary file.
 .TP
 j
 Don't read in summary file.
 .TP
 j

-Instead of total minutes time for each category,
-give seconds per call.
+Instead of total minutes time for each category, give seconds per call.

 .TP
 k
 Sort by cpu-time average memory usage.
 .TP
 k
 Sort by cpu-time average memory usage.


@@ -110,37 +111,40 @@ Reverse order of sort.
 .TP
 s
 Merge accounting file into summary file
 .TP
 s
 Merge accounting file into summary file

-.I /usr/adm/savacct
+.I /var/account/savacct

 when done.
 .TP
 t
 when done.
 .TP
 t

-For each command report ratio of real time to the sum of user and
-system times.
+For each command report ratio of real time to the sum of user and system times.

 .TP
 u
 .TP
 u

-Superseding all other flags,
-print for each command in the accounting file the
+Superseding all other flags, print for each command in the accounting file the

 user ID and command name.
 .TP
 v
 Followed by a number
 .I n,
 user ID and command name.
 .TP
 v
 Followed by a number
 .I n,

-types the name of
-each command used
+types the name of each command used

 .I n
 times or fewer.
 .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
+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.
+.TP
+S
+The following filename is used as the command summary file instead of
+.I /var/account/savacct.
+.TP
+U
+The following filename is used instead of
+.I /var/account/usracct
+to accumulate the per-user statistics printed by the \-m option.

 .SH FILES
 .ta 2i
 .SH FILES
 .ta 2i

-/usr/adm/acct  raw accounting
+/var/account/acct      raw accounting

 .br
 .br

-/usr/adm/savacct       summary
+/var/account/savacct   summary

 .br
 .br

-/usr/adm/usracct       per-user summary
+/var/account/usracct   per-user summary

 .SH "SEE ALSO"
 ac(8), acct(2)
 .SH BUGS
 .SH "SEE ALSO"
 ac(8), acct(2)
 .SH BUGS