man pages section 3: Extended Library Functions, Volume 2

HBA_FreeLibrary(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 Committed Standard: FC-HBA Version 4 (API version 2) MT-Level Safe Standard FC-MI 1.92 (API version 1)

See Also

libhbaapi(3LIB), hba.conf(4), attributes(5)

T11 FC-MI Specification