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



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.

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


                    -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 exe-
                          cution.  This ``hog factor'' is com-
                          puted 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.

     -s  Report total system activity (not just that due to com-
         mand) that occurred during the execution interval of



                         Printed 1/15/91                   Page 1

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



         command.  All the data items listed in sar(1) are
         reported.

SEE ALSO
     sar(1).

WARNING
     Process records associated with command are selected from
     the accounting file /usr/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 1/15/91