HBA_LoadLibrary(3HBAAPI) Common Fibre Channel HBA Information Library Functions HBA_LoadLibrary(3HBAAPI)
NAME
HBA_LoadLibrary, HBA_FreeLibrary - load and free the resources used by the HBA Common Library
SYNOPSIS
cc [ flag... ] file... -lHBAAPI [ library... ]
#include <hbaapi.h>
HBA_STATUS HBA_LoadLibrary(void);
HBA_STATUS HBA_FreeLibrary(void);
DESCRIPTION
The HBA_LoadLibrary() function loads the Common Library, which in turn loads each VSL specified in the hba.conf(4) file.
The HBA_FreeLibrary() function releases resources held by the Common Library and each loaded VSL.
RETURN VALUES
Upon successful completion, HBA_LoadLibrary() and HBA_FreeLibrary() return HBA_STATUS_OK. Otherwise, an error value is returned.
ERRORS
See libhbaapi(3LIB) for general error status values.
EXAMPLES
Example 1: Load the common library and each VSL.
The following example loads the common library and each VSL.
if ((status = HBA_LoadLibrary()) != HBA_STATUS_OK) {
fprintf(stderr, "HBA_LoadLibrary failed: %d
", status);
return;
}
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Standard: FC-MI 1.92 (API |
| |version 1) |
+-----------------------------+-----------------------------+
| |Standard: FC-HBA Version 4 |
| |(API version 2) |
+-----------------------------+-----------------------------+
|MT-Level |Safe |
+-----------------------------+-----------------------------+
SEE ALSO
libhbaapi(3LIB), hba.conf(4), attributes(5)
T11 FC-MI Specification
SunOS 5.10 1 Sep 2003 HBA_LoadLibrary(3HBAAPI)
