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.