[ Previous |
Next |
Contents |
Home |
Search ]
AIX Version 4.3 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.
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.
[ Previous |
Next |
Contents |
Home |
Search ]