packages icon



 XPERFMON(1)                    X Version 11                     XPERFMON(1)
                                20 July 1989



 NAME
      xperfmon - X window system performance monitor

 SYNOPSIS
      xperfmon [option ...]

 DESCRIPTION
      Xperfmon 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

      Xperfmon understands the following options:

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

      host:display
              Run xperfmon on a specified display.  Default is local:0.0.

      -rv | -reverse
              Reverses the foreground and background colors.

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

      -fl | -fill
              Fills the space between the graph value and the bottom value
              with the foreground color.

      -nf | -nofill
              Draws the graph as a line.





                                    - 1 -      Formatted:  November 14, 2024






 XPERFMON(1)                    X Version 11                     XPERFMON(1)
                                20 July 1989



      -bd | -color color
              Sets the border color to color.  The default is white.

      -bg | -background color
              Set the background color to color.  The default is black.

      -fg | -foreground color
              Sets the foreground color to color. The default is white.

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

      -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 commandline supercedes any statistics specified up
              to that time.  All subsequent words on the command line that
              are statistics will be omited from the display.  See
              immediately below.

      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 User CPU
              percentage, System CPU percentage, Free memory, Disk
              transfers, Interrupts, Input packets, Output packets, and
              Collision packets.

 X DEFAULTS
      geometry
              Specifies the default geometry in standard X notation.

      foreground
              Specifies the color to use for the window foreground.

      background
              Specifies the color to use for the window background.





                                    - 2 -      Formatted:  November 14, 2024






 XPERFMON(1)                    X Version 11                     XPERFMON(1)
                                20 July 1989



      color   Specifies the color to use for the border color.

      border  Specifies the width of the border in pixels.

      font    Specifies the font to use for the graph labels.

      stepsize
              Specifies the stepsize of the graph in pixels.

      reverse Specify yes or no.  Specifies if the foregroud and background
              colors should be reversed.

      update  Specifies the update interval in seconds.

 ENVIRONMENT
      DISPLAY - to get the default host and display number.

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

 AUTHORS
      The X11 version of xperfmon was written by Emanuel Jay Berkenbilt,
      Project Athena on 1/21/1988.  Additional enhancements were added by
      Ken Sumrall, HP California Language Labs on 7/20/1989.  There is no
      record of previous authors.

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




















                                    - 3 -      Formatted:  November 14, 2024