unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

timex(1)                         User Commands                        timex(1)



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

SYNOPSIS
       timex [-o] [ -p [-fhkmrt]] [-s] 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
       The following options are supported:

       -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       List process accounting records for command and all its  chil-
                dren.  This  option works only if the process accounting soft-
                ware 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 sta-
                         tus columns in the output.




                -h       Instead of mean memory size,  show  the  fraction  of
                         total available CPU time consumed by the process dur-
                         ing 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 charac-
                         ters transferred are always reported.



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



EXAMPLES
       Example 1: Examples of timex.

       A simple example:

       example% timex -ops sleep 60

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

       example% timex -opskmt sh
             session commands
       EOT

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWaccu


SEE ALSO
       sar(1), time(1), exec(2), fork(2), times(2), attributes( 5)

NOTES
       Process records associated with command are selected from the  account-
       ing  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 will be spuriously included.



SunOS 5.10                        14 Sep 1992                         timex(1)