xisdnload



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



X Version 11                       Release 6                      XISDNLOAD(1)

Man(1) output converted with man2html