# 2.11BSD#431 - /usr/man/cat8/sa.0

    SA(8)		    UNIX Programmer's Manual		    SA(8)

    NAME
         sa - system accounting

    SYNOPSIS
         sa [ -abcdDfijkKlnrstu ] [ -v threshold ] [ -S savacctfile ]
         [ -U usracctfile ] [ file ]

    DESCRIPTION
         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 condensation 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 account-
         ing 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 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.

         There are near a googol of 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 com-
    	  mand 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.

    Printed 11/26/99	November 16, 1996			1

    SA(8)		    UNIX Programmer's Manual		    SA(8)

         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.

         S	  The following filename is used as the command summary
    	  file instead of /usr/adm/savacct.

         U	  The following filename is used instead of
    	  /usr/adm/usracct to accumulate the per-user statistics
    	  printed by the -m option.

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

    SEE ALSO
         ac(8), accton(8), acctd(8)

    BUGS
         The number of options to this program is absurd.

    Printed 11/26/99	November 16, 1996			2

Generated: 2016-12-26 | Generated by man2html V0.25 page hit count: 664 |