Ends a session with the Ethernet device handler.
The CIO_HALT operation ends a session with the Ethernet device handler. The caller indicates the network ID to halt. This CIO_HALT operation corresponds with the CIO_START operation successfully issued with the specified network ID.
Data for the specified network ID is no longer received. Data already received for the specified network ID, before the CIO_HALT operation, is still passed up to a user-mode caller by the entselect and entread entry points. The rx_fn routine specified at open time passes data to a kernel-mode caller.
When a CIO_HALT operation has ended the last open session on a channel, the caller should then issue the entclose operation.
Note: If the caller has specified a multicast address, the caller first needs to issue the appropriate entioctl entry point to remove all the multicast addresses before issuing a CIO_HALT operation.
For a CIO_HALT operation, the arg parameter points to a session_blk structure. This structure is defined in the /usr/include/sys/comio.h file and contains the following fields:
A CIO_HALT operation can be called from the process environment only.
The return codes for the CIO_HALT operation are:
The CIO_HALT operation functions with an Ethernet High-Performance LAN adapter that has been correctly configured for use on a qualified network. Consult the network adapter specifications for more information on configuring the network adapter and network qualifications.
The CIO_START entioctl Ethernet Device Handler Operation.
The entioctl entry point, entread entry point, entselect entry point.
Common Communications Status and Exception Codes in AIX Kernel Extensions and Device Support Programming Concepts.