NIO CommKit Host Interface Installation and System Administration Manual

ManualsBrandsHP ManualsSoftwareHP-UX 11i v1 Networking Software

221

222

223

224

225

226

227

228

229

230

DKTSPLICE(3X) DKTSPLICE(3X)

E-64 CommKit Host Interface, Release 4.0

NAME

dktsplice – transparent splice facility

SYNOPSIS

#include <dkit/dk.h>

#include <dkit/dkmgr.h>

dktr_splice(mgrp, dialstring, intf, uid)

struct mgrmsg *mgrp;

char * dialstring;

int intf;

uid_t uid;

dktr_osplice(mgrp, dialstring, intf, schan, nchan, uid)

struct mgrmsg *mgrp;

char * dialstring;

int intf, schan, nchan;

uid_t uid;

dktr_call(dialstring, intf, schan, nchan, baud, rbuf, uid)

char * dialstring, * baud;

int intf, schan, nchan, rbuf;

uid_t uid;

extern FILE * logf;

extern int loglvl;

DESCRIPTION

This set of functions is provided for the use of security servers that wish to make use of the transparent splice

facility available on newer releases of the AT&T Data Switch. dktr_splice and dktr_osplice will request a

transparent splice for an incoming call request represented by mgrp and the destination represented by

dialstring. The interface of the outgoing call is given in intf and must be the interface of the incoming call

request. The outgoing call will be placed as user uid, assuming uid is valid on the splicing host. dktr_osplice

has two additional parameters that attempt to place the outgoing call on channel in the range of schan to

(schan plus nchan). These two parameters allow the outgoing calls to be confined to some known originating

group on the data switch.

Both of these function will place the outgoing call using the baud rate and receive buffer size from the

incoming call request and then will answer the incoming call request with the receive buffer size from the

answer of the outgoing call. The functions instruct the two circuits to withhold initialization and then splice

the two circuits.

dktr_call is a support function for dktr_splice and dktr_osplice. Most applications of dktr_splice and

dktr_osplice do not need to call dktr_call; however, it is available as an external function. dktr_call makes

the outgoing call and allows additional control over the outgoing dialstring. The parameters baud will set the

baud rate and rbuf will set the advertised receive buffer size in the dialstring.

FILES

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

/dev/dk/dial default dialer device

/dev/dk/dialX dialer device for interface X

/dev/dk/ctlX Common Signaling Channel device for interface X