Ends a session with the token-ring device handler.
The CIO_HALT tokioctl operation ends a session with the token-ring device handler. The caller indicates the network ID to halt. This CIO_HALT operation corresponds to the CIO_START operation successfully issued with the specified network ID. A CIO_HALT operation should be issued for each CIO_START operation.
Data for the specified network ID is no longer received. Data received for the specified network ID, before the halt, is still passed up to a user-mode caller by tokselect and tokread entry points. Data is passed back to a kernel-mode caller by the rx_fn routine specified at open time.
For the CIO_HALT operation, the arg parameter points to the session_blk structure. This structure is defined in the /usr/include/sys/comio.h file and contains the following fields:
The CIO_HALT operation can be called from the process environment only.
EFAULT | Indicates the specified address is not valid. |
EINVAL | Indicates a parameter is not valid. |
ENOMSG | Indicates an error occurred. |
The CIO_HALT 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.
The ddioctl (CIO_HALT) operation.
The CIO_GET_STAT tokioctl Token-Ring Device Handler Operation, CIO_START tokioctl Token-Ring Device Handler Operation.
The tokselect entry point, tokread entry point, tokioctl entry point.
Common Communications Status and Exception Codes in AIX Kernel Extensions and Device Support Programming Concepts.