sa(8) — bsd — mips UMIPS RISC/os 5.01



SA(8-BSD)           RISC/os Reference Manual            SA(8-BSD)



NAME
     sa, accton - system accounting

SYNOPSIS
     /bsd43/bin/sa [ -abcdDfijkKlnrstuv ] [ -Ssavacctfile ] [
     -Uusracctfile ] [ file ]

     /bsd43/bin/accton [ file ]

DESCRIPTION
     With an argument naming an existing file, accton causes sys-
     tem accounting 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/pacct (the file name is changed from the usual
     standard in BSD systems to work with System V accounting
     programs) into a summary file /usr/adm/savacct which con-
     tains 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 /usr/adm/acct/pacct 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/pacct 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 averaged core usage (in 1k units), "avio" for
     average number of i/o operations 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 sometimes appear.

OPTIONS
     a    Print all command names, even those containing unprint-
          able characters and those used only once.  By default,
          those are placed 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



                        Printed 11/19/92                   Page 1



SA(8-BSD)           RISC/os Reference Manual            SA(8-BSD)



          command print percentage of total time over all com-
          mands.

     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 com-
          bined.

     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 termi-
          nal; if it begins with `y', add the command to the
          category `**junk**.' This is used to strip out garbage.

     Ssavacctfile
          savacctfile is used as the command summary file instead
          of /usr/adm/savacct.

     Uusracctfile
          usracctfile is used instead of /usr/adm/usracct to
          accumulate the per-user statistics printed by the -m
          option.




 Page 2                 Printed 11/19/92



SA(8-BSD)           RISC/os Reference Manual            SA(8-BSD)



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

SEE ALSO
     ac(8).
     acct(2) in the Programmer's Reference Manual.















































                        Printed 11/19/92                   Page 3

Museum

Related Articles