timex(1)                 USER COMMANDS                   timex(1)



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

SYNOPSIS
     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.  The options
     are:

     -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  frac-
                     tion 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.

     -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.

     -s  Report total system activity (not just that due to  com-
         mand)  that  occurred  during  the execution interval of
         command.  All  the  data  items  listed  in  sar(1)  are



                                                                1

timex(1)                 USER COMMANDS                   timex(1)



         reported.

SEE ALSO
     time(1), sar(1).
     times(2) in the Programmer's Reference Manual.

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  hav-
     ing 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






























                                                                2