unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



acctcom(8)							   acctcom(8)



NAME

  acctcom - Displays selected process accounting record	summaries

SYNOPSIS

  /usr/bin/acctcom  [-abfhikmqrtv] [-C seconds]	[-e time] [-Etime] [-g group]
  [-H factor] [-I number] [-lline] [[select_option] [-o>> file]]	[-npattern]
  [-O seconds] [-s time] [-S time] [-uusername]	[file...]

OPTIONS

  -a  Displays average statistics about	the selected processes.	 Statistics
      are displayed at the end of the output records in	the format var=# (for
      example, CMDS=439), where	the value (#) is given to the nearest hun-
      dredth.  The var specifies the following:


      _________________________________________________________
      Variable	 Value
      _________________________________________________________
      CMDS

		 Total number of commands listed in the	speci-
		 fied file
      REAL	 Average real time per process
      CPU	 Average CPU time per process
      USER	 Average user CPU time per process
      SYS	 Average system	CPU time per process
      CHAR	 Average number	of characters transferred
      BLK	 Average number	of blocks transferred
      USR/TOT

		 Average CPU factor (average user time divided
		 by total CPU time)
      HOG

		 Average hog factor (average CPU time divided
		 by average elapsed time)
      _________________________________________________________

  -b  Displays information about the most recently executed commands first.
      This option has no effect	when the acctcom command reads from the
      default input device or if more than one process accounting file is
      specified. The column heading format is the same as the default column
      heading format.

  -C seconds
      Lists processes whose total CPU time (system time	+ user time) is
      greater than the value specified by seconds. The column heading format
      is the same as the default column	heading	format.

  -e time
      Displays information only	about processes	that start at or before	the
      specified	time, which is specified as hh[:mm[:ss]]. The column heading
      format is	as follows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy
	   START BEFORE: day mon date hh:mm:ss yy
	   COMMAND	   START  END	REAL	CPU	MEAN
	   NAME	USER TTYNAME TIME TIME (SECS) (SECS) SIZE(K)

  -E time
      Displays information only	about processes	that end at or before the
      specified	time, which is specified as hh[:mm[:ss]]. If you specify the
      same time	for both the -E	and -S options,	the acctcom command displays
      processes	that existed at	the specified time. The	column heading format
      is as follows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy
	   END BEFORE  : day mon date hh:mm:ss yy
	   COMMAND	   START  END	REAL	CPU	MEAN
	   NAME	USER TTYNAME TIME TIME (SECS) (SECS) SIZE(K)

  -f  Displays information about the fork/exec option (used to execute
      another process) in the F	column and the system exit value STAT, which
      can be zero (0) or an error code,	in the STAT column in addition to the
      default column heading format. The column	heading	format is as follows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy
	   COMMAND		  START	 END   REAL    CPU     MEAN
	   NAME	USER TTYNAME TIME TIME (SECS) (SECS) SIZE(K) F STAT

  -g  group
      Displays only the	processes that belong to the specified group. You may
      specify either the group ID or the group name.  The column heading for-
      mat is the same as the default column heading format.

  -h  Displays the hog factor instead of the mean memory size.	The hog	fac-
      tor is the CPU time used by the process divided by the real time.	The
      output is	the same as the	default	column format output except the	MEAN
      SIZE(K) column heading is	replaced by the	.HOG FACTOR heading.  The
      column heading format is as follows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy
	   COMMAND	   START  END	REAL	CPU	HOG
	   NAME	USER TTYNAME TIME TIME (SECS) (SECS) FACTOR



  -H hogfactor
      Displays information about processes that	exceed the value specified by
      the hogfactor variable. The output format	is the same as the default
      column heading format.

  -i  Displays the number of characters	and blocks transferred during read or
      write I/O	operations.  The output	is similar to the default column
      heading format, except the CHARS TRANSFD column replaces the MEAN
      SIZE(K) column, and the BLOCKS READ column is added to the output. The
      column heading format is as follows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy
	   COMMAND   START  END	  REAL	  CPU	  CHARS	   BLOCKS
	   NAME	USER TTYNAME TIME TIME (SECS) (SECS) TRANSFD READ

  -Inumber
      Displays information about the processes that transfer more than the
      number of	characters specified by	the number variable.  The output for-
      mat is the same as the default column heading format.

  -k  Displays the total number	of K-core minutes, which is the	number of
      kilobytes	of memory used by the process multiplied by the	buffer time
      used. The	output format is the same as the default column	heading	for-
      mat, except the KCORE MIN	column heading replaces	the MEAN SIZE(K)
      column heading. The column heading format	is as follows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy
	   COMMAND    START  END   REAL	   CPU	   KCORE
	   NAME	USER TTYNAME TIME TIME (SECS) (SECS) MIN

  -l line
      Displays information about the processes that belong to the workstation
      whose tty	line is	specified by the line variable (for example, ttyp0).
      The heading format is the	same as	the default column heading format.

  -m  Displays the median amount of process memory used.  If you also specify
      the -h or	-k option, the -m option is ignored. The output	format is the
      same as the default column heading format.

  -n pattern
      Displays information only	about the processes whose names	include	the
      regular expression specified by the pattern variable.  The output	for-
      mat is the same as the default column heading format.

  select_option	-o filename
      Copies selected process records to the specified filename. The
      select_option variable specifies the following process selection
      options: -C, -e, -E, -g, -H, -I, -l, -n, -O, -s, -S, and -u.  If you do
      not specify a selection option with the select_option variable, all
      process records are copied to filename.  The output format includes
      only the date and	time:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy

  -O seconds
      Displays information about the processes that have a CPU system time
      exceeding	the time specified by the seconds variable.  The output	for-
      mat is the same as the default column heading format.

  -q  Displays only the	average	statistics, which are shown at the end of the
      command output when you use the -a option.

  -r  Displays the CPU factor, which is	the user time divided by the total
      CPU time.	 The output format is the same as the default column heading
      format, except the CPU FACTOR column replaces the	MEAN SIZE(K) column.
      The column heading format	is as follows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy
	   COMMAND	   START  END	REAL	CPU	CPU
	   NAME	USER TTYNAME TIME TIME (SECS) (SECS) FACTOR

  -s time
      Displays information about the processes that existed on or after	time,
      which is specified as hh[:mm[:ss]].  The column heading format is	as
      follows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy
	   END AFTER   : day mon date hh:mm:ss yy
	   COMMAND	   START  END	REAL	CPU	MEAN
	   NAME	USER TTYNAME TIME TIME (SECS) (SECS) SIZE(K)

  -S time
      Displays information only	about the processes that started at or after
      time, which is specified as hh[:mm[:ss]].	 The column heading format is
      as follows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss yy
	   START AFTER : day mon date hh:mm:ss yy
	   COMMAND	   START  END	REAL	CPU	MEAN
	   NAME	USER TTYNAME TIME TIME (SECS) (SECS) SIZE(K)

  -t  Displays system and user CPU times under separate	column headings. The
      CPU SYS column heading, which shows the system CPU time, replaces	the
      CPU (SECS) default column	heading. The column heading format is as fol-
      lows:
	   ACCOUNTING RECORDS FROM: day	mon date hh:mm:ss
	   yy
	   COMMAND    START  END   REAL	   CPU	(SECS)
	   NAME	USER TTYNAME TIME TIME (SECS) SYS USER

  -u username
      Displays information about the processes that are	owned by user user-
      name. You	can specify a user identification number, a login name con-
      verted to	a user identification number, a	number sign (#)	to specify
      root or a	question mark (?), which selects processes associated with
      unknown user identification numbers. The output format is	the same as
      the default column heading format.

  -v  Removes column headings from the output; otherwise the output is the
      same as the default column heading format.

DESCRIPTION

  The acctcom command displays process accounting records from files speci-
  fied by the file operand, from standard input, or from the /var/adm/pacct
  file.	If you do not specify a	file and if standard input is assigned to a
  workstation or to /dev/null (for example, if a process runs in the back-
  ground), the acctcom command reads the /var/adm/pacct	file.

  You do not have to be	root to	use the	acctcom	command, which is located in
  the /usr/bin directory.

  If you specify more than one filename, the acctcom process reads each	file
  chronologically in time-descending order according to	process	completion
  time.	Usually, the /var/adm/pacct file is used, but you can have several
  /var/adm/pacct/*Vn files, which are created by the ckpacct command.

  Each record specifies	the execution times for	a completed process. The
  default output format	includes the command name, user	name, tty name,	pro-
  cess start time, process end time, real seconds, CPU seconds,	and mean
  memory size (in kilobytes). The process summary output has the following
  default column heading format:

       ACCOUNTING RECORDS FROM:	day mon	date
       hh:mm:ss	yyyyCOMMAND		    START  END	 REAL	 CPU	 MEAN
       NAME	USER  TTYNAME  TIME   TIME  (SECS)  (SECS)  SIZE(K)

  If a specified time is later than the	current	time, it is interpreted	as
  occurring on the previous day.

  You can use options to display the state of the fork/exec option, F column;
  the system exit value, STAT column; the ratio	of total CPU time to elapsed
  time,	HOG FACTOR column; the product of memory used and elapsed time,	KCORE
  MIN column; the ratio	of user	time to	total (system plus user) time, CPU
  FACTOR column; the number of characters transferred during I/O operations,
  CHARS	TRNSFD column; and the total number of blocks read or written, BLOCKS
  READ column.

  If a process is run under root or su authority, the command name is pre-
  fixed	with a number sign (#).	 If a process is not assigned to a known tty
  (for example,	if the cron daemon runs	the process), a	question mark (?) is
  displayed in the TTYNAME column.

  The acctcom command reports only on processes	that have completed. Use the
  ps command to	examine	the status of active processes.

  For any option value that produces a timestamp in an output heading, the
  order	of date	and time information is	locale dependent. The timestamps
  shown	in the examples	use the	default	format for date	and time values.









EXAMPLES

   1.  The following command displays information about	processes that exceed
       2.0 seconds of CPU time:


	    /usr/sbin/acct/acctcom -O 2	<&lt; /var/adm/pacct

   2.  The following command displays information about	processes belonging
       to the Finance group:


	    /usr/sbin/acct/acctcom  -g	Finance	 <&lt;  /var/adm/pacct

   3.  The following command displays information about	processes belonging
       to tty /dev/console that	run after 5:00 p.m.:


	    /usr/sbin/acct/acctcom  -l	/dev/console  -s  17:00



FILES

  /usr/bin/acctcom
      Specifies	the command path.

  /var/adm/pacct
      The active process accounting database file.

  /etc/passwd, /etc/group
      User and group database files.

  /usr/include/sys/acct.h, /usr/include/utmp.h
      Accounting header	files that define formats for writing accounting
      files.

SEE ALSO

  Commands: ed(1), ps(1), su(1), acct(8), cron(8), runacct(8)

  Functions: acct(2)