timex.1 (2010 09)

t
timex(1) timex(1)
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 sum-
marized, 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:
timex -ops sleep 60
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.
SEE ALSO
sar(1M), acctcom(1M).
STANDARDS CONFORMANCE
timex: SVID2, SVID3
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1