NAME [Toc] [Back]
timex - time a command; report process data and system activity
SYNOPSIS [Toc] [Back]
timex [-o] [-p[fhkmrt]] [-s] command
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
-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 [Toc] [Back]
A simple example:
timex -ops sleep 60
A terminal session of arbitrary complexity can be measured by timing a
timex -opskmt sh
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
WARNINGS [Toc] [Back]
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 [Toc] [Back]
STANDARDS CONFORMANCE [Toc] [Back]
timex: SVID2, SVID3
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ]