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 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.

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,  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.