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

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.

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:

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.