Initializes the Ethernet device handler and allocates the required system resources.
#include <sys/device.h> #include <sys/comio.h> #include <sys/entuser.h>
int entopen (devno, devflag, chan, ext) dev_t devno; ulong devflag; int chan, ext;
|devno||Specifies major and minor device numbers for both kernel- and user-mode entry pointers.|
|devflag||Specifies the DKERNEL flag, which must be set for a kernel-mode entry pointer. This flag cannot be set for user-mode entry pointers.|
|chan||Specifies the channel number assigned by the entmpx routine for both kernel- and user-mode entry pointers.|
|ext||Points to a kopen_ext structure. This structure is defined in the /usr/include/sys/comio.h file. This parameter is valid only for kernel-mode users; it is null for user-mode users.|
The entopen entry point prepares the Ethernet device for transmitting and receiving data. It is called when a user-mode entry pointer issues an open, openx, or creat subroutine. After the entopen entry point has successfully completed, the entry pointer must issue a CIO_START operation before using the Ethernet device handler. The device handler is then opened for reading and writing data.
An entopen entry point can be called from the process environment only.
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 entopen entry point are the following:
|EINVAL||Indicates a range or op code that is not valid, or that the device is not in diagnostic mode.|
|ENOMEM||Indicates insufficient memory.|
|ENOTREADY||Indicates that the device was not ready. The first CIO_START operation was not issued and hence not completed.|
|ENXIO||Indicates that no such device exists. (The maximum number of adapters was exceeded.)|
The entopen 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.
The entclose entry point, entmpx entry point.
The open, openx, or create subroutine.
The CIO_START entioctl Ethernet Device Handler Operation.