[ Previous |
Next |
Contents |
Home |
Search ]
AIX Version 4.3 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. |
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.
[ Previous |
Next |
Contents |
Home |
Search ]