Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

HBA_LoadLibrary(3) OSS Library Calls Reference Manual
NAME
HBA_LoadLibrary - Loads the HBA libraries that have valid entries in the configuration file
LIBRARY
H-series OSS processes: /usr/lib/libcmnapi.a
SYNOPSIS
#include <snia_common.h>
HBA_STATUS HBA_LoadLibrary (
void
);
PARAMETERS
None.
DESCRIPTION
This function loads the Host Bus Adapter (HBA) vendor libraries that have a valid entry in the
hba.conf configuration file. This function must be called before you can call any other HBA
library function.
The the hba.conf configuration file specifies the location of a vendor-specific library for HBA.
Each library in this file is specified on a single line containing the library name, one or more tab
characters, and the library location. Lines beginning with a # (pound sign) are considered com-
ments. The file etc/hba.conf contains an example template file.
Calling Order
This function must be called before you can call any other HBA library function.
You must call the HBA_FreeLibrary() function between calls to the HBA_LoadLibrary( )
function.
EXAMPLES
HBA_STATUS status;
status = HBA_LoadLibrary();
if (status == HBA_STATUS_OK) {
printf("Successfully loaded HBA library.");
}
RETURN VALUES
The HBA_LoadLibrary( ) function returns these values:
HBA_STATUS_OK
The call to this function was successful.
HBA_STATUS_ERROR
An internal library or system error was detected or the vendor library could not
be loaded successfully.
HBA_STATUS_ERROR_ARG
The pointer passed to this function is NULL.
HBA_STATUS_ERROR_BUSY
The library is busy processing a call that cannot be executed concurrently with
other calls and that might be modifying internal data structures.
3−186 Hewlett-Packard Company 527187-017