timex(1)                                                           timex(1)




 NAME    [Toc]    [Back]
      timex - time a command; report process data and system activity

 SYNOPSIS    [Toc]    [Back]
      timex [-o] [-p[fhkmrt]] [-s] command

 DESCRIPTION    [Toc]    [Back]
      timex reports in seconds the elapsed time, user time, and system time
      spent in execution of the given command.  Optionally, process
      accounting data for 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 the standard error. Timex returns an
      exit status of 1 if it is used incorrectly, if it is unable to fork,
      or if it could not exec command . Otherwise, timex returns the exit
      status of command.

    Options    [Toc]    [Back]
           -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[fhkmrt]     List process accounting records for command and
                          all its children.  The suboptions f, h, k, m, r,
                          and t modify the data items reported.  They behave
                          as defined in acctcom(1M).  The number of blocks
                          read or written and the number of characters
                          transferred are always reported.

                          This option works only if the process accounting
                          software is installed and /usr/lib/acct/turnacct
                          has been invoked to create /var/adm/pacct.

           -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(1M) are reported.

 EXAMPLES    [Toc]    [Back]
      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



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 timex(1)                                                           timex(1)




 WARNINGS    [Toc]    [Back]
      Process records associated with command are selected from the
      accounting file /var/adm/pacct by inference, since process genealogy
      is not available.  Background processes having the same user-ID,
      terminal-ID, and execution time window are spuriously included.

 SEE ALSO    [Toc]    [Back]
      sar(1M), acctcom(1M).

 STANDARDS CONFORMANCE    [Toc]    [Back]
      timex: SVID2, SVID3


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003