Allows the caller to read the counter values accumulated by a token-ring device handler.
The CIO_QUERY tokioctl operation is used by the caller to read the counter values accumulated by a token-ring device handler. The first call to the tokopen 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:
The counters placed in the supplied buffer by the CIO_QUERY operation are the counters declared in the tok_query_stats_t structure defined in the /usr/include/sys/tokuser.h file.
The CIO_QUERY operation can be called from the process environment only.
EFAULT | Indicates that the specified address is not valid. |
EINVAL | Indicates that a parameter is not valid. |
The CIO_QUERY operation functions with a Token-Ring High Performance Network Adapter that has been correctly configured for use on a qualified network. Consult adapter specifications for more information on configuring the adapter and network qualifications.
The ddioctl (CIO_QUERY) entry point.
The tokioctl entry point, tokopen entry point.
Common Communications Status and Exception Codes in AIX Kernel Extensions and Device Support Programming Concepts.