timex(1)                            CLIX                            timex(1)



  NAME

    timex - Times a command; reports process data and system activity

  SYNOPSIS

    timex [flag ... ] command

  FLAGS

    -p   List process accounting records for command and all its children.
         Secondary flags f, h, k, m, r, and t modify the data items reported.
         The secondary flags are as follows:

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

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

  DESCRIPTION

    The timex command times a command, and reports process data and system
    activity associated with the command.  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 stderr.




  2/94 - Intergraph Corporation                                              1

  timex(1)                            CLIX                            timex(1)



  EXAMPLES

    1.  A simple example follows:

        timex -ops sleep 60


    2.  A terminal session of arbitrary complexity can be measured by timing a
        sub-shell:

        timex -opskmt sh


  DIAGNOSTICS

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

  EXIT VALUES

    The timex command exits with a nonzero value if it encounters a problem.

  RELATED INFORMATION

    Commands: sar(1)



























  2                                              Intergraph Corporation - 2/94