timex(1)
NAME
timex - time a command; report process data and system
activity
SYNOPSIS
timex [-o] [ -p [-fhkmrt]] [-s] command
DESCRIPTION
The given command is executed; the elapsed time, user time
and system time spent in execution are reported in seconds.
Optionally, process accounting data for the command and all
its children can be listed or summarized, and total system
activity during the execution interval can be reported.
The output of timex is written on standard error.
OPTIONS
The following options are supported:
-o Report the total number of blocks read or written and
total characters transferred by command and all its
children. This option works only if the process
accounting software is installed.
-p List process accounting records for command and all
its children. This option works only if the process
accounting software is installed. Suboptions f, h, k,
m, r, and t modify the data items reported. The
options are as follows:
-f Print the fork(2)/ exec(2) flag and system exit
status columns in the output.
-h Instead of mean memory size, show the fraction
of total available CPU time consumed by the pro-
cess during its execution. This ``hog factor''
is computed as (total CPU time)/(elapsed time).
-k Instead of memory size, show total kcore-
minutes.
-m Show mean core size (the default).
-r Show CPU factor (user time/(system-time + user-
time)).
-t Show separate system and user CPU times. The
number of blocks read or written and the number
of characters transferred are always reported.
-s Report total system activity (not just that due to
command) that occurred during the execution interval
of command. All the data items listed in sar(1) are
reported.
EXAMPLES
Example 1: Examples of timex.
A simple example:
example% timex -ops sleep 60
A terminal session of arbitrary complexity can be measured
by timing a sub-shell:
example% timex -opskmt sh
session commands
EOT
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWaccu |
|_____________________________|_____________________________|
SEE ALSO
sar(1), time(1), exec(2), fork(2), times(2), attributes( 5)
NOTES
Process records associated with command are selected from
the accounting file /var/adm/pacct by inference, since pro-
cess genealogy is not available. Background processes having
the same user ID, terminal ID, and execution time window
will be spuriously included.
Man(1) output converted with
man2html