rktimes man page

SYNOPSIS

       rktimes [-h] [-o file-prefix] [-n name]  [-p  port-number]
       [-- utility argument ...]

DESCRIPTION

       The  rktimes utility periodically records the CPU usage of
       the processes attached to a resource set.  The usage stats
       are sampled once a second and stored in separate files for
       each process/thread.  If a utility is specified,  it  will
       be  executed  while attached to a new or existing resource
       set.  Note that rktimes will not create a CPU reserve  for
       the  resource  set, this must be done externally or by the
       child process.

       Monitoring of the resource set ends when rktimes  receives
       a  SIGINT/SIGTERM  or  the  utility  finishes.  The output
       files will be located in  the  current  directory  or  the
       directory  specified  by  file-prefix  and are ready to be
       viewed with gnuplot(1).  However, some postprocessing with
       the  rktimes_offset.awk(1)  and rktimes_sum.awk(1) scripts
       may be necessary to achieve the desired effect.

       Available options:


       -h     Print out a usage message.

       -o file-prefix
              Write the output to files prefixed  with  file-pre-
              fix.  (Default: ./rktimes)

       -n name
              The  name  of  the  resource set.  If no utility is
              specified and the resource  set  does  not  already
              exist, rktimes will fail.  (Default: rktimes)

       -p port-number
              The  port  number to listen on for connections from
              gkrellm(1) clients.

GKRELLM COMPATIBILITY

       When the -p option is specified, rktimes  will  listen  on
       the given port number for connections from gkrellm version
       2.0 clients.  While connected, the  clients  will  be  fed
       updates for the following monitors.


       Host Name
              The name of the resource set.

       System Name
              utility or <none> if only the resource set is being
              monitored.

       CPU 0  The CPU usage for  all  of  the  processes  in  the
              resource set.

       CPU 1  The  CPU  reservation for the resource set is shown
              as nice-time CPU usage and the amount of the reser-
              vation  consumed  is  shown  as  the  user-time CPU
              usage.  The two values are typically represented as
              two  colors by the graph with the reservation being
              the higher value, if it is visible.

       Up Time
              The running time of rktimes.

       Proc   The number of processes in the resource set.

RETURN VALUES

       The child's exit value
              If utility started and exited normally.

       127    If utility could not be found.

       1-125  If there were any other problems.

OUTPUT FILES

       The output of the rktimes utility is a set of files  named
       <file_prefix>.<PID>  that  contain two columns of numbers.
       Each number is a time value given in seconds and fractions
       of  a  second.  The first column represents the time since
       rktimes was started.  The second represents the amount  of
       user and system CPU time consumed by the process since the
       last sample.

EXAMPLES

       To monitor an existing resource set named "dory".

              [nemo@anemone rbroker] rktimes -n dory

       To monitor the same set in real-time using gkrellm(1).

              [nemo@anemone rbroker] rktimes -n dory -p 8080 &

              [nemo@anemone rbroker] gkrellm -s localhost -P 8080

       To  monitor  the  same  set, but have the recordings go to
       /tmp/data.<pid> instead of rktimes.<pid>

              [nemo@anemone rbroker] rktimes -o /tmp/data -n dory

       To monitor "ls" using the default settings.

              [nemo@anemone rbroker] rktimes -- ls -la

TO DO

       Allow the user to specify the sample frequency.

SEE ALSO

       rktimes_offset.awk(1),   rktimes_sum.awk(1),   gkrellm(1),
       rk_stubby(1), gnuplot(1), rk_resource_set_create(2)

AUTHOR

       The Alchemy project at the University of Utah.

NOTES

       The  Alchemy  project  can  be  found  on   the   web   at
       http://www.cs.utah.edu/flux/alchemy



CPU Broker 0.5         2003/09/02 19:14:21             RKTIMES(1)