entioctl Ethernet Device Handler Entry Point

Purpose

Note: This function is supported in AIX® 5.1 and earlier only.

Provides various functions for controlling the Ethernet device.

Syntax

#include <sys/device.h>
#include <sys/devinfo.h>
#include <sys/ioctl.h>
#include <sys/comio.h>
#include <sys/entuser.h>

int entioctl (devno, cmd, arg, devflag, chan, ext)
dev_t  devno;
int  cmd,  arg;
ulong  devflag;
int  chan,  ext;

Parameters

Item Description
devno Specifies major and minor device numbers.
cmd Specifies which operation to perform. The possible entioctl operation codes can be found in the /usr/include/sys/ioctl.h and /usr/include/sys/comio.h files.
arg Specifies the address of the entioctl parameter block.
devflag Specifies a parameter ignored by the Ethernet device handler.
chan Specifies the channel number assigned by the entmpx routine.
ext Specifies a parameter not used by the Ethernet device handler.

Description

The entioctl Ethernet device-handler entry point provides various functions for controlling the Ethernet device. Common entioctl operations are supplemented by entioctl operations available for diagnostic purposes.

The entioctl 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.

These are the common valid entioctl operations:

Operation Description
CCC_GET_VPD Returns vital product data (VPD) about the adapter.
CIO_GET_FASTWRT Provides the parameters required to issue a fast write.
CIO_GET_STAT Returns the current adapter and device handler status.
CIO_HALT Halts a session and removes the registered network ID.
CIO_QUERY Returns the current random access storage (RAS) counter values.
CIO_START Starts a session and registers a network ID.
ENT_SET_MULTI Sets or resets a multicast address.
IOCINFO Returns I/O character information.

The following entioctl operations are for diagnostic purposes:

Operation Description
CCC_TRCTBL Returns the address of the internal device driver trace table.
CIO_MEM_ACC Reads or writes data from or to selected adapter RAM addresses.
CIO_POS_ACC Reads or writes a byte from or to a selected adapter POS register
CIO_REG_ACC Reads or writes a byte from or to a selected adapter I/O register.

The following are DMA facilities operations:

Operation Description
ENT_LOCK_DMA Sets up (locks) a user buffer to DMA from or to the adapter.
ENT_UNLOCK_DMA Clears (unlocks) a user buffer from DMA control.

Execution Environment

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