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  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 while rktimes provides limited capa-
       bilities 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  SIG-
       INT/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-prefix.  (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 TCP 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 without,
              in which case it is assumed to be microseconds.

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

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 con-
       nected, 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 reservation consumed is shown as
              the user-time CPU usage.  The two values  are  typically  repre-
              sented 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 primary 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 rep-
       resents the amount of user and system CPU time consumed by the  process
       since the last sample.

       In  addition  to  the  trace output, rktimes, will also generate a file
       named <file_prefix>-child.pid that contains the process ID of the util-
       ity being monitored, if one was specified.

RESOURCE RESERVATIONS

       Because  rktimes  will  be  performing some processing periodically, 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  mil-
       liseconds 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), cpubroker(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.2.0              2004/02/25 21:55:06                   RKTIMES(1)