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:
| Item | Description |
|---|---|
| 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.
| Item | Description |
|---|---|
| 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. |