unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (4.2BSD)
Page:
Section:
Apropos / Subsearch:
optional field

SA(8)                       System Manager's Manual                      SA(8)



NAME
       sa, accton - system accounting

SYNOPSIS
       /etc/sa [ -abcdDfijkKlnrstuv ] [ file ]

       /etc/accton [ file ]

DESCRIPTION
       With an argument naming an existing file, accton causes system account-
       ing information for every process executed to be placed at the  end  of
       the file.  If no argument is given, accounting is turned off.

       Sa reports on, cleans up, and generally maintains accounting files.

       Sa  is able to condense the information in /usr/adm/acct into a summary
       file /usr/adm/savacct which contains a count of  the  number  of  times
       each  command was called and the time resources consumed.  This conden-
       sation is desirable because on a large system /usr/adm/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.

       If a file name is given as the last argument, that file will be treated
       as the accounting file; /usr/adm/acct is the default.

       Output  fields  are  labeled: "cpu" for the sum of user+system time (in
       minutes), "re" for real time (also in minutes), "k" for cpu-time  aver-
       aged  core usage (in 1k units), "avio" for average number of i/o opera-
       tions per execution.  With options fields labeled "tio" for  total  i/o
       operations,  "k*sec"  for cpu storage integral (kilo-core seconds), "u"
       and "s" for user and system cpu time alone (both in minutes) will some-
       times appear.

       There are near a googol of options:

       a      Place  all  command  names containing unprintable characters and
              those used only once under the name `***other.'

       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.

       c      Besides total user, system, and real time for each command print
              percentage of total time over all commands.

       d      Sort by average number of disk i/o operations.

       D      Print and sort by total number of disk i/o operations.

       f      Force no interactive threshold compression with -v flag.

       i      Don't read in summary file.

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

       k      Sort by cpu-time average memory usage.

       K      Print and sort by cpu-storage integral.

       l      Separate system and user time; normally they are combined.

       m      Print  number  of  processes  and number of CPU minutes for each
              user.

       n      Sort by number of calls.

       r      Reverse order of sort.

       s      Merge accounting file into summary  file  /usr/adm/savacct  when
              done.

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

       u      Superseding all other flags,  print  for  each  command  in  the
              accounting file the user ID and command name.

       v      Followed  by  a  number n, types the name of each command used 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.

FILES
       /usr/adm/acct       raw accounting
       /usr/adm/savacct    summary
       /usr/adm/usracct    per-user summary

SEE ALSO
       ac(8), acct(2)

BUGS
       The number of options to this program is absurd.



                                 20 April 1980                           SA(8)