[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2

entclose Ethernet Device Handler Entry Point


Resets the Ethernet device to a known state and returns system resources to the system.


#include <sys/device.h>
int entclose (devno, chan, ext)
dev_t devno;
int chan, ext;


devno Identifies major and minor device numbers.
chan Specifies the channel number assigned by the entmpx entry point.
ext Ignored by the Ethernet device handler.


The entclose entry point closes the device. It is called when a user-mode caller issues a close subroutine. Before issuing the entclose entry point, the caller should have issued a CIO_HALT operation for each successfully issued CIO_START operation during the particular instance of the open.

Note: For each entopen entry point issued, there must be a corresponding entclose entry point.

If the caller has specified a multicast address, the caller first needs to issue the appropriate entioctl operation to remove all multicast addresses before issuing the entclose entry point.

Execution Environment

An entclose entry point can be called from the process environment only.

Return Values

In general, communication device handlers use the common return codes defined for an entry point. However, device handlers for specific communication devices may return device-specific codes. The common return codes for the entclose entry point are the following:

ENXIO Indicates that the device is not configured.
EBUSY Indicates that the maximum number of opens was exceeded.
ENODEV Indicates that the specified device does not exist.

Implementation Specifics

The entclose entry point functions with an Ethernet High-Performance LAN adapter that has been correctly configured for use on a qualified network. Consult the adapter specifications for more information on configuring the network adapter and network qualifications.

Related Information

The CIO_START entioctl Communications PDH Operation.

The close subroutine.

The entmpx entry point, entopen entry point.

[ Previous | Next | Contents | Home | Search ]