CIO_QUERY (Query Statistics) sol_ioctl Serial Optical Link Device Handler Operation

Kernel and Subsystems Technical Reference, Volume 2

CIO_QUERY (Query Statistics) sol_ioctl Serial Optical Link Device Handler Operation

Purpose

Enables the caller to read the counter values accumulated by the Serial Optical Link (SOL) device handler.

Description

The CIO_QUERY operation reads the counter values accumulated by the SOL device handler. The first call to the sol_open entry point initializes the counters to 0.

For the CIO_QUERY operation, the arg parameter points to the query_parms structure. This structure is defined in the /usr/include/sys/comio.h file and contains the following fields:

`status`	Indicates the status of the command. This field may have a value of CIO_OK or CIO_INV_CMD.
`bufptr`	Specifies the address of a buffer where the returned statistics are to be placed.
`buflen`	Specifies the length of the buffer.
`clearall`	When the value of this field is CIO_QUERY_CLEAR, the counters are cleared upon completion of the call. The CIO_QUERY_CLEAR label can be found in the /usr/include/sys/comio.h file.

The counters placed in the supplied buffer by the CIO_QUERY operation are the counters declared in the sol_query_stats_t structure defined in the /usr/include/sys/soluser.h file.

Execution Environment

The CIO_QUERY operation can be called from the process environment only.

Return Values

EFAULT	Indicates the specified address is not valid.
EINVAL	Indicates the parameter is not valid.
EIO	Indicates a general error. If an extension was provided in the call, additional data identifying the cause of the error can be found in the status field.
ENODEV	Indicates the specified minor number is not valid.

Implementation Specifics

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

Related Information

The sol_ioctl entry point, sol_open entry point.