IOCINFO (Describe Device) sol_ioctl Serial Optical Link Device Handler Operation

Purpose

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

Returns a structure that describes the Serial Optical Link (SOL) device.

Description

The IOCINFO operation returns a structure that describes the SOL device. For this operation, the arg parameter points to the devinfo structure. This structure is defined in the /usr/include/sys/devinfo.h file and contains the following fields:

Field Description
devtype Identifies the device type. The SOL device type is DD_NET_DH. This value is defined in the /usr/include/sys/devinfo.h file.
devsubtype Identifies the device subtype. The SOL device subtype is DD_SOL. This value is defined in the /usr/include/sys/devinfo.h file.
broad_wrap Specifies whether the wrapping of broadcast packets is supported by the device.
rdto Specifies the configured receive data transfer offset (RDTO) value.
processor_id Identifies the processor ID used by other systems to address this system. This is a customized attribute in the configuration database.

The parameter block is filled in with the appropriate values upon return.

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

Execution Environment

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

Return Values

Item Description
EFAULT Indicates the specified address is not valid.
EINVAL Indicates the parameter is not valid.
ENODEV Indicates the specified minor number is not valid.