CCC_GET_VPD (Query Vital Product Data) entioctl Ethernet Device Handler Operation

Purpose

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

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:

Field	Description
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.

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.

Execution Environment

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:

Return Code	Description
EFAULT	Indicates a specified address is not valid.
ENXIO	Indicates no such device exists.