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:
|status||Returns one of the following status values:|
|netid||Specifies the network ID. The network ID is placed in the least significant byte of the netid field. When terminating the medium-access control (MAC) frame session, the netid field should be set to TOK_MAC_FRAME_NETID.|
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.