Technical Reference: Kernel and Subsystems, Volume 2

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.

Related Information

The entioctl entry point.

The Vital Product Data Structure (VPD) for the Ethernet Device Handler in AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.