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 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.
RESOURCES¶
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
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 ALSO¶
X(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.