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 pro-
                 cess 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  attri-
     butes:

     ____________________________________________________________
    |       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 pro-
     cess genealogy is not available. Background processes having
     the  same  user  ID,  terminal ID, and execution time window
     will be spuriously included.


Man(1) output converted with man2html