sol_config Serial Optical Link Device Handler Entry Point

Purpose

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

Provides functions to initialize and terminate the device handler and to query the Software Vital Product Data (SWVPD).

Syntax

#include <sys/device.h> #include <sys/uio.h> #include <sys/comio.h> #include <sys/soluser.h> int sol_config ( devno, cmd, uiop) dev_t devno; int cmd; struct uio *uiop;

Parameters

Item Description
devno Specifies major and minor device numbers.
cmd Identifies the function to be performed by the sol_config routine.
uiop Points to a uio structure that describes the relevant data area for reading or writing.

Description

The sol_config entry point is invoked at device configuration time and provides the following operations:

Operation Description
CFG_INIT Initializes the Serial Optical Link (SOL) device handler. The device handler registers entry points in the device switch table. The uio structure describes the SOL device-dependent structure (DDS) address and length. The device handler copies the DDS into an internal save area.
CFG_TERM Terminates the SOL device handler. If there are no outstanding opens, the device handler marks itself terminated and prevents subsequent opens. All dynamically allocated areas are freed. All SOL device handler entry points are removed from the device switch table.
CFG_QVPD Returns the SOL VPD to the caller. The VPD is placed in the area specified by the caller in the uio structure.

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

Return Values for the CFG_INIT Operation

Item Description
ENOMEM Indicates the routine was not able to allocate the internal space needed.
EBUSY Indicates the device was already initialized.
EFAULT Indicates the specified address is not valid.

Return Values for the CFG_TERM Operation

Item Description
EBUSY Indicates there are outstanding opens; not able to terminate.
ENODEV Indicates there was no device to terminate.

Return Values for the CFG_QVPD Operation

Item Description
ENODEV Indicates that there was no device to query the VPD.
EFAULT Indicates that the specified address is not valid.