====== ISDN plugin ======

This plogin provides information about the ISDN subsystem.

Note that this plugin has been developed and tested with Linux-2.4, isdn4linux and the HiSax-driver. I can't tell if Linux 2.6 and/or the new mISDN is supported. Any feedback on this would be appreciated!

----

===== Functions: =====

|isdn::info(key, channel)|parse /proc/isdninfo|
|isdn::cps(channel)|return ISDN throughput (character per second)|

----

===== isdn::info(key, channel) =====

This function parses /dev/isdninfo and returns the value of //key// for a specified //channel// (which is the column from /dev/isdninfo).

There are no predefined keys, but the portion before the first colon of every line from /dev/isdninfo is used verbatim. Take a look at your /dev/isdninfo for keys supported on your system. Common keys are 'usage', 'flags' or 'phone'.

----

===== isdn::cps(channel, delay) =====

This function returns the average throughput of the ISDN //channel// (prefixed by 'i' (input/received) or 'o' (output/transmitted). If you omit the channel number (which means specify only 'i' or 'o'), the sum over all available channels is returned. The throughput is averaged over //delay// milliseconds. Using 500 msec delivers good values.

Note that this function is available only if the file //linux/isdn.h// has been available at compile time!

----

===== Examples =====

Sorry, no examples :-)

I don' use ISDN anymore, so I cannot test it, and therefore don't have any sample configurations or widgets. It would be great if someone could provide one or another example here!

----