NIO CommKit Host Interface Installation and System Administration Manual

DK_UXINFO(3X) DK_UXINFO(3X)

E-67 CommKit Host Interface, Release 4.0

NAME

dk_uxinfo – get and set information about an AT&T data switch connection

SYNOPSIS

#include <dkit/dk.h>

dk_uxinfo(fd, cmd, c_uxinfop)

int fd;

int cmd;

dk_uxwin_t∗c_uxinfop;

extern int dk_verbose;

DESCRIPTION

dk_uxinfo is a general-purpose routine retrieving or setting parameters of an open host device. This routine

is valid only for file descriptors associated with a dkhs(7) stream when the dkux(7) module is pushed onto that

stream. fd is an open file descriptor associated with a CommKit stream. cmd is one of the following:

DKGET_UXW Get the log base 2 values of the URP receive buffers and maximum number of

outstanding URP blocks.

DKSET_UXW Set the log base 2 values of the URP receive buffers and maximum number of

outstanding URP blocks. Values that fall outside of the implementation dependent

limits will be adjusted to the closest allowed values. Values of zero will be replaced by

the implementation dependent default values. Similarly values that produce

unacceptable URP windows will be adjusted to reasonable values. In all cases the

actual values used will be returned in the space pointed to by the structure pointer.

c_uxinfop points to a structure of type dk_uxwin_t. This structure includes the following members defined as

unsigned short variables:

nurpblks; /* number of outstanding URP blocks */

rem_rbuf; /* log2 value of remote side receive buffer */

loc_rbuf; /* log2 value of our receive buffer */

nurpblks is the maximum number of outstanding URP blocks. This value is used by the local transmitter when

it sizes the amount of data that will be transmitted in each URP block. rem_rbuf is the log base 2 value of the

receive buffer of the remote side. It is used by the local transmitter to limit the maximum number of bytes

transmitted in an URP window. loc_rbuf is the log base 2 value of the receive buffer of the local side. It is the

value advertised in outgoing dialstrings so that a remote transmitter can tailor its URP window.

FILES

/usr/lib/libdk.so host interface subroutine library