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

Purpose

Note: This function is supported in AIX® 5.1 and earlier only.

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:

Field Description
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.

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.

Execution Environment

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

Return Values

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