xisdnload - ISDN load average display for X
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]
The xisdnload program displays a periodically updating
histogram of the ISDN load average.
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 being 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 transferred (%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 create more divisions, but it
will never use fewer than this number. The default is 1.
- -update
seconds
- This option specifies the interval in seconds at which xisdnload
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 numbers to be
observed by xisdnload.
See the resource file for the available resources.
In order to specify resources, it is useful to know the hierarchy
of the widgets which compose xisdnload. In the notation below,
indentation indicates hierarchical structure. The widget class name is given
first, followed by the widget instance name.
XISDNLoad xisdnload
Paned paned
Label label
StripChart load
- 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.
<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.
This program is based on xload which is Copyright (1988) X
Consortium. See X(1) for a full statement of rights and
permissions.
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.