[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2

TOK_RING_INFO (Query Token-Ring) tokioctl Token-Ring Device Handler Operation

Purpose

Reads information about a token-ring device.

Description

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.

Execution Environment

The TOK_RING_INFO operation can be called from the process environment only.

Return Values

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.

Implementation Specifics

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.

Related Information

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.


[ Previous | Next | Contents | Home | Search ]