timex(1) User Commands timex(1)NAMEtimex - time a command; report process data and system activity
SYNOPSIStimex [-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 chil‐
dren. This option works only if the process accounting soft‐
ware 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 sta‐
tus columns in the output.
-h Instead of mean memory size, show the fraction of
total available CPU time consumed by the process dur‐
ing 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 charac‐
ters 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 attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWaccu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOsar(1), time(1), exec(2), fork(2), times(2), attributes( 5)
NOTES
Process records associated with command are selected from the account‐
ing file /var/adm/pacct by inference, since process genealogy is not
available. Background processes having the same user ID, terminal ID,
and execution time window will be spuriously included.
SunOS 5.10 14 Sep 1992 timex(1)
