SYNOPSIS

       perf [options] [host]

DESCRIPTION

       perf  is  an  XView  program that reports kernel statistics for a given
       host (or for the localhost if no host is specified).  The program is  a
       frontend to the rstatd(8) daemon.

       The  displayed  window  consists  of one or more fields, each showing a
       specified parameter.  The name of the parameter and of  its  components
       are  shown  in the lower left corner of the field, the maximum value of
       the visible data in the lower right corner.

OPTIONS

       -sampletime sec
              Query the rstatd each sec seconds for new data.  Default is 2.

       -drawline
              Draw only a line instead of a filled block.

       -nosmooth
              If the drawing is filled, do not smooth the data.

       -drawone
              Show only the sum of multiple subvalues like e.g.  usr,  nice  &
              sys.  This is the default on monochrome displays.

       -noadd Do  not  draw  the  subvalues on top of each other.  This means,
              that some subvalues may be completely hidden, if following  ones
              are greater.  Use the drawline option in such cases.

       -noreset
              Do  not readjust the maximum value shown in the lower right cor-
              ner.

       -scrollback sampled-values
              Set the scrollback buffer to sampled-values.   Default  is  200,
              i.e. 20 minutes if sampletime is 2.  The total number of samples
              stored is field_width_in_pixels + scrollback.

       -columns cols
              Display the fields in cols columns.  Default is 1.

       -delta Display (and store) the difference between the current  and  the
              last value, do not show the values per second.

       -warnfont fontname
              The text ``Lost connection'' will be drawn with this font.

       -col1 ... -col4 color
                 col4        #ffffff        (white)
                 warncol     #ffffff        (white)
              foreground is black and background is white.

       The following options specify, which statistic values are displayed:

       -cpu   Percent of cpu being used.

       -disk  Disk transfers per second.

       -page  Pages paged per second.

       -swap  Pages swapped per second.

       -interrupts
              Number of device interrupts in a second.

       -packets
              Network packets per second.

       -errors
              Errors per second on receiving packets.

       -collisions
              Collisions per second detected on the network.

       -context
              Number of context switches per second.

       -load  Load average.

       -mem   Memory usage. This is Linux specific. The numbers are in KBytes,
              the maximum is in MBytes.

       -swapspace
              Swapspace usage. See option -mem.

       -a     All of the above 10 options.

KEYBOARD ACCELERATORS

       a      Toggle the noadd option.

       q      Quit the program.

       s      Toggle solid drawing.

       o      Toggle smooth option.

       1      Toggle the drawone option.

       ?      Bring up the properties window.
       Left Mouse Button
              If  you  click  in a field with the left mouse button, the exact
              value of the sample will be displayed in the properties  window.
              If you drag the field, you can examine the sampled values in the
              scrollback history. If you press the SHIFT key while  initiating
              the drag, each (visible) field will be scrolled.

       Middle Mouse Button
              You  can  scroll more than one field at once by selecting all of
              them first with the middle mouse button.

X RESOURCES

       Following X Resources are examined during startup:
                   perf.sampletime
                   perf.drawline
                   perf.nosmooth
                   perf.drawone
                   perf.noreset
                   perf.scrollback
                   perf.columns
                   perf.col1
                   perf.col2
                   perf.col3
                   perf.col4
                   perf.foreground
                   perf.background
                   perf.warncol
                   perf.warnfont
                   perf.delta

       Note: Options take precedence over X resources.

FEATURES/BUGS

       The maximum scrollback is limited to  20,000  values,  because  if  you
       begin  to  scroll  back,  the  whole  history will be drawn on a single
       pixmap and this can be a memory hog.   If  the  sampletime  is  changed
       while  in "delta" mode, and then (after a while) delta mode is switched
       off, all values stored before the sampletime change are incorrect.

       Following bugs are due to using  the  "simple"  callrpc  function:  You
       can't  use  internet addresses, only hostnames with SunOs 4.x.  A known
       but unreachable machine can halfway lock up perf and olwm.  The follow-
       ing X resource prevents at least olwm to lock up:
            OpenWindows.ServerGrabs: False

AUTHOR

       Rudolf Koenig, 1993