acctcms(1M)                                                        acctcms(1M)


NAME
     acctcms - command summary from per-process accounting records

SYNOPSIS
     /usr/lib/acct/acctcms [-a [-p] [-o]] [-c] [-j] [-n] [-s] [-t] files

DESCRIPTION
     acctcms reads one or more files, normally in the form described in
     acct(4).  It adds all records for processes that executed identically
     named commands, sorts them, and writes them to the standard output,
     normally using an internal summary format.  The options are:

     -a   Print output in ASCII rather than in the internal summary format.
          The output includes command name, number of times executed, total
          kcore minutes, total CPU minutes, total real minutes, mean size (in
          kilobytes), mean CPU minutes per invocation, hog factor, characters
          transferred, and blocks read and written, as in acctcom(1).  Output
          is normally sorted by total kcore minutes.

     -c   Sort by total CPU time, rather than by total kcore minutes.

     -j   Combine all commands invoked only once under ``***other.''

     -n   Sort by number of command invocations.

     -s   Any filenames encountered hereafter are already in internal summary
          format.

     -t   Process all records as total accounting records.  The default
          internal summary format splits each field into prime- and nonprime-
          time parts.  This option combines the prime- and nonprime-time parts
          into a single field that is the total of both and provides upward
          compatibility with old-style (that is, pre-UNIX System V Release
          4.0) acctcms internal summary format records.

     The following options can be used only with the -a option.

     -p   Output a prime-time-only command summary.

     -o   Output a nonprime-time only (offshift) command summary.

     When -p and -o are used together, a combination prime- and nonprime-time
     report is produced.  All the output summaries are total usage except
     number of times executed, CPU minutes, and real minutes, which are split
     into prime and nonprime.

     acctcms checks the environment variable ACCT_CSIZE to figure out the
     maximum number of distinct commands it might need to report.

     A typical sequence for performing daily command accounting and for
     maintaining a running total is:


          acctcms file ... > today
          cp total previoustotal
          acctcms -s today previoustotal > total
          acctcms -a -s today


REFERENCES
     acct(1M), acctcom(1), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M),
     fwtmp(1M), runacct(1M), acct(2), acct(4), utmp(4).

NOTICES
     Unpredictable output results if -t is used on new-style internal summary
     format files or if it is not used with old-style internal summary format
     files.


                                                                        Page 2