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).
#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;
| 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. |
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.
The sol_config entry point can be called from the process environment only.
| 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. |
| Item | Description |
|---|---|
| EBUSY | Indicates there are outstanding opens; not able to terminate. |
| ENODEV | Indicates there was no device to terminate. |
| Item | Description |
|---|---|
| ENODEV | Indicates that there was no device to query the VPD. |
| EFAULT | Indicates that the specified address is not valid. |