XNETLOAD(1)XNETLOAD(1)NAMExnetload - ethernet load average display for X
SYNOPSIS
xnetload[-toolkitoption ...] [-scale integer]
[-update seconds] [-hl color] [-highlight color]
[-jumpscroll pixels] [-label string] [-nolabel] host
DESCRIPTION
The xnetload program displays a periodically updating his-
togram of the ethernet load average for the specified
host. The resulting graph is scaled as 0% to 100%, where
0% corresponds to 0mbs and 100% corresponds to 10mbs.
NOTE: The specified host must be running rpc.etherd.
OPTIONS
Xnetload accepts all of the standard X Toolkit command
line options (see X(1)). The order of the options is
unimportant. xnetload also accepts the following addi-
tional options:
-hl color or -highlight color
This option specifies the color of the scale
lines.
-jumpscroll FPnumber of pixels
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.
-label string
The string to put into the label above the load
average.
-nolabel
If this command line option is specified then no
label will be displayed above the load graph.
-scale integer
This option specifies the minimum number of tick
marks in the histogram, where one division repre-
sents one load average point. If the load goes
above this number, xnetload will create more divi-
sions, but it will never use fewer than this num-
ber. The default is 10 (as set by the resource
file).
-update seconds
This option specifies the frequency in seconds at
which xnetload updates its display. The minimum
X Version 11 Release 1 1
XNETLOAD(1)XNETLOAD(1)
amount of time allowed between updates is 1 sec-
ond. For ethernet load monitoring this should be
set to 1.
host The host specification is required. It is the name
of any host, reachable from the initiating CPU,
that is running rpc.etherd
RESOURCES
In addition to the resources available to each of the wid-
gets used by xnetload there is one resource defined by the
application itself.
showLabel (class Boolean)
If False then no label will be displayed.
WIDGETS
In order to specify resources, it is useful to know the
hierarchy of the widgets which compose xnetload. In the
notation below, indentation indicates hierarchical struc-
ture. The widget class name is given first, followed by
the widget instance name.
Xnetload xnetload
Paned paned
Label label
StripChart load
ENVIRONMENT
DISPLAY to get the default host and display number.
XENVIRONMENT
to get the name of a resource file that overrides
the global resources stored in the RESOURCE_MAN-
AGER property.
FILES
/usr/lib/X11/app-defaults/XNetload - specifies required
resources.
/usr/etc/rpc.etherd - Must be running on target system.
SEE ALSOX(1), xrdb(1), mem(4), Athena StripChart Widget.
BUGS
This program requires the ability to talk to the
rpd.etherd daemon, and to set the ethernet interface into
promiscuous mode. Therefore, the Makefile installs the
program in /usr/bin/X11/ with root as the owner and with
the setuid bit set. This may not be necessary on some
(most) systems, depending on the ownership of rpc.etherd.
X Version 11 Release 1 2
XNETLOAD(1)XNETLOAD(1)COPYRIGHT
Taken from the original xload sources distributed with
X11R4. Original copyright is preserved below:
Copyright 1988, Massachusetts Institute of Technology.
See X(1) for a full statement of rights and permissions.
AUTHORS
Original xload authors: K. Shane Hartman (MIT-LCS) and
Stuart A. Malone (MIT-LCS);
with features added by Jim Gettys (MIT-Athena), Bob Schei-
fler (MIT-LCS), Tony Della Fera (MIT-Athena), and Chris
Peterson (MIT-LCS).
Modified to the current xnetload form by:
Roger Smith, Sterling Software at
NASA-Ames Research Center, Mountain View, Ca.
Much thanks and appreciation to Martyn Hampson of the
Imperial College Computer Centre for his contribution of
sunRPC for ULTRIX Systems.
For questions or reporting bugs:
rsmith@proteus.arc.nasa.gov
X Version 11 Release 1 3