tsioctl Multiprotocol (PCI MPQP) Device Handler Entry Point

Purpose

Provides various functions for controlling the IBM® ARTIC960Hx PCI adapter (PCI MPQP) and device handler.

Syntax

#include <sys/devinfo.h>
#include <sys/ioctl.h>
#include <sys/comio.h>
#include <sys/mpqp.h>
int tsioctl 
(devno, cmd, extptr, devflag, chan, ext)
dev_t devno;
int cmd, extptr;
ulong devflag;
int chan, ext;

Description

The tsioctl entry point provides various functions for controlling the PCI MPQP adapter. There are 16 valid tsioctl operations, including:

Item Description
CIO_GET_STAT Gets the status of the current PCI MPQP adapter and device handler.
CIO_HALT Ends a session with the PCI MPQP device handler.
CIO_START Initiates a session with the PCI MPQP device handler.
CIO_QUERY Reads the counter values accumulated by the PCI MPQP device handler.
MP_CHG_PARMS Permits the DLC to change certain profile parameters after the PCI MPQP device has been started.

The tsioctl entry point functions with a 4-Port Multiprotocol Interface adapter that has been correctly configured for use on a qualified network. Consult the adapter specifications for more information on configuring the adapter and network qualifications.

The possible tsioctl operation codes can be found in the /usr/include/sys/ioctl.h, /usr/include/sys/comio.h, and /usr/include/sys/mpqp.h files.

Parameters

Item Description
devno Specifies major and minor device numbers.
cmd Identifies the operation to be performed.
extptr Specifies an address of the parameter block.
devflag Allows tsioctl calls to inherit properties that were specified at open time. The PCI MPQP device handler inspects the DNDELAY flag for ioctl calls. Kernel-mode data link control (DLC) sets the DKERNEL flag that must be set for a tsopen call.
chan Specifies the channel number assigned by the tsmpx entry point.
ext Not used by PCI MPQP device handler.

Execution Environment

The tsioctl entry point can be called from the process environment only.

Return Values

The common return codes for the tsioctl entry point are:

Item Description
ENOMEM Indicates the no memory buffers (mbufs) or mbuf clusters are available.
ENXIO Indicates the adapter number is out of range.