hbaapi(3c) [hpux man page]

hbaapi(3C)																hbaapi(3C)

NAME

       hbaapi - Fibre Channel Storage Network Industry Association Host Bus Adapter Application Programming Interface (FC SNIA HBA API)

DESCRIPTION

       The  Common  HBA  API  provides a consistent HBA standard interface for accessing information in a Fibre Channel Storage Area Network (SAN)
       that would be implemented across vendors as a standard 'C' API supported by vendor specific library instances.

       This API library is thread-safe, but threads should not be cancelled when execution is in the API.

       The following functions are available in the API for managing a Fibre Channel HBA.  This API would be exposed to upper  level  applications
       to control SAN functionality.

       Please refer to for details on structures used.

	    01.
	    02.
	    03.
	    04.
	    05.
	    06.
	    07.

	    08.
	    09.
	    10.
	    11.
	    12.

	    13.
	    14.
	    15.
	    16.
	    17.

	    18.
	    19.

	    FCP Information Functions require that the applications calling them
		  have an effective user id as that of the root user (euid = 0).

	    20.
	    21.
	    22.

	    SCSI Information Functions require that the applications calling them have an effective user id as that of the root user (euid = 0).

	    23.
	    24.

FILES

       Contains the related data structures and definitions as in

AUTHOR

       These APIs were developed by Hewlett-Packard Company.

SEE ALSO

       HBA_GetVersion(3C),  HBA_LoadLibrary(3C),  HBA_FreeLibrary(3C),	HBA_GetNumberOfAdapters(3C),  HBA_GetAdapterName(3C), HBA_OpenAdapter(3C),
       HBA_CloseAdapter(3C), HBA_GetAdapterAttributes(3C), HBA_GetAdapterPortAttributes(3C),  HBA_GetPortStatistics(3C),  HBA_GetDiscoveredPortAt-
       tributes(3C),  HBA_GetPortAttributesByWWN(3C),  HBA_SendCTPassThru(3C),	HBA_GetEventBuffer(3C),  HBA_SetRNIDMgmtInfo(3C), HBA_GetRNIDMgmt-
       Info(3C), HBA_SendRNID(3C), HBA_GetFcpTargetMapping(3C), HBA_GetFcpPersistentBinding(3C), HBA_SendScsiInquiry(3C),  HBA_SendReportLUNs(3C),
       HBA_SendReadCapacity(3C), HBA_RefreshInformation(3C), HBA_ResetStatistics(3C).

																	hbaapi(3C)

HBA_RefreshInformation(3HBAAPI) 	      Common Fibre Channel HBA Information Library Functions		   HBA_RefreshInformation(3HBAAPI)

NAME

       HBA_RefreshInformation, HBA_RefreshAdapterConfiguration - refresh information for a specific HBA

SYNOPSIS

       cc [ flag... ] file... -lHBAAPI [ library... ]
       #include <hbaapi.h>

       void HBA_RefreshInformation(HBA_HANDLE handle);

       void HBA_RefreshAdapterConfiguration(void);

PARAMETERS

       handle	       an open handle returned from HBA_OpenAdapter(3HBAAPI)

DESCRIPTION

       The HBA_RefreshInformation() function requests that the underlying VSL reload all information about the given HBA.  This function should be
       called whenever any function returns HBA_STATUS_ERROR_STALE_DATA, or if an index that was previously valid  returns  HBA_STATUS_ERROR_ILLE-
       GAL_INDEX. Because the underlying VSL can reset all indexes relating to the HBA, all old index values must be discarded by the caller.

       The  HBA_RefreshAdapterConfiguration() function updates information about the HBAs present on the system. This function does not change any
       of the relationships between the HBA API and adapters that have not been reconfigured.  HBA handles continue to refer to the same HBA  even
       if  it  is  no longer installed. The HBA name or index assigned by the library remains assigned to the same HBA even if it has been removed
       and reinstalled, as long as the bus position, WWN, and OS device have not changed. Adapter that have been removed and not  replaced  cannot
       have their HBA handles, HBA names, and HBA indexes reassigned. Calls to these adapters will generate HBA_STATUS_ERROR_UNAVAILABLE.

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

       HBA_OpenAdapter(3HBAAPI), libhbaapi(3LIB), attributes(5)

       T11 FC-MI Specification

SunOS 5.10							    1 Sep 2003					   HBA_RefreshInformation(3HBAAPI)