[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Kernel and Subsystems, Volume 2
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
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. |
Related Information
The sol_ioctl entry point.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]