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  sum-
     mary  format.  The output includes command name, number
     of  times  executed,  total  kcore-minutes,  total  CPU
     minutes, total real minutes, mean size (in K), 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  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 non-prime time parts.  This  option  combines
     the  prime and non-prime time parts into a single field
     that is the total of both, and provides upward compati-
     bility  with  old  (i.e.,  UNIX System V) style acctcms
     internal summary format records.

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

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

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

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

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

SEE ALSO

acct(1M),    acctcon(1M),     acctmerg(1M),     acctprc(1M),
acctsh(1M), fwtmp(1M), runacct(1M), acct(4), utmp(4)
acctcom(1) in the User's Reference Manual
acct(2) in the Programmer's Reference Manual

NOTES

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.