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

CIO_GET_FASTWRT (Get Fast Write) tokioctl Token-Ring Device Handler Operation

Purpose

Provides the attributes of the tokfastwrt entry point.

Description

The CIO_GET_FASTWRT tokioctl operation is used to get the parameters required to issue the tokfastwrt entry point, which is the kernel-mode fast write command for the token-ring device handler. For the CIO_GET_FASTWRT operation, the arg parameter points to the cio_get_fastwrt structure. This structure is defined in the /usr/include/sys/comio.h file and contains the following fields:

status Returns one of the following status values:
  • CIO_INV_CMD
  • CIO_OK
fastwrt_fn Specifies the address of the tokfastwrt entry point.
chan Specifies the channel ID.
devno Specifies the major and minor device numbers.

Execution Environment

The CIO_GET_FASTWRT tokioctl operation can be called from the kernel-mode process environment only.

Return Values

EFAULT Indicates that the specified address is not valid, or the calling process is a user-mode process.
EINVAL Indicates that the specified parameter is not valid.
EIO Indicates that an error occurred. See the status field for more information.
ENODEV Indicates that the specified minor number is not valid.
ENXIO Indicates that an attempt was made to use an unconfigured device.

Implementation Specifics

The CIO_GET_FASTWRT tokioctl operation functions with a Token-Ring High Performance Network Adapter that has been correctly configured for use on a qualified network. Consult the adapter specifications for more information on configuring the adapter and network qualifications.

Related Information

The tokfastwrt entry point, tokioctl entry point, tokwrite entry point.


[ Previous | Next | Contents | Home | Search ]