ISDN_REGISTER(7isdn)

ISDN_REGISTER -- bind a STREAM to an ISDN device

Synopsis

   #include <sys/stream.h>
   #include <sys/mdi.h>
   #include <sys/scoisdn.h>
   
   typedef struct isdn_register_params
   {
       isdnU16_t	ApplId;
       isdnU32_t	level3cnt;
       isdnU32_t	datablkcnt;
       isdnU32_t	datablklen;
   } isdn_register_params_t;

Description

This ioctl binds a Stream to an ISDN device. That is, a device dev/netx opened to the DLPI module registers itself with the MDI ISDN driver by means of this ioctl. This ioctl must be processed before the device will respond to ISDN messages.

Parameters

The data portion of the ioctl uses the isdn_register_params structure. The ISDN device allocates resources based on the parameters level3cnt, datablkcnt, and datablklen. Failure to allocate enough resources may cause connection establishment failures or data messages to be lost. The structure members are:

ApplId: application identifier
level3cnt: number of simultaneous logical connections. Note that there may be many logical connections over a single physical connection.
datablkcnt: number of buffered data messages.
datablklen: size of buffered data messages. If datablklen is too small, messages may be lost.

Data returned

The MDI ISDN driver should return the allocated application identifier in the ApplId field of the isdn_register_params structure. The ISDN driver should use this application identifier in the ApplId field of the isdn_msg_hdr(D4isdn) header for all ISDN messages pertaining to this application.

The application need not specify the ApplId field of the isdn_msg_hdr for ISDN messages to the ISDN device; the DLPI in HDK Technical Reference module performs this function.

The data is one of the following:

M_IOCACK(D7str): Acknowledge successful completion of the operation. Set ioc_rval set to zero and return the associated ApplId in the isdn_register_params structure.
M_IOCNAK(D7str): Acknowledge unsuccessful completion of the operation. Set ioc_count to zero, ioc_rval to -1, and ioc_error to an appropriate value from errnos(D5).

References

Intro(7isdn)