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

HBA_FreeLibrary(3) OSS Library Calls Reference Manual
NAME
HBA_FreeLibrary - Frees HBA libraries loaded during a call to HBA_LoadLibrary()
LIBRARY
H-series OSS processes: /usr/lib/libcmnapi.a
SYNOPSIS
#include <snia_common.h>
HBA_STATUS HBA_FreeLibrary (
void
);
PARAMETERS
None.
DESCRIPTION
This function frees the Host Bus Adapter (HBA) vendor libraries that were loaded during a call
to HBA_LoadLibrary( ). The HBA_LoadLibrary( ) is the only function in the library that you
can call after you call HBA_FreeLibrary().
Calling Order
All open adapters must be fully closed before you can call the HBA_FreeLibrary( ) function.
An adapter is deemed fully closed only after the HBA_CloseAdapter( ) has been called for
every successful HBA_OpenAdapter( ) function call.
Before you can use the HBA_FreeLibrary( ) function, you must call the corresponding
HBA_LoadLibrary( ) function.
You must call the HBA_FreeLibrary() function between calls to the HBA_LoadLibrary( )
function.
EXAMPLES
HBA_STATUS status;
status = HBA_FreeLibrary();
if (status == HBA_STATUS_OK) {
printf("Successfully freed HBA library.");
}
RETURN VALUES
The HBA_FreeLibrary( ) 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 freed.
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−170 Hewlett-Packard Company 527187-017