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.