TIMEX(1)            RISC/os Reference Manual             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



                        Printed 11/19/92                   Page 1

TIMEX(1)            RISC/os Reference Manual             TIMEX(1)



         command) that occurred during the execution interval of
         command.  All the data items listed in sar(1) are
         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




























 Page 2                 Printed 11/19/92