DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

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)
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
HDK 7.1.0b - 15 March 2000