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)