[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2

mpioctl Multiprotocol (MPQP) Device Handler Entry Point

Purpose

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

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:

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

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

Implementation Specifics

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.

Related Information

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.


[ Previous | Next | Contents | Home | Search ]