NAME
timex — time a command; report process data and system activity
SYNOPSIS
timex
[-o]
[-p[fhkmrt]]
[-s]
command
DESCRIPTION
timex
reports in seconds the elapsed time, user time,
and system time spent in execution of the given
command.
Optionally, process accounting data for
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 the standard error. Timex returns an exit status of 1 if it
is used incorrectly, if it is unable to fork, or if it could not exec
command . Otherwise, timex returns the exit status of command.
Options
- -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[fhkmrt]
List process accounting records for
command
and all its children.
The suboptions
f,
h,
k,
m,
r,
and
t
modify the data items reported.
They behave as defined in
acctcom(1M).
The number of blocks read or written
and the number of characters transferred are always reported.
This option works only if the process accounting software is installed
and
/usr/lib/acct/turnacct
has been invoked to create
/var/adm/pacct.
- -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(1M)
are reported.
EXAMPLES
A simple example:
A terminal session of arbitrary complexity
can be measured by timing a sub-shell:
timex -opskmt sh
session commands
EOT
WARNINGS
Process records associated with
command
are selected from the accounting 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 are spuriously included.
STANDARDS CONFORMANCE
timex: SVID2, SVID3
Printable version
