tokopen Token-Ring Device Handler Entry Point

Purpose

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

Initializes a token-ring device handler and allocates the required system resources.

Syntax

#include <sys/device.h> #include <sys/comio.h> #include <sys/tokuser.h> int tokopen (devno, devflag, chan, arg) dev_t devno; ulong devflag; int chan; struct kopen_ext * arg;

Parameters

Item Description
devno Specifies major and minor device numbers.
devflag Specifies the flag word with the following definitions:
DKERNEL
Indicates kernel-mode processes. For user-mode processes, this flag must be clear.
DNDELAY
Specifies that the device handler performs nonblocking reads and writes for this channel. Otherwise, blocking reads and writes are performed for this channel.
chan Specifies the channel number assigned by the tokmpx entry point.
arg Points to a kopen_ext structure for kernel-mode processes. For user-mode processes, this field is not used.

Description

The tokopen entry point is called when a user-mode caller issues an open, openx, or creat subroutine. The tokopen routine can also be invoked in response to an fp_opendev kernel service. The device is opened to read and write data.

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

Note: After the tokopen operation has successfully completed, the caller must then issue a CIO_START operation before any data can be transmitted or received from a token-ring device handler.

Execution Environment

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

Return Values

Item Description
ENXIO Indicates the specified minor number is not valid.
EINVAL Indicates a specified parameter is not valid.
ENOMEM Indicates the device handler was unable to allocate the required memory.