irix - acctcms (1)




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.