Reads information about a token-ring device.
The TOK_RING_INFO tokioctl operation reads information about the token-ring device. For this operation, the arg parameter points to the tok_q_ring_info_t structure. This structure is defined in the /usr/include/sys/tokuser.h file and contains the following fields:
| status | Indicates the status condition that occurred. Possible values are:
|
| p_info | Points to the buffer where the tok_ring_info_t structure is to be copied. The tok_ring_info_t structure is defined in the /usr/include/sys/tokuser.h file. |
| l_buf | Specifies the length of the buffer for the returned ring information structure. |
The TOK_RING_INFO operation can be called from the process environment only.
| EFAULT | Indicates a specified address is not valid. |
| EINVAL | Indicates a parameter is not valid. |
| ENOCONNECT | Indicates the device has not been started. |
| ENOMSG | Indicates an error occurred. |
The TOK_RING_INFO 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.
Token-Ring Operation Results in AIX Kernel Extensions and Device Support Programming Concepts.
Common Communications Status and Exception Codes in AIX Kernel Extensions and Device Support Programming Concepts.
The CIO_GET_STAT tokioctl Token-Ring Device Handler Operation for more information about Token-Ring status blocks.
The tokioctl entry point.