tokioctl Token-Ring Device Handler Entry Point

Purpose

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

Provides various functions for controlling the token-ring device handler.

Syntax

#include <sys/device.h>
#include <sys/devinfo.h>
#include <sys/ioctl.h>
#include <sys/comio.h>
#include <sys/tokuser.h>
int tokioctl 
(devno, cmd, arg, devflag, chan, ext)
dev_t devno;
int cmd, arg;
ulong devflag;
int chan, ext;

Parameters

Item Description
devno Specifies major and minor device numbers.
cmd Specifies the operation to be performed. The possible tokioctl operation codes can be found in the /usr/include/sys/ioctl.h, /usr/include/sys/comio.h, and /usr/include/sys/tokuser.h files.
arg Specifies the address of the tokioctl parameter block.
devflag Indicates the conditions under which the device was opened.
chan Specifies the channel number assigned by the tokmpx entry point.
ext This parameter is not used by the token-ring device handler.

Description

The tokioctl entry point provides various functions for controlling the token-ring device handler. The possible tokioctl operations are:

Operation Description
CIO_GET_FASTWRT Gets function address for the tokfastwrt operation.
CIO_GET_STAT Gets device status.
CIO_HALT Halts the device.
CIO_QUERY Queries device statistics.
CIO_START Starts the device.
IOCINFO I/O character information.
TOK_FUNC_ADDR Sets functional addresses.
TOK_GRP_ADDR Sets the group address.
TOK_QVPD Queries vital product data (VPD).
TOK_RING_INFO Queries token-ring information.

The tokioctl entry point 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.

Execution Environment

The tokioctl entry point can be called from the process environment only.