Opens the specified adapter for reading.
Common Host Bus Adapter Library (libHBAAPI.a)
#include <hbaapi.h> HBA_HANDLE HBA_OpenAdapter (adaptername) char *adaptername;
The HBA_OpenAdapter subroutine opens the adapter for reading for the purpose of getting it ready for additional calls from other subroutines in the Common HBA API.
The HBA_OpenAdapter subroutine allows an application to open a specified HBA device, giving the application access to the device through the HBA_HANDLE return value. The library ensures that all access to this HBA_HANDLE between HBA_OpenAdapter and HBA_CloseAdapter calls is to the same device.
| adaptername | Specifies a string that contains the description of the adapter as returned by the HBA_GetAdapterName subroutine. |
If successful, the HBA_OpenAdapter subroutine returns an HBA_HANDLE with a value greater than 0. If unsuccessful, the subroutine returns a 0.
HBA_CloseAdapter Subroutine, and HBA_GetAdapterName Subroutine.
Special Files in AIX 5L Version 5.2 Files Reference describes specific qualities of the files that define devices.