sol_select Serial Optical Link Device Handler Entry Point

Purpose

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

Determines whether a specified event has occurred on the Serial Optical Link (SOL) device.

Syntax

#include  <sys/device.h>
#include  <sys/comio.h>
#include  <sys/soluser.h>

int sol_select ( devno,  events,  reventp,  chan)
dev_t devno;
ushort events;
ushort *reventp;
int chan;

Parameters

Item Description
devno Specifies major and minor device numbers.
events Specifies conditions to check, which are denoted by the bitwise OR of one or more of the following:
POLLIN
Check whether receive data is available.
POLLOUT
Check whether transmit available.
POLLPRI
Check whether status is available.
POLLSYNC
Specifies synchronous notification only. The request is not registered for notification on occurrence.
reventp Points to the result of condition checks. A bitwise OR of one of the following conditions is returned:
POLLIN
Receive data is available.
POLLOUT
Transmit available.
POLLPRI
Status is available.
chan Specifies the channel number assigned by the sol_mpx entry point.

Description

Note: Only user-mode callers should call this entry point.

The sol_select entry point is called when the select or poll subroutine is used to determine if a specified event has occurred on the SOL device. When the SOL device handler is in a state in which the event can never be satisfied (such as a hardware failure), the sol_select entry point sets the returned events flags to 1 (one) for the event that cannot be satisfied. This prevents the select or poll subroutines from waiting indefinitely.

The sol_select entry point 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_select entry point can be called from the process environment only.

Return Values

Item Description
ENODEV Indicates the specified minor number is not valid.
EACCES Indicates the call from a kernel process is not valid.