[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Kernel and Subsystems Technical Reference, Volume 2

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

Purpose

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:

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.

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.

Implementation Specifics

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.

Related Information

The tokioctl entry point.

Common Communications Status and Exception Codes in AIX Kernel Extensions and Device Support Programming Concepts.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]