timex(1)
_________________________________________________________________
timex Command
time a command; report process data and system activity
_________________________________________________________________
SYNTAX
timex [options] 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 are:
-p List process accounting records for command and all its
children. Suboptions f, h, k, m, r, and t modify the data
items reported, as defined in acctcom(1). The suboptions
are:
-f Print the fork/exec 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 process 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
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
timex(1)
reported.
-o Report the total number of blocks read or written and total
characters transferred by command and all its children.
-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.
SEE ALSO
acctcom(1), sar(1).
CAVEATS
When timex is used on a 3B 20A dual computer system the sum of
system and user time could be greater than real time. This can
happen when command is a multi-threaded task runing on a 3B 20A
system with both processors active.
WARNING
Process records associated with command are selected from the
accounting file /usr/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.
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
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)