Manual Pages for UNIX Operating System command usage for man HBA_RefreshInformation

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 

     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 previ-
     ously valid returns HBA_STATUS_ERROR_ILLEGAL_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 func-
     tion 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  attri-
     butes:









SunOS 5.11           Last change: 1 Sep 2003                    1






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



______________________________________________________________________
   |        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
     HBA_OpenAdapter(3HBAAPI), libhbaapi(3LIB), attributes(5)


     T11 FC-MI Specification



































SunOS 5.11           Last change: 1 Sep 2003                    2






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






















































SunOS 5.11           Last change: 1 Sep 2003                    3