acctcom(8)acctcom(8)NAMEacctcom - 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
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)
──────────────────────────────────────────────────────────
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. 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. 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) 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)
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 head‐
ing 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
Displays only the processes that belong to the specified group.
You may specify either the group ID or the group name. The col‐
umn heading format is the same as the default column heading
format. Displays the hog factor instead of the mean memory
size. The hog factor 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 TTY‐
NAME TIME TIME (SECS) (SECS) FACTOR
Displays information about processes that exceed the value spec‐
ified by the hogfactor variable. The output format is the same
as the default column heading format. Displays the number of
characters and blocks transferred during read or write I/O oper‐
ations. 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 out‐
put. 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 Displays information about the processes
that transfer more than the number of characters specified by
the number variable. The output format is the same as the
default column heading format. 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 for‐
mat is the same as the default column heading format, except the
KCORE MIN column heading replaces the MEAN SIZE(K) column head‐
ing. 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 Dis‐
plays information about the processes that belong to the work‐
station whose tty line is specified by the line variable (for
example, ttyp0). The heading format is the same as the default
column heading format. 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. Displays information only about the pro‐
cesses whose names include the regular expression specified by
the pattern variable. The output format is the same as the
default column heading format. 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 Dis‐
plays information about the processes that have a CPU system
time exceeding the time specified by the seconds variable. The
output format is the same as the default column heading format.
Displays only the average statistics, which are shown at the end
of the command output when you use the -a option. 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 head‐
ing 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 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: ACCOUNT‐
ING 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) 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) 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 follows: ACCOUNTING RECORDS FROM: day mon date hh:mm:ss yy
COMMAND START END REAL CPU (SECS) NAME USER TTYNAME
TIME TIME (SECS) SYS USER Displays information about the pro‐
cesses that are owned by user username. You can specify a user
identification number, a login name converted to a user identi‐
fication 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. 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
specified 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 background), 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 com‐
pletion 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,
process 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 trans‐
ferred 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
prefixed with a number sign (#). If a process is not assigned to a
known tty (for example, if the cron daemon runs the process), a ques‐
tion 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 time‐
stamps shown in the examples use the default format for date and time
values.
EXAMPLES
The following command displays information about processes that exceed
2.0 seconds of CPU time:
/usr/sbin/acct/acctcom -O 2 < /var/adm/pacct The following com‐
mand displays information about processes belonging to the
Finance group:
/usr/sbin/acct/acctcom -g Finance < /var/adm/pacct The fol‐
lowing 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
Specifies the command path. The active process accounting database
file. User and group database files. 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)acctcom(8)