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: October 30, 2025
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: October 30, 2025
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: October 30, 2025
