Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

hba_loadlibrary(3hbaapi) [opensolaris man page]

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 ver- | | |sion 2) | +-----------------------------+-------------------------------------+ |MT-Level |Safe | +-----------------------------+-------------------------------------+ SEE ALSO
libhbaapi(3LIB), hba.conf(4), attributes(5) T11 FC-MI Specification SunOS 5.11 1 Sep 2003 HBA_LoadLibrary(3HBAAPI)

Check Out this Related Man Page

hba.conf(4)															       hba.conf(4)

NAME
hba.conf - configuration file for the HBAAPI library The /etc/hba.conf file is used to specify the Vendor-Specific Libraries that are installed on the system. This file is used by the Common Library to load the individual VSLs when HBA_LoadLibrary(3HBAAPI) is called. If changes are made to the file while the library is in use, the library should be freed and reloaded. A version 1 VSL is compatible only with a version 1 Common Library. A version 2 VSL is compatible with both a version 1 and a version 2 Common Library. Each VSL entry is a single line of the form: "name" "library path" where: name is the description of library. The library name should be prepended with the domain of the manufacturer of the library. library path is the absolute path to the shared object library file. Example 1: Contents of /etc/hba.conf # # This file contains names and references to HBA libraries # # Format: # # <library name> <library pathname> # # The library name should be prepended with the domain of # the manufacturer or driver author. com.sun.fchba32 /usr/lib/libsun_fc.so.1 com.sun.fchba64 /usr/lib/sparcv9/libsun_fc.so.1 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) | +-----------------------------+-----------------------------+ HBA_LoadLibrary(3HBAAPI), libhbaapi(3LIB), attributes(5) The HBAAPI is provided in both 32- and 64-bit versions, but only one configuration file is specified. As a result, both 32- and 64-bit VSL libraries must be specified within the same file. When using the 32-bit Common Library, the 64-bit VSLs will fail to load. When using the 64-bit Common Library, the 32-bit VSLs will fail to load. These failures are silently ignored by the Common Library during normal usage, but can result in warning messages when running client applications in a debugger. 4 Sep 2003 hba.conf(4)
Man Page