SOL_GET_PRIDS (Get Processor IDs) sol_ioctl Serial Optical Link Device Handler Operation

Purpose

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

Returns all processor IDs connected to the Serial Optical Link (SOL) subsystem.

Description

The SOL_GET_PRIDS operation returns all processor IDs connected to the SOL subsystem. For this operation, the arg parameter points to the sol_get_prids structure. This structure is defined in the /usr/include/sys/soluser.h file and includes the following fields:

Field Description
bufptr A pointer to the caller buffer where the list of processor IDs are written. Each processor ID is one byte.
buflen The length of the caller's buffer, in bytes. This is the number of processor IDs the buffer can hold.
num_ids The number of IDs detected. This value is filled in by the SOL device handler. A value greater than the buflen value indicates an overflow condition in which there are more processors connected than can be reported in the supplied buffer. If this value is 0, and an error is not returned, no other processor IDs were detected.

The SOL_GET_PRIDS operation functions with a Serial Link Adapter and Serial Optical Channel Converter that have been correctly configured for use on a qualified network. Consult hardware specifications for more information on configuring hardware and network qualifications.

Execution Environment

The SOL_GET_PRIDS operation can be called from the process environment only.

Return Values

Item Description
EFAULT Indicates that the specified address is not valid.
EINVAL Indicates that the parameter is not valid.
EIO Indicates a general error. If an extension was provided in the call, the status field will contain additional data identifying the cause of the error.
ENODEV Indicates that the minor number specified is not valid.
ENOMEM Indicates an attempt to get memory failed.