[ Previous |
Next |
Contents |
Home |
Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2
IOCINFO (Describe Device) entioctl Ethernet Device Handler Operation
Purpose
Returns a structure that describes the Ethernet device.
Description
The IOCINFO operation returns a structure that describes the Ethernet device. For this operation, the arg parameter points to the ethernet substructure, which is defined as part of the devinfo structure. This devinfo structure is located in the /usr/include/sys/devinfo.h file and contains the following fields:
devtype |
Identifies the device type. The Ethernet type is DD_NET_DH. This label is defined in the /usr/include/sys/devinfo.h file. |
devsubtype |
Identifies the device subtype. The Ethernet subtype is DD_EN. This label can be found in the /usr/include/sys/devinfo.h file. |
broad_wrap |
Indicates the adapter's ability to receive its own packets. A value of 1 indicates that the adapter can receive its own packets. A value of 0 indicates that the adapter cannot receive its own packets. For this adapter, a value of 0 is returned. |
rdto |
Specifies the receive data transfer offset. This value indicates an offset (in bytes) into the data area of the receive page-sized mbuf structure. The device handler places received data in this buffer. |
haddr |
Identifies the 6-byte unique Ethernet adapter address. This address is the burned-in address that is readable from the adapter's vital product data (VPD). The most significant byte of the address is placed in the haddr(0)
field. The least significant byte is placed in the address specified by the haddr(5)
field. |
net_addr |
Identifies the 6-byte unique Ethernet adapter address currently being used by the Ethernet adapter card. This address is either the burned-in address (readable from the VPD) or the alternate address that can be used to configure the adapter. The most significant byte of the address is placed in the address specified by the net_addr(0)
field. The least significant byte is placed in the address specified by net_addr(5)
field. |
The parameter block is filled in with the appropriate values upon return.
An IOCINFO operation can be called from the process environment only.
Return Values
The return codes for the IOCINFO operation are:
EFAULT |
Indicates a specified address is not valid. |
EINVAL |
Indicates an operation code is not valid. |
ENXIO |
Indicates no such device exists. |
Implementation Specifics
The IOCINFO operation 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 entioctl entry point.
[ Previous |
Next |
Contents |
Home |
Search ]