XPERFMON(1X11)          COMMAND REFERENCE          XPERFMON(1X11)



NAME
     xperfmon - X window system performance monitor

SYNOPSIS
     xperfmon [option ...]

     This is a user-contributed client.

DESCRIPTION
     The xperfmon program continuously displays several system
     statistics as a set of parallel line graphs.  The name of
     the host is displayed in the upper left hand corner.  The
     information is scaled so that it fills up the entire window.

     While xperfmon is running, it is possible to perform certain
     tasks by pressing keys over the window:

     Q/q            Quit

     R              Reset graph and timer

     s              Decrease update interval (slower) by a small
                    amount

     S              Decrease update interval (slower) by a large
                    amount

     f              Increase update interval (faster) by a small
                    amount

     F              Increase update interval (faster) by a large
                    amount

     ?              Help

OPTIONS
     =geometry                The xperfmon window is created with
                              the specified size and location
                              determined by the supplied geometry
                              specification.  See X(1x11) for a
                              full explanation.

     host:display             Run xperfmon on a specified
                              display.  Default is :0.

     -rv | -reverse           Reverses black and white.

     -fw | -forward           Forces colors to be as specified
                              (rather than reversed).

     -bw | -border pixels     Specify the border width in pixels.
                              Default is 3.



Printed 3/22/89                                                 1

XPERFMON(1X11)          COMMAND REFERENCE          XPERFMON(1X11)



     -fn | -font fontname     The hostname and labels will be
                              displayed in the specified font.
                              The default is 6X10.

     -u | -update seconds     Specify the update interval for the
                              graph in seconds.  Default is 1.

     -st | -stepsize pixels   Specify the stepsize of the graph.
                              Default is one pixel.

     -n | -not stat stat stat...
                              A list of statistics not to be
                              displayed.  Specifying -n or -not
                              on the command line supercedes any
                              statistics specified up to that
                              time.  All subsequent words on the
                              command line that are statistics
                              will be omitted from the display.

     stat stat stat...        A list of statistics to be
                              displayed.  If none are listed, all
                              are displayed.  If any are listed,
                              only those listed are displayed
                              unless -n or -not has been
                              specified.  Possible statistics are
                              user, system, idle, free, disk,
                              interrupts, input, output, and
                              collision.  These refer to
                              UserCPUpercentage,
                              SystemCPUpercentage, Freememory,
                              Disktransfers, Interrupts,
                              Inputpackets, Outputpackets, and
                              Collisionpackets.

ENVIRONMENT
     DISPLAY        To get the default host and display number.

CAVEATS
     This program of xperfmon requires the ability to open and
     read /dev/kmem.

     On most systems, this requires the suid bit set with root
     ownership or the sgid bit set and membership in the same
     group as /dev/kmem.

     Occasionally, the xperfmon window will not be updated
     correctly if its size changed too many times in rapid
     succession.  This is a consequence of the way that exposure
     events are handled.

SEE ALSO
     uwm(1x11), X(1x11), select(2), mem(4), X(8x11).



Printed 3/22/89                                                 2

XPERFMON(1X11)          COMMAND REFERENCE          XPERFMON(1X11)



AUTHORS
     The X11 version of xperfmon was written by Emanuel Jay
     Berkenbilt, Project Athena on 1/21/1988.  There is no record
     of previous authors.



















































Printed 3/22/89                                                 3

%%index%%
na:408,98;
sy:506,238;
de:744,1207;
op:1951,1462;3893,2842;
ca:6735,727;
se:7462,188;8130,358;
%%index%%000000000128