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

TOK_GRP_ADDR (Set Group Address) tokioctl Token-Ring Device Handler Operation

Purpose

Sets the active group address for a token-ring adapter.

Description

The TOK_GRP_ADDR tokioctl operation sets the active group address for a token-ring adapter. Only one group address can be specified at a time for a token-ring adapter. For this operation, the arg parameter points to the tok_group_addr_t structure. This structure is defined in the /usr/include/sys/tokuser.h file and contains the following fields:

status Returns one of the following possible status values:
opcode When set to TOK_ADD, the group address specified is added to the possible address for which the token-ring device accepts packets. When set to TOK_DEL, the group address is removed from the possible receive packet addresses. The TOK_ADD and TOK_DEL values are defined in the /usr/include/sys/tokuser.h file.
group_addr Specifies the 4 least significant bytes of the 6-byte network group address. The 2 most significant bytes are automatically set to 0xC000 by the token-ring adapter. The most significant bit within these 4 bytes cannot be set. They are ignored by the token-ring adapter.

Execution Environment

The TOK_GRP_ADDR tokioctl operation can be called from the process environment only.

Return Values

EFAULT Indicates the specified address is not valid.
EINVAL Indicates a parameter is not valid.
ENETDOWN Indicates an unrecoverable hardware error.
ENOCONNECT Indicates the device has not been started.
ENOMSG Indicates an error occurred.

Implementation Specifics

The TOK_GRP_ADDR 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.

The CIO_GET_STAT tokioctl Token-Ring Device Handler Operation for more information about Token-Ring status blocks.

The tokioctl entry point.

Common Communications Status and Exception Codes in AIX Kernel Extensions and Device Support Programming Concepts.


[ Previous | Next | Contents | Home | Search ]