TOK_QVPD (Query Vital Product Data) tokioctl Token-Ring Device Handler Operation

Purpose

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

Returns the vital product data (VPD) for the token-ring adapter.

Description

The TOK_QVPD tokioctl operation returns VPD about the token-ring device. For this operation, the arg parameter points to the tok_vpd_t block to query the VPD. This structure is defined in the /usr/include/sys/tokuser.h file and contains the following fields:

Field	Description
`status`	Returns one of the following status values: TOK_VPD_INVALID TOK_VPD_NOT_READ TOK_VPD_VALID
`l_vpd`	Specifies the length of the vpd parameter.
`vpd[TOK_VPD_LENGTH]`	Contains the VPD upon return.

The TOK_QVPD operation functions with a Token-Ring High Performance Network Adapter that has been correctly configured for use on a qualified network. Consult adapter specifications for more information on configuring the adapter and network qualifications.

Execution Environment

The TOK_QVPD tokioctl operation can be called from the process environment only.

Return Values

Item	Description
EFAULT	Indicates the specified address is not valid.
EINVAL	Indicates a parameter is not valid.
ENXIO	Indicates the specified minor number is not valid.