CIO_START (Start Device) sol_ioctl Serial Optical Link Device Handler Operation

Kernel and Subsystems Technical Reference, Volume 2

CIO_START (Start Device) sol_ioctl Serial Optical Link Device Handler Operation

Purpose

Initiates a session with the Serial Optical Link (SOL) device handler.

Description

The CIO_START operation initiates a session with the SOL device handler. If the start is the first on the device, the device handler initializes and opens the SOL. For each successful CIO_START call issued, there should be a corresponding CIO_HALT operation issued.

After the CIO_START operation has successfully completed, the device is ready to transmit and receive data. The caller is free to issue any valid SOL operation. Once started, the adapter receives packets from any of the available optical ports.

The caller notifies the device handler of the network ID to use. The network ID corresponds to the destination service access point (DSAP) in the packet. The caller can issue multiple CIO_START operations. The SOL device handler can handle from 0 to the number of network IDs specified by the SOL_MAX_NETIDS label. This label is defined in the /usr/include/sys/soluser.h file.

For the CIO_START operation, the arg parameter points to the session_blk structure. This structure is defined in the /usr/include/sys/comio.h file and contains the following fields:

`status`	Indicates the status of the CIO_START. Possible returned status values are: CIO_OK CIO_NETID_FULL CIO_NETID_DUP CIO_NETID_INV
`netid`	Specifies the network ID the caller uses on the network. The Network ID is placed in the least significant byte of the `netid` field. Note: Only even number IDs are valid. Odd number IDs are reserved for group IDs not supported for this device and return a status value of CIO_NETID_INV.

Execution Environment

The CIO_START operation can be called from the process environment only.

Return Values

EADDRINUSE	Indicates the network ID is in use.
EFAULT	Indicates the supplied address is not valid.
EINVAL	Indicates the parameter is not valid.
EIO	Indicates a general error. If an extension was provided in the call, additional data identifying the cause of the error can be found in the `status` field.
ENETDOWN	Indicates a hardware error for which there is no recovery.
ENODEV	Indicates the specified minor number is not valid.
ENOSPC	Indicates the network ID table is full.

Implementation Specifics

The CIO_START 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.

Related Information

The sol_ioctl entry point.

The CIO_HALT sol_ioctl Serial Optical Link Device Handler Operation.