XISDNLOAD(1)XISDNLOAD(1)NAME
xisdnload - ISDN load average display for X
SYNOPSIS
xisdnload[-toolkitoption ...] [-scale integer] [-update seconds] [-hl
color] [-highlight color] [-online color] [-active color] [-trying
color] [-activate command] [-deactivate command] [-jumpscroll pixels]
[-number regexp] [-label string] [-nolabel]
DESCRIPTION
The xisdnload program displays a periodically updating histogram of the
ISDN load average.
OPTIONS
Xisdnload accepts all of the standard X Toolkit command line options
(see X(1)). The order of the options in unimportant. xisdnload also
accepts the following additional options:
-hl color or -highlight color
This option specifies the color of the scale lines.
-online color
This option specifies the background color when one or more
ISDN channels are online.
-active color
This option specifies the background color when any route is
found that is directed to an interface named isdn* or ippp*.
-trying color
This option specifies the background color when at least one
attempt to setup a cennection is pending.
-jumpscroll number 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 when
beeing online. It is interpreted as a standard format string
and may contain the dialed number (%s), the minutes (%d) and
seconds (%d) being online, the actual cps rate (%f), the amount
of kbytes transfered (%d) and a connection history (%s) in this
sequence.
-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 represents one load average
point. If the load goes above this number, xisdnload will cre‐
ate more divisions, but it will never use fewer than this num‐
ber. The default is 1.
-update seconds
This option specifies the interval in seconds at which xis‐
dnload updates its display. The minimum amount of time allowed
between updates is 1 second. The default is 10.
-activate command
This option specifies a command to be executed when dial-on-
demand is not active and you clicked on the xisdnload
stripchart. A typical command might be something like `sudo
/etc/init.d/isdn start' to start up your connection.
-deactivate command
This option specifies a command to be executed when dial-on-
demand is active and you clicked on the xisdnload stripchart. A
typical command might be something like `sudo /etc/init.d/isdn
stop' to shut down your connection.
-manual With this option the interface is assumed to be active and in
manual dial mode. The activate/deactive commands are selected
depending on the connection state. A typical activate command
might be `isdnctrl dial ippp0', and to deactivate `isdnctrl
hangup ippp0'.
-number regexp
The supplied regular expression is used to limit the set num‐
bers to be observed by xisdnload.
RESOURCES
See the resource file for the available resources.
WIDGETS
In order to specify resources, it is useful to know the hierarchy of
the widgets which compose xisdnload. In the notation below, indenta‐
tion indicates hierarchical structure. The widget class name is given
first, followed by the widget instance name.
XISDNLoad xisdnload
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_MANAGER property.
FILES
<XRoot>/lib/X11/app-defaults/XISDNLoad - specifies required resources.
/proc/net/route - kernel routing table. The proc filesystem is needed
by xisdnload to detect wheather a dial-on-demand is active.
SEE ALSOX(1), xrdb(1), xload(1), mem(4), Athena StripChart Widget.
BUGS
Certainly a lot.
COPYRIGHT
This program is based on xload which is Copyright (1988) X Consortium.
See X(1) for a full statement of rights and permissions.
AUTHORS
Besides the basic xload stuff, the ISDN parts are added by
Frank Strauss <strauss@escape.de> (escape e.V., Braunschweig, Germany).
In January 1998 Michael Deindl <olmur@dwarf.bb.bawue.de> contributed
the `yellow' patch to make xisdnload recognize the phase of trying to
connect and show this by a different background color. Markus
Pilzecker <mp@timesink.pilzecker.de> detected a bug in the color
assignment code resulting in seg faults which has been fixed in January
1998.
X Version 11 Release 6 XISDNLOAD(1)