197 lines
5.9 KiB
HTML
197 lines
5.9 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XLOAD</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XLOAD</H1>
|
|
Section: User Commands (1)<BR>Updated: xload 1.1.3<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
xload - system load average display for X
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xload</B><TT> </TT>[-<I>toolkitoption</I> ...] [-scale <I>integer</I>] [-update <I>seconds</I>] [-hl <I>color</I>] [-highlight <I>color</I>] [-remote <I>host</I>]<BR>
|
|
<BR>
|
|
|
|
<BR> [-jumpscroll <I>pixels</I>] [-label <I>string</I>] [-nolabel] [-lights]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<I>xload</I>
|
|
|
|
program displays a periodically updating histogram of the system load average.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
|
|
<I>Xload</I>
|
|
|
|
accepts all of the standard X Toolkit command line options (see <I><A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)</I>).
|
|
The order of the options is unimportant. <I>xload also accepts the
|
|
following additional options:
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"></I><B>-hl </B><I>color</I> or -highlight <I>color</I>
|
|
|
|
<DD>
|
|
This option specifies the color of the scale lines.
|
|
<DT id="2"><B>-jumpscroll </B>number of pixels
|
|
|
|
<DD>
|
|
The number of pixels to shift the graph to the left when the graph
|
|
reaches the right edge of the window. The default value is 1/2 the width
|
|
of the current window. Smooth scrolling can be achieved by setting it to 1.
|
|
<DT id="3"><B>-label </B><I>string</I>
|
|
|
|
<DD>
|
|
The string to put into the label above the load average.
|
|
<DT id="4"><B>-nolabel</B>
|
|
|
|
<DD>
|
|
If this command line option is specified then no label will be
|
|
displayed above the load graph.
|
|
<DT id="5"><B>-lights</B>
|
|
|
|
<DD>
|
|
When specified, this option causes
|
|
<I>xload</I>
|
|
|
|
to display the current load average by using the keyboard leds; for
|
|
a load average of <I>n</I>, xload lights the first <I>n</I> keyboard leds.
|
|
This option turns off the usual screen display.
|
|
<DT id="6"><B>-scale </B><I>integer</I>
|
|
|
|
<DD>
|
|
This option specifies the minimum number of tick marks in the histogram,
|
|
where one division represents one load average point. If the load goes
|
|
above this number, <I>xload</I> will create more divisions, but it will never
|
|
use fewer than this number. The default is 1.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="7"><B>-update </B><I>seconds</I>
|
|
|
|
<DD>
|
|
This option specifies the interval in seconds at which <I>xload</I>
|
|
updates its display. The minimum amount of time allowed between updates
|
|
is 1 second. The default is 10.
|
|
<DT id="8"><B>-remote </B><I>host</I>
|
|
|
|
<DD>
|
|
This option tells <I>xload</I> to display the load of <I>host</I> instead of <I>localhost</I>. <I>Xload</I> gets the information from the <I>rwhod</I> database and consequently requires <I>rwhod</I> to be executing both on <I>localhost</I> and <I>host</I>.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>RESOURCES</H2>
|
|
|
|
In addition to the resources available to each of the widgets used by
|
|
<I>xload</I> there is one resource defined by the application itself.
|
|
<DL COMPACT>
|
|
<DT id="9"><B>showLabel (</B>class<B> Boolean)</B>
|
|
|
|
<DD>
|
|
If False then no label will be displayed.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>WIDGETS</H2>
|
|
|
|
In order to specify resources, it is useful to know the hierarchy of
|
|
the widgets which compose <I>xload</I>. In the notation below,
|
|
indentation indicates hierarchical structure. The widget class name
|
|
is given first, followed by the widget instance name.
|
|
<P>
|
|
<PRE>
|
|
XLoad xload
|
|
Paned paned
|
|
Label label
|
|
StripChart load
|
|
</PRE>
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="10"><B>DISPLAY</B>
|
|
|
|
<DD>
|
|
to get the default host and display number.
|
|
<DT id="11"><B>XENVIRONMENT</B>
|
|
|
|
<DD>
|
|
to get the name of a resource file that overrides the global resources
|
|
stored in the RESOURCE_MANAGER property.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="12"><I>/etc/X11/app-defaults/XLoad</I>
|
|
|
|
<DD>
|
|
specifies required resources
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7), <A HREF="/cgi-bin/man/man2html?1+xrdb">xrdb</A>(1), <A HREF="/cgi-bin/man/man2html?4+mem">mem</A>(4), Athena StripChart Widget.
|
|
<A NAME="lbAK"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
On older platforms, this program may require the ability to open and read
|
|
the special system file <I>/dev/kmem</I>. Sites that do not allow general
|
|
access to this file may need to make <I>xload</I> belong to the same group
|
|
as <I>/dev/kmem</I> and turn on the <I>set group id</I> permission flag.
|
|
<P>
|
|
|
|
Reading the load average is inherently non-portable. Therefore, the routine
|
|
used to read it (get_load.c) must be ported to each new operating system.
|
|
<A NAME="lbAL"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright © X Consortium
|
|
<BR>
|
|
|
|
See <I><A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)</I> for a full statement of rights and permissions.
|
|
<A NAME="lbAM"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
K. Shane Hartman (MIT-LCS) and Stuart A. Malone (MIT-LCS);
|
|
<BR>
|
|
|
|
with features added by Jim Gettys (MIT-Athena), Bob Scheifler (MIT-LCS),
|
|
Tony Della Fera (MIT-Athena), and Chris Peterson (MIT-LCS).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="13"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="14"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="15"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="16"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="17"><A HREF="#lbAF">RESOURCES</A><DD>
|
|
<DT id="18"><A HREF="#lbAG">WIDGETS</A><DD>
|
|
<DT id="19"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="20"><A HREF="#lbAI">FILES</A><DD>
|
|
<DT id="21"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
<DT id="22"><A HREF="#lbAK">BUGS</A><DD>
|
|
<DT id="23"><A HREF="#lbAL">COPYRIGHT</A><DD>
|
|
<DT id="24"><A HREF="#lbAM">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:31 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|