DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5

mac_stats_isdn(D4mdi)

mac_stats_isdn -- ISDN statistics structure for the MACIOC_GETSTAT ioctl

Synopsis

   #include <sys/ddi.h>
   #include <sys/mdi.h>
   

   typedef struct mac_stats_isdn {
       isdn_dchannel_stats_t   dchannel;
       isdn_signaling_stats_t  signaling;
       isdn_bchannel_stats_t   bchannel[30];
   } mac_stats_isdn_t;

Description

mac_stats_isdn is the ISDN statistics structure for the MDI MACIOC_GETSTAT ioctl. It consists of one structure each for D channel, signalling, and B channel information. The mac_stats_isdn structure is used to pass status information concerning the ISDN driver to the ndstat utility.

The status information defined by this structure is a subset of the SNMP (Simple Network Management Protocol) Version 2 MIB (Management Information Base) described in RFC 2127. Although this set of managed objects is consistent with the SNMP framework and existing SNMP standards, it is not compliant to the SNMPv2 SMI and should not be used for SNMP management.

D channel statistics

D channel statistics (the dchannel member of mac_stats_isdn) are conveyed in the isdn_dchannel_stats structure: 
   #include <sys/types.h>
   #include <sys/ddi.h>
   #include <sys/mdi.h>
   

   typedef struct isdn_dchannel_stats {
       ulong   speed;
       ulong   mtu;
       ulong   LapdOperStatus;
       ulong   InOctets;
       ulong   InUcastPkts;
       ulong   InBroadcastPkts;
       ulong   InDiscards;
       ulong   InErrors;
       ulong   InUnkownProtos;
       ulong   OutOctets;
       ulong   OutUcastPkts;
       ulong   OutBroadcastPkts;
       ulong   OutDiscards;
       ulong   OutErrors;
       ulong   filler1;
       ulong   filler2;
       ulong   filler3;
       ulong   filler4;
   } isdn_dchannel_stats_t;
Structure members are:

speed
maximum throughput supported on this interface

mtu
Maximum Transmission Unit

LapdOperStatus
operational status of the D channel. Valid values are:

value ndstat message
LAPD_NONE Device Not Reporting LAPD Status
LAPD_INACTIVE Inactive
LAPD_L1ACTIVE Layer 1 Active
LAPD_L2ACTIVE Layer 2 Active 

 value               ndstat message
 LAPD_NONE           Device Not Reporting LAPD Status
 LAPD_INACTIVE       Inactive
 LAPD_L1ACTIVE       Layer 1 Active
 LAPD_L2ACTIVE       Layer 2 Active

InOctets
number of 8-bit bytes received

InUcastPkts
number of unicast packets received

InBroadcastPkts
number of broadcast packets received

InDiscards
number of incoming packets discarded

InErrors
number of packets received with errors

InUnkownProtos
number of unknown protocol transmissions received

OutOctets
number of 8-bit bytes sent

OutUcastPkts
number of unicast packets sent

OutBroadcastPkts
number of broadcast packets sent

OutDiscards
number of outcoming packets discarded

OutErrors
number of packets sent with errors

filler[1-4]
reserved for future use

Signalling statistics

Signalling statistics (the signalling member of mac_stats_isdn) are conveyed in the isdn_signaling_stats structure: 
   #include <sys/types.h>
   #include <sys/ddi.h>
   #include <sys/mdi.h>
   

   typedef struct isdn_signaling_stats {
       ulong   SignalingProtocol;
       unchar  CallingAddress[2][32];
       unchar  CallingSubAddress[2][32];
       ulong   BchannelCount;
       ulong   InCalls;
       ulong   InConnected;
       ulong   OutCalls;
       ulong   OutConnected;
       ulong   ChargedUnits;
       ulong   filler1;
       ulong   filler2;
       ulong   filler3;
       ulong   filler4;
   } isdn_signaling_stats_t;
Structure members are:

SignalingProtocol
ISDN signaling protocol in use. Valid values are:

value ndstat message
SIGPROT_NONE Protocol Information Not Available
SIGPROT_Q931 ITU DSS1 Q.931
SIGPROT_ETSI Europe / ETSI
SIGPROT_UKDASS2 U.K. / DASS2 (PRI)
SIGPROT_USA4ESS U.S.A. / AT&T 4ESS
SIGPROT_USA5ESS U.S.A. / AT&T 5ESS
SIGPROT_USADMS1 U.S.A / Northern Telecom DMS100
SIGPROT_USADMS2 U.S.A / Northern Telecom DMS250
SIGPROT_USANI1 U.S.A National ISDN 1 (BRI)
SIGPROT_USANI2 U.S.A National ISDN 2 (BRI, PRI)
SIGPROT_FRNVN2 France / VN2
SIGPROT_FRNVN3 France / VN3
SIGPROT_FRNVN4 France / VN4 (ETSI with changes)
SIGPROT_FRNVN6 France / VN6 (ETSI with changes)
SIGPROT_JPNKDD Japan / KDD
SIGPROT_JPNNI64 Japan / NTT INS64
SIGPROT_JPNNI15 Japan / NTT INS1500
SIGPROT_GER1TR6 Germany / 1TR6 (BRI, PRI)
SIGPROT_GERSIEM Germany / Siemens HiCom CORNET
SIGPROT_AUTS013 Australia / TS013
SIGPROT_AUTS014 Australia / TS014
SIGPROT_QSIG Q.SIG
SIGPROT_SWNET2 SwissNet-2
SIGPROT_SWNET3 SwissNet-3 

 value                 ndstat message
 SIGPROT_NONE          Protocol Information Not Available
 SIGPROT_Q931          ITU DSS1 Q.931
 SIGPROT_ETSI          Europe / ETSI
 SIGPROT_UKDASS2       U.K. / DASS2 (PRI)
 SIGPROT_USA4ESS       U.S.A. / AT&T 4ESS
 SIGPROT_USA5ESS       U.S.A. / AT&T 5ESS
 SIGPROT_USADMS1       U.S.A / Northern Telecom DMS100
 SIGPROT_USADMS2       U.S.A / Northern Telecom DMS250
 SIGPROT_USANI1        U.S.A National ISDN 1 (BRI)
 SIGPROT_USANI2        U.S.A National ISDN 2 (BRI, PRI)
 SIGPROT_FRNVN2        France / VN2
 SIGPROT_FRNVN3        France / VN3
 SIGPROT_FRNVN4        France / VN4 (ETSI with changes)
 SIGPROT_FRNVN6        France / VN6 (ETSI with changes)
 SIGPROT_JPNKDD        Japan / KDD
 SIGPROT_JPNNI64       Japan / NTT INS64
 SIGPROT_JPNNI15       Japan / NTT INS1500
 SIGPROT_GER1TR6       Germany / 1TR6 (BRI, PRI)
 SIGPROT_GERSIEM       Germany / Siemens HiCom CORNET
 SIGPROT_AUTS013       Australia / TS013
 SIGPROT_AUTS014       Australia / TS014
 SIGPROT_QSIG          Q.SIG
 SIGPROT_SWNET2        SwissNet-2
 SIGPROT_SWNET3        SwissNet-3

CallingAddress
local ISDN number

CallingSubAddress
local ISDN subaddress

BchannelCount
number of B channels available

InCalls
number of incoming calls on the interface

InConnected
number of connected incoming calls on the interface

OutCalls
number of outgoing calls on the interface

OutConnected
number of connected outgoing calls on the interface

ChargedUnits
number of charged units on this interface since system startup

filler[1-4]
reserved for future use

B channel statistics

B channel statistics (the bchannel member of mac_stats_isdn) are conveyed in the isdn_bchannel_stats structure: 
   #include <sys/types.h>
   #include <sys/ddi.h>
   #include <sys/mdi.h>
   

   typedef struct isdn_bchannel_stats {
       ulong   OperStatus;
       ulong   AppID;
       ulong   ChannelNumber;
       unchar  PeerAddress[32];
       unchar  PeerSubAddress[32];
       ulong   CallOrigin;
       ulong   InfoType;
       time_t  CallSetupTime;
       time_t  CallConnectTime;
       ulong   ChargedUnits;
       ulong   filler1;
       ulong   filler2;
       ulong   filler3;
       ulong   filler4;
   } isdn_bchannel_stats_t;

Structure members are:


OperStatus
operational status. Valid values are:

value ndstat message
BSTATUS_NONE Device not reporting B channel statistics
BSTATUS_IDLE Idle
BSTATUS_CNNCTNG Connecting
BSTATUS_CNNCTD Connected
BSTATUS_ACTIVE Active 

 value                 ndstat message
 BSTATUS_NONE          Device not reporting B channel statistics
 BSTATUS_IDLE          Idle
 BSTATUS_CNNCTNG       Connecting
 BSTATUS_CNNCTD        Connected
 BSTATUS_ACTIVE        Active

AppID
application ID

ChannelNumber
B channel number

PeerAddress
the ISDN address that the current or last call was connected to

PeerSubAddress
the ISDN subaddress that the current or last call was connected to

CallOrigin
call origin. Valid values are:

value ndstat message
BCALLORIG_OUT Outgoing
BCALLORIG_IN Incoming
BCALLORIG_CBACK Callback 

 value                 ndstat message
 BCALLORIG_OUT         Outgoing
 BCALLORIG_IN          Incoming
 BCALLORIG_CBACK       Callback

InfoType
Information transfer capability. Valid values are:

value ndstat message
BINFOTYPE_NONE Unknown
BINFOTYPE_SPCH Speech
BINFOTYPE_UDI Unrestricted Digital Information
BINFOTYPE_UDI56 Unrestricted Digital Information 56Kbit/s Rate Ad option
BINFOTYPE_RDI Restricted Digital Information
BINFOTYPE_3KAUD 3.1 kHz Audio
BINFOTYPE_7KAUD 7 kHz Audio
BINFOTYPE_VIDEO Video
BINFOTYPE_PCKT Packet Mode 

 value                 ndstat message
 BINFOTYPE_NONE        Unknown
 BINFOTYPE_SPCH        Speech
 BINFOTYPE_UDI         Unrestricted Digital Information
 BINFOTYPE_UDI56       Unrestricted Digital Information
                       56Kbit/s Rate Ad option
 BINFOTYPE_RDI         Restricted Digital Information
 BINFOTYPE_3KAUD       3.1 kHz Audio
 BINFOTYPE_7KAUD       7 kHz Audio
 BINFOTYPE_VIDEO       Video
 BINFOTYPE_PCKT        Packet Mode

CallSetupTime
the value of time when the ISDN setup message for the current or last call was sent or received

CallConnectTime
the value of time when the ISDN connect message for the current or last call was sent or received

ChargedUnits
number of charged units on this interface since system startup

filler[1-4]
reserved for future use

Hardware applicability

All

Version applicability

mdi: 2, 2.1

Differences between versions

This function is not supported in MDI on SCO OpenServer systems.

References

isdn MACIOC_GETSTAT

Section D4isdn manual pages in Section D4isdn manual pages, Section D7isdn manual pages in Section D7isdn manual pages,

``SCO ISDN adapter drivers'' in Developing MDI network adapter drivers

``MDI ioctls'' in HDK Technical Reference.

19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005