Note: This function is supported in AIX® 5.1 and earlier only.
Returns all processor IDs connected to the Serial Optical Link (SOL) subsystem.
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.
The SOL_GET_PRIDS operation can be called from the process environment only.
| 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. |