HP X.25/9000 Programmer's Guide

Contents
5
Nonblocking Behavior of System Calls . . . . . . . . . . . . . . . . . . . . . . . . .58
Getting Next Message Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
The ioctl(X25_NEXT_MSG_STAT) Call . . . . . . . . . . . . . . . . . . . . . . . .61
Setting Buffer Thresholds and Sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Setting the Write Buffer Threshold. . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Setting the Read Message Fragment Size . . . . . . . . . . . . . . . . . . . . . .64
Changing the Size of Socket Buffers . . . . . . . . . . . . . . . . . . . . . . . . . .65
5. Receiving and Transmitting Out-of-band Information
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Receiving Out-of-band Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Signal reception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Building a Signal Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Example of an X.25 Signal Handler . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Out-of-band Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Transmitting Out-of-band Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
Clearing a Switched Virtual Circuit . . . . . . . . . . . . . . . . . . . . . . . . . . .78
The ioctl(X25_WR_CAUSE_DIAG) Call . . . . . . . . . . . . . . . . . . . . . . . .78
The ioctl(X25_WR_USER_DATA) Call . . . . . . . . . . . . . . . . . . . . . . . . .80
The ioctl(X25_RD_USER_DATA) Call . . . . . . . . . . . . . . . . . . . . . . . . .81
Resetting a Virtual Circuit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
The ioctl(X25_RESET_VC) Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
Sending Interrupts on a VC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
6. Extended Features
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
Using Facilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
The ioctl(X25_RD_FACILITIES) Call . . . . . . . . . . . . . . . . . . . . . . . . . .89
The ioctl (X25_WR_FACILITIES) Call . . . . . . . . . . . . . . . . . . . . . . . . .91
36960-90061.bk Page 5 Friday, November 10, 2000 3:42 PM