2002-09-03 12:11:30 +00:00
|
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2002-08-19 05:50:13 +00:00
|
|
|
|
<HTML>
|
|
|
|
|
|
<HEAD>
|
|
|
|
|
|
<TITLE>isdninfo - ISDN status device</TITLE>
|
|
|
|
|
|
<!--#include virtual="/ssi/js.shtml" -->
|
|
|
|
|
|
<!--#include virtual="/ssi/buttondefs.shtml" -->
|
|
|
|
|
|
</HEAD>
|
|
|
|
|
|
<BODY BGCOLOR="#FFFFFF">
|
|
|
|
|
|
<TABLE WIDTH="100%">
|
|
|
|
|
|
<TR>
|
|
|
|
|
|
<TD ALIGN=LEFT WIDTH="90"><!--#include virtual="/ssi/b_home.shtml" --></TD>
|
|
|
|
|
|
<TD ALIGN=RIGHT WIDTH="90"><!--#include virtual="/ssi/b_index.shtml" --></TD>
|
|
|
|
|
|
</TR>
|
|
|
|
|
|
</TABLE>
|
|
|
|
|
|
<PRE>
|
|
|
|
|
|
isdninfo - ISDN status device
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>SYNOPSIS</H2><PRE>
|
|
|
|
|
|
<STRONG>#include</STRONG> <STRONG><linux/isdn.h></STRONG>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
|
|
|
|
<EM>/dev/isdninfo</EM> is a character device with major number <STRONG>45</STRONG>
|
|
|
|
|
|
and minor number <STRONG>255</STRONG>. It delivers status information from
|
|
|
|
|
|
the Linux ISDN subsystem to user level.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>DATA FORMAT</H2><PRE>
|
|
|
|
|
|
When reading from this device, the current status of the
|
|
|
|
|
|
Linux ISDN subsystem is delivered in <STRONG>6</STRONG> lines of text. Each
|
|
|
|
|
|
line starts with a tag string followed by a colon and
|
|
|
|
|
|
whitespace. After that the status values are appended sep<65>
|
|
|
|
|
|
arated by whitespace.
|
|
|
|
|
|
|
|
|
|
|
|
<STRONG>idmap</STRONG> is the tag of the first line. In this line for
|
|
|
|
|
|
every virtual channel, the Id-string of the corre<72>
|
|
|
|
|
|
sponding lowlevel driver is shown. If no driver is
|
|
|
|
|
|
loaded, a - (hyphen) is shown.
|
|
|
|
|
|
|
|
|
|
|
|
<STRONG>chmap</STRONG> is the tag of line 2. In this line for every vir<69>
|
|
|
|
|
|
tual channel, the channel number of the correspond<6E>
|
|
|
|
|
|
ing lowlevel driver is shown. If no driver is
|
|
|
|
|
|
loaded, -1 is shown.
|
|
|
|
|
|
|
|
|
|
|
|
<STRONG>drmap</STRONG> is the tag of line 3. In this line for every vir<69>
|
|
|
|
|
|
tual channel, the index number of the corresponding
|
|
|
|
|
|
lowlevel driver is shown. If no driver is loaded,
|
|
|
|
|
|
-1 is shown.
|
|
|
|
|
|
|
|
|
|
|
|
<STRONG>usage</STRONG> is the tag of line 4. In this line for every vir<69>
|
|
|
|
|
|
tual channel, the current usage is shown. The fol<6F>
|
|
|
|
|
|
lowing usage constants are defined:
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_USAGE_NONE">ISDN_USAGE_NONE</A></STRONG> (0)
|
2002-08-19 05:50:13 +00:00
|
|
|
|
Unused channel
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_USAGE_RAW">ISDN_USAGE_RAW</A></STRONG> (1)
|
2002-08-19 05:50:13 +00:00
|
|
|
|
Channel used by raw device (currently unsup<75>
|
|
|
|
|
|
ported)
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_USAGE_MODEM">ISDN_USAGE_MODEM</A></STRONG> (2)
|
2002-08-19 05:50:13 +00:00
|
|
|
|
Channel used by some ttyI
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_USAGE_NET">ISDN_USAGE_NET</A></STRONG> (3)
|
2002-08-19 05:50:13 +00:00
|
|
|
|
Channel used by an ISDN net-interface
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_USAGE_VOICE">ISDN_USAGE_VOICE</A></STRONG> (4)
|
2002-08-19 05:50:13 +00:00
|
|
|
|
Channel used by some ttyI in voice mode.
|
|
|
|
|
|
|
|
|
|
|
|
Channel exclusively preserved for a net-
|
|
|
|
|
|
interface. This value is logically or'ed
|
|
|
|
|
|
with one of the other codes.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_USAGE_OUTGOING">ISDN_USAGE_OUTGOING</A></STRONG> (128)
|
2002-08-19 05:50:13 +00:00
|
|
|
|
Channel is used outgoing. This value is log<6F>
|
|
|
|
|
|
ically or'ed with one of the other codes. It
|
|
|
|
|
|
is set, when dialling is started and reset,
|
|
|
|
|
|
when either dialling failed or after hangup.
|
|
|
|
|
|
Therefore, it is <STRONG>not</STRONG> always an indicator for
|
|
|
|
|
|
an established connection. To get a reliable
|
|
|
|
|
|
indicator for an established connection, the
|
|
|
|
|
|
driver flags (see below) have to be
|
|
|
|
|
|
inspected also.
|
|
|
|
|
|
|
|
|
|
|
|
<STRONG>flags</STRONG> is the tag of line 5. In this line for every driver
|
|
|
|
|
|
slot, it's B-Channel status is shown. If no driver
|
|
|
|
|
|
is registered in a slot, a ? is shown. For every
|
|
|
|
|
|
established B-Channel of the driver, a bit is set
|
|
|
|
|
|
in the shown value. The driver's first channel is
|
|
|
|
|
|
mapped to bit 0, the second channel to bit 1 and so
|
|
|
|
|
|
on.
|
|
|
|
|
|
|
|
|
|
|
|
<STRONG>phone</STRONG> is the tag of line 6. In this line for every vir<69>
|
|
|
|
|
|
tual channel, the remote phone number is shown if
|
|
|
|
|
|
the channel is active. A ??? is shown, if the chan<61>
|
|
|
|
|
|
nel is inactive.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>BLOCKING BEHAVIOUR</H2><PRE>
|
|
|
|
|
|
After opening the device, at most 6 lines can be read by a
|
|
|
|
|
|
user process. After that, the user process is blocked.
|
|
|
|
|
|
Whenever a status change happens, the process is allowed
|
|
|
|
|
|
to read 6 more lines, starting with line one.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>IOCTL FUNCTIONS</H2><PRE>
|
|
|
|
|
|
Currently, there are two ioctl calls supported:
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#IIOCGETDVR">IIOCGETDVR</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
Get Revision information.
|
|
|
|
|
|
Returns an unsigned long value <EM>v</EM>, representing var<61>
|
|
|
|
|
|
ious user level interface revisions, where
|
|
|
|
|
|
|
|
|
|
|
|
<STRONG>(</STRONG><EM>v</EM> <STRONG>&</STRONG> <STRONG>0xff)</STRONG>
|
|
|
|
|
|
is the revision of the modem-register info,
|
|
|
|
|
|
available via ioctl on <EM>/dev/isdnctrl</EM>.
|
|
|
|
|
|
|
|
|
|
|
|
<STRONG>((</STRONG><EM>v</EM> <STRONG>>></STRONG> <STRONG>8)</STRONG> <STRONG>&</STRONG> <STRONG>0xff)</STRONG>
|
|
|
|
|
|
is the revision of the net-interface config
|
|
|
|
|
|
data, available via ioctl on <EM>/dev/isdnctrl</EM>.
|
|
|
|
|
|
and
|
|
|
|
|
|
is the revision of the data delivered via
|
|
|
|
|
|
<EM>/dev/isdninfo</EM> itself.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#IIOCGETCPS">IIOCGETCPS</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
Get transfer statistics.
|
|
|
|
|
|
Returns the number of bytes transferred so far for
|
|
|
|
|
|
all virtual channels. The third parameter should be
|
|
|
|
|
|
a pointer to an array of unsigned long of size
|
|
|
|
|
|
ISDN_MAX_CHANNELS * 2. This array is filled with
|
|
|
|
|
|
the byte counter values upon return.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>OTHER CONSTANTS</H2><PRE>
|
|
|
|
|
|
There are some more useful constants defined in
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<EM><A HREF="includes/isdn.h.shtml">/usr/include/linux/isdn.h</A></EM>:
|
2002-08-19 05:50:13 +00:00
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_TTY_MAJOR">ISDN_TTY_MAJOR</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The major device number of <EM>/dev/ttyI</EM>.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_TTYAUX_MAJOR">ISDN_TTYAUX_MAJOR</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The major device number of <EM>/dev/cui</EM>.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_MAJOR">ISDN_MAJOR</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The major device number of <EM>/dev/isdnctrl</EM>, <EM>/dev/isd<73></EM>
|
|
|
|
|
|
<EM>ninfo</EM>, <EM>/dev/ippp</EM> and <EM>/dev/isdn</EM>
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_MAX_DRIVERS">ISDN_MAX_DRIVERS</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The number of driver slots.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_MAX_CHANNELS">ISDN_MAX_CHANNELS</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The number of virtual channels.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#"></A></STRONG>
|
|
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_MINOR_CTRL">ISDN_MINOR_CTRL</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The minor device number of <EM>/dev/isdnctrl0</EM>.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_MINOR_CTRLMAX">ISDN_MINOR_CTRLMAX</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The minor device number of <EM>/dev/isdnctrl63</EM>.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_MINOR_PPP">ISDN_MINOR_PPP</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The minor device number of <EM>/dev/ippp0</EM>.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_MINOR_PPPMAX">ISDN_MINOR_PPPMAX</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The minor device number of <EM>/dev/ippp64</EM>.
|
|
|
|
|
|
|
2004-02-12 12:09:55 +00:00
|
|
|
|
<STRONG><A HREF="includes/isdn.h.shtml#ISDN_MINOR_STATUS">ISDN_MINOR_STATUS</A></STRONG>
|
2002-08-19 05:50:13 +00:00
|
|
|
|
The minor device number of <EM>/dev/isdninfo</EM>.
|
|
|
|
|
|
|
|
|
|
|
|
Other constants, necessary for ioctl's on <EM>/dev/isdnctrl</EM>
|
|
|
|
|
|
are listed in <STRONG>isdnctrl</STRONG>(4).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>AUTHOR</H2><PRE>
|
|
|
|
|
|
Fritz Elfert <fritz@wuemaus.franken.de>
|
|
|
|
|
|
|
|
|
|
|
|
<STRONG>isdnctrl</STRONG>(4), <STRONG>icnctrl</STRONG>(4).
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
</BODY>
|
|
|
|
|
|
</HTML>
|
