timex(1)                                                           User Commands                                                          timex(1)

NAME

       timex - time a command; report process data and system activity

SYNOPSIS

       timex [-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 children. This option works only if the  process  accounting  software  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 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 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 ALSO

       sar(1), time(1), exec(2), fork(2), times(2), attributes( 5)

NOTES

       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 will be spuriously included.

SunOS 5.10                                                          14 Sep 1992                                                           timex(1)