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

sol_config Serial Optical Link Device Handler Entry Point

Purpose

Provides functions to initialize and terminate the device handler and to query the vital product data (VPD).

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

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:

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.

Execution Environment

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

Return Values for the CFG_INIT Operation

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

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

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

Implementation Specifics

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.

Related Information

The uio structure in BkSym.TRKernel5;.


[ Previous | Next | Contents | Home | Search ]