Note: This function is supported in AIX 5.1 and earlier only.
Provides various functions for controlling the Multiprotocol Quad Port (MPQP) adapter.
#include <sys/devinfo.h> #include <sys/ioctl.h> #include <sys/comio.h> #include <sys/mpqp.h>
int mpioctl (devno, cmd, extptr, devflag, chan, ext) dev_t devno; int cmd, extptr; ulong devflag; int chan, ext;
| devno | Specifies major and minor device numbers. |
| cmd | Identifies the operation to be performed. |
| extptr | Specifies an address of the parameter block. |
| devflag | Allows mpioctl calls to inherit properties that were specified at open time. The MPQP device handler inspects the DNDELAY flag for ioctl calls. Kernel-mode data link control (DLC) sets the DKERNAL flag that must be set for an mpopen call. |
| chan | Specifies the channel number assigned by the mpmpx entry point. |
| ext | Not used by MPQP device handler. |
The mpioctl entry point provides various functions for controlling the MPQP adapter. There are 16 valid mpioctl operations, including:
| Operation | Description |
|---|---|
| CIO_GET_STATUS | Gets the status of the current MPQP adapter and device handler. |
| CIO_HALT | Ends a session with the MPQP device handler. |
| CIO_START | Initiates a session with the MPQP device handler. |
| CIO_QUERY | Reads the counter values accumulated by the MPQP device handler. |
| MP_CHG_PARMS | Permits the DLC to change certain profile parameters after the MPQP device has been started. |
| MP_START_AR | Puts the MPQP port into Autoresponse mode. |
| MP_STOP_AR | Permits the MPQP port to exit Autoresponse mode. |
The mpioctl 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 mpioctl operation codes can be found in the /usr/include/sys/ioctl.h, /usr/include/sys/comio.h, and /usr/include/sys/mpqp.h files.
The mpioctl entry point can be called from the process environment only.
The common return codes for the mpioctl entry point are:
| Return Code | Description |
|---|---|
| ENOMEM | Indicates the no memory buffers (mbufs) or mbuf clusters are available. |
| ENXIO | Indicates the adapter number is out of range. |
The mpclose entry point, mpconfig entry point, mpmpx entry point,, mpopen entry point, mpread entry point, mpselect entry point, mpwrite entry point.
The CIO_GET_STAT mpioctl MPQP Device Handler Operation, CIO_HALT mpioctl MPQP Device Handler Operation, CIO_QUERY mpioctl MPQP Device Handler Operation, CIO_START mpioctl MPQP Device Handler Operation, MP_CHG_PARMS mpioctl MPQP Device Handler Operation, MP_START_AR and MP_STOP_AR mpioctl MPQP Device Handler Operations.