Fibre Channel SNIA HBA API Programmer's Guide

Output Parameters: None.
Return Values Returned after a successful
execution of the call. A log is
HBA_STATUS_OK
made in a log file
(/opt/snia/snia.log) for
every invalid hba.conf entry
encountered. When none of the
entries in hba.conf are valid,
HBA_STATUS_ERROR is
returned.
HBA_STATUS_ERROR
Returned when an internal
library or system error is
detected.
HBA_STATUS_ERROR_BUSY
Returned when the library is
busy and cannot currently
process this call.
Call order sequence: See Appendix A.
NOTE: HBA_LoadLibrary() will fail if any call to SNIA functions are concurrently in progress
in the same process.
Example code:
HBA_STATUS status;
status = HBA_LoadLibrary();
if (status = HBA_STATUS_OK)
{
printf("Successfully loaded HBA library.\n");
}
HBA_FreeLibrary
NOTE: HBA_FreeLibrary() will fail if any call to SNIA functions are concurrently in progress
in the same process.
Function:
HBA_STATUS HBA_FreeLibrary();
Purpose: Frees all resources allocated for internal use during
HBA_LoadLibrary() call.
Input Parameters: None.
Output Parameters: None.
Return Values: Returned after a successful
execution of the call.
HBA_STATUS_OK
HBA_STATUS_ERROR
Returned when an internal
library or system error is
detected and when any of the
vendor libraries cannot be
freed successfully.
HBA_STATUS_ERROR_BUSY
Returned when the library is
busy and cannot currently
process this call.
Call order sequence: See Appendix A.
Example code:
12 HBA Common Library APIs