[ Previous |
Next |
Contents |
Home |
Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2
CCC_GET_VPD (Query Vital Product Data) entioctl Ethernet Device
Handler Operation
Purpose
Returns vital product data (VPD) about the Ethernet
adapter.
Description
The CCC_GET_VPD operation returns VPD about the
Ethernet adapter. For this operation, the arg parameter points to the
vital_product_data structure. This structure is defined in the
/usr/include/sys/ciouser.h file and has the following fields:
| status |
Indicates the status of the VPD characters returned in the array of characters.
Valid values for this status word are found in the /usr/include/sys/ciouser.h file:
| VPD_NOT_READ |
VPD data has not been obtained from the adapter. |
| VPD_NOT_AVAIL |
VPD data is not available for this adapter. |
| VPD_INVALID |
VPD data that was obtained is not valid. |
| VPD_VALID |
VPD data was obtained and is valid. |
|
| length |
Specifies the number of bytes that are valid in the VPD character array. This
value can be 0, depending on the status returned. |
| vpd[
n
] |
An array of characters that contain the adapter's VPD. The number of valid
characters is determined by the length value. |
A CCC_GET_VPD operation can be called from the
process environment only.
Return Values
The return codes for the CCC_GET_VPD operation
are:
| EFAULT |
Indicates a specified address is not valid. |
| ENXIO |
Indicates no such device exists. |
Implementation Specifics
The CCC_GET_VPD 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.
The Vital Product Data
Structure (VPD) for the Ethernet Device Handler in AIX Kernel Extensions and Device Support Programming Concepts.
[ Previous |
Next |
Contents |
Home |
Search ]