xload(1X)
NAME
xload - X Window System load average display
SYNTAX
xload [ options ] [ display ] [ geometry ]
ARGUMENTS
displaySpecifies the display screen on which xload displays its window. If the display argument is not specified, xload uses the display screen specified by your DISPLAY environment variable. The display argument has the format hostname:number.
hostnameSpecifies the name of the host machine on which the display is connected. You can specify the name local to use shared memory, the name unix to use UNIX IPC, or the name of your host machine to use TCP.
numberSpecifies the number of the display on that host machine.
geometrySpecifies the width, length, and location of the xload window. If the geometry argument is not specified, xload uses mouse input. For further information, see DESCRIPTION.
The geometry argument has the format =[width][xlength][x][y].
widthSpecifies the number of pixels of the window’s horizontal dimension.
lengthSpecifies the number of pixels of the window’s vertical dimension.
xSpecifies the x screen coordinate (pixel value) for the starting corner of the window.
ySpecifies the y screen coordinate (pixel value) for the starting corner of the window.
Depending on which corner of the screen each is relative to, both the x and y coordinates must be preceded by a plus (+) or a minus (−). For more information about the screen coordinate system, see X(.).
DESCRIPTION
The xload command continuously displays the system load average under the X Window System. The xload command creates a window in which the name of the host is displayed in the upper left corner and the load average is represented as a bar graph with n divisions. Each division represents one unit of load average.
If the geometry argument is not specified, position and size the xload window by pressing one of the following mouse buttons:
LeftPositions the upper right corner of the window at −0+0 and sizes the window with a default width and length.
MiddlePositions the starting point of the window at the mouse pointer and sizes the window to a width and length determined by mouse movement.
RightPositions the upper left corner of the window at the mouse pointer and sizes the window with a default width and length.
To remove the xload window, place the mouse pointer in the xload window and type CTRL-C.
OPTIONS
The xload command has the following options.
−bd colorSpecifies the border color of the window (color displays only). The default color is black.
−bg colorSpecifies the background color of the window (color displays only). The default color is white.
−bw pixelsSpecifies the width of the border around the xload window. The default value is 3 pixels.
−fg colorSpecifies the graph color (color displays only). The default color is black.
−fn fontnameSpecifies that the hostname is displayed in the specified font. The default is 6x10.
−hl colorSpecifies the color of the hostname and scale line (color displays only). The default is the color of the graph.
−rvSpecifies that the default color values be reversed (for example, black becomes white and white becomes black).
−fwSpecifies that the default color values are to remain at their predetermined settings (for example, white is white and black is black).
−scale integerSpecifies the minimum number of divisions on the graph. The default number of divisions is one.
−update secondsSpecifies the period (in seconds) in which xload updates its display. When the xload window is obscured and then exposed, however, immediate update occurs. The default update period is five seconds. Specification of a frequency less than five seconds is ignored and replaced by the default frequency.
RESTRICTIONS
The xload command 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.
X DEFAULTS
Like most X-based applications, xload reads the .Xdefaults file during start-up and uses the appropriate resource specification to customize the appearance or characteristics of its displayed xload window. The format for a resource specification in the .Xdefaults file is: [name.]resource:value
nameSpecifies the application name or, in the case of X Toolkit-based applications, the name string that restricts the resource assignment to that application or to a component of an application. If this argument is not specified, the resource assignment is globally available to all X applications.
resourceSpecifies the X resource.
valueSpecifies the value that is to be assigned to the resource.
For xload, the available name is xload.
For xload, the available resources are:
Background Specifies the background color of the window (color displays only).
BodyFont Specifies the hostname font.
Border Specifies the internal border padding.
BorderColor Specifies the border color of the window (color displays only).
BorderWidth Specifies the border width of the window.
Foreground Specifies the graph color (color displays only).
Highlight Specifies the hostname and scale line color (color displays only).
ReverseVideo When on, specifies that xload reverse the default window colors (monochrome displays only).
Scale Specifies the minimum scale.
Update Specifies the update period.