sol_ioctl Serial Optical Link Device Handler Entry Point

Purpose

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

Provides various functions for controlling the Serial Optical Link (SOL) device handler.

Syntax

#include <sys/device.h> #include <sys/devinfo.h> #include <sys/ioctl.h> #include <sys/comio.h> #include <sys/soluser.h> int sol_ioctl ( devno, cmd, arg, devflag, chan, ext) dev_t devno; int cmd, arg; ulong devflag; int chan, ext;

Parameters

Item	Description
devno	Specifies major and minor device numbers.
cmd	Specifies the operation to be performed. The possible sol_ioctl operation codes are in the /usr/include/sys/ioctl.h, /usr/include/sys/comio.h, and /usr/include/sys/soluser.h files.
arg	Specifies the address of the sol_ioctl parameter block.
devflag	Indicates the conditions under which the device was opened.
chan	Specifies the channel number assigned by the sol_mpx entry point.
ext	This parameter is not used by the SOL device handler.

Description

The sol_ioctl entry point provides various functions for controlling the SOL device handler. The possible sol_ioctl operations are:

Operation	Description
CIO_GET_FASTWRT	Provides the attributes of the sol_fastwrt entry point.
CIO_GET_STAT	Gets device status.
CIO_HALT	Halts the device.
CIO_QUERY	Queries device statistics.
CIO_START	Starts the device.
IOCINFO	Returns I/O character information.
SOL_CHECK_PRID	Checks whether a processor ID is connected.
SOL_GET_PRIDS	Gets connected processor IDs.

The sol_ioctl entry point functions with a Serial Link Adapter and Serial Optical Channel Converter that have been correctly configured for use on a qualified network. Consult hardware specifications for more information on configuring hardware and network qualifications.

Execution Environment

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