Technical Reference: Kernel and Subsystems, Volume 2

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

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

Related Information

The sol_ioctl entry point.