rktimes man page

SYNOPSIS

       rktimes [-hV] [-o file-prefix] [-n name] [-p  port-number]
       [-P period] [-C compute-time] [-- utility argument ...]

DESCRIPTION

       The  rktimes utility periodically records the CPU usage of
       the processes attached  to  a  resource  set.   The  usage
       statistics  are  sampled once a second and stored in sepa-
       rate files for each process/thread.  If a utility is spec-
       ified,  it  will  be  executed  while attached to a new or
       existing resource set.  Note that while  rktimes  provides
       limited  capabilities for creating a soft CPU reservation,
       the child process should do this instead.  If a utility is
       not  specified,  it will monitor the resource set with the
       given name until it is interrupted.

       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  post-processing
       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.

       -V     Print out a version number.

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

       -P period
              The period for the soft CPU  reservation.   The  -C
              option  must  also  be given with this option.  The
              value  can   be   a   number   with   units   (e.g.
              "60000000us",  "60000ms",  "60s", or "1m") or with-
              out, in which case it is assumed  to  be  microsec-
              onds.

       -C compute-time
              The  compute  time in microseconds for the soft CPU
              reservation.  The -P option must also be given with
              this  option.  The value can be a number with units
              (e.g. "60000000us", "60000ms", "60s", or  "1m")  or
              without,   in  which  case  it  is  assumed  to  be
              microseconds.

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.

       Time   The current time on the machine  where  rktimes  is
              running.

       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.

RESOURCE RESERVATIONS

       Because rktimes will be performing some processing period-
       ically, it will try create  a  soft  CPU  reservation  for
       itself.  If it fails, it will exit immediately.

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 monitor "ls" with a CPU reservation where the period is
       100 milliseconds and the compute time is 5 milliseconds.

              [nemo@anemone  rbroker]  rktimes -P 100ms -C 5ms --
              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), cpub-
       roker(7)

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 1.0.0       2003/11/23 20:12:42             RKTIMES(1)