Note: This function is supported in AIX 5.1 and earlier only.
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 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 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. |
Token-Ring Operation Results in AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.
Common Communications Status and Exception Codes in AIX 5L Version 5.2 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.