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

Kernel and Subsystems Technical Reference, Volume 2

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

Purpose

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:

`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.

Execution Environment

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

Return Values

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.

Implementation Specifics

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.

Related Information

The sol_ioctl entry point.