HBA_LoadLibrCommonBFibre Channel HBA Information LibraHBA_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\n", 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 ALSOlibhbaapi(3LIB), hba.conf(4), attributes(5)
T11 FC-MI Specification
SunOS 5.10 1 Sep 2003 HBA_LoadLibrary(3HBAAPI)