mpioctl Multiprotocol (MPQP) Device Handler Entry Point

Purpose

Note: This function is supported in AIX® 5.1 and earlier only.

Provides various functions for controlling the Multiprotocol Quad Port (MPQP) adapter.

Syntax

#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;

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 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.

Description

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.

Execution Environment

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

Return Values

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.