[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2

sol_select Serial Optical Link Device Handler Entry Point

Purpose

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

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.

Execution Environment

The sol_select entry point can be called from the process environment only.

Return Values

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

Implementation Specifics

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.

Related Information

Serial Optical Link Device Handler Entry Points.

The sol_mpx entry point.

The poll subroutine, select subroutine.


[ Previous | Next | Contents | Home | Search ]