[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Kernel and Subsystems, Volume 2

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

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

Related Information

The tokioctl entry point.

Common Communications Status and Exception Codes in AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]