SPX/SPXII ioctls

SPX/SPXII ioctls

This section describes the ioctl commands used by NetWare®'s SPXII driver in a UNIX® environment. These ioctl commands are a subset ofTLI/XTI and allow an application to retrieve information or statistics aboutSPX/SPXII or a specific SPX/SPXII connection.

Although ioctls are not required when using TLI/XTI, they can be used to set up transfer data or tear down a connection with another endpoint. Some ioctl commands described in this section are provided for compatibility with older versions of SPX; others for setting or retrieving addition information or statistics. All ioctl commands described in this section are issued using the STREAMS I_STR ioctl.

SPX/SPXII is NetWare's connection-oriented, reliable transport protocol. For information on the enhanced SPXII protocol, packet structure and fields, and data flow, windowing and packet size negotiation, see ``Enhanced sequenced packet exchange (SPXII) protocol''.

Information on theSPX protocol, packet structure and fields, and data flow is provided for purposes of comparison in ``Sequenced packet exchange (SPX) protocol''.

``SPX/SPXII ioctls'' lists the ioctl commands that apply toSPX/SPXII.

SPX/SPXII ioctls

ioctl command Description
SPX_GS_MAX_PACKET_SIZE Returns the maximum data packet size that can be sent to the wire
SPX_GS_DATASTREAM_TYPE Sends a value in the Datastream byte in the header so that sender's packets are passed to the application withSPX/SPXII header preceding data
SPX_T_SYNCDATA_IOCTL Allows the sender to get an ACK/NAK for data sent as part of the ioctl
SPX_CHECK_QUEUE Allows an application to find out if all data has been sent and acknowledged
SPX_GET_STATS Allows an application to get the currentSPXII driver statistics
SPX_SPX2_OPTIONS Notifies theSPXII driver to useSPX2 rather than SPX options
SPX_GET_CON_STATS Returns the current statistics for anSPX/SPXII connection

 -------------------------------------------------------------------------
| ioctl command         |  Description                                   |
|-----------------------|------------------------------------------------|
| SPX_GS_MAX_PACKET_SIZE|  Returns the maximum data packet size that can |
|                       |  be sent to the wire                           |
|-----------------------|------------------------------------------------|
| SPX_GS_DATASTREAM_TYPE|  Sends a value in the Datastream byte in the   |
|                       |  header so that sender's packets are passed to |
|                       |  the application withSPX/SPXII header preceding|
|                       |  data                                          |
|-----------------------|------------------------------------------------|
| SPX_T_SYNCDATA_IOCTL  |  Allows the sender to get an ACK/NAK for data  |
|                       |  sent as part of the ioctl                     |
|-----------------------|------------------------------------------------|
| SPX_CHECK_QUEUE       |  Allows an application to find out if all data |
|                       |  has been sent and acknowledged                |
|-----------------------|------------------------------------------------|
| SPX_GET_STATS         |  Allows an application to get the currentSPXII |
|                       |  driver statistics                             |
|-----------------------|------------------------------------------------|
| SPX_SPX2_OPTIONS      |  Notifies theSPXII driver to useSPX2 rather    |
|                       |  than SPX options                              |
|-----------------------|------------------------------------------------|
| SPX_GET_CON_STATS     |  Returns the current statistics for anSPX/SPXII|
|                       |  connection                                    |
|-----------------------|------------------------------------------------|

© 1999 The Santa Cruz Operation, Inc. All rights reserved.
UnixWare 7 Release 7.1 - 19 March 1999