Manual Pages for UNIX Operating System command usage for man HBA_GetBindingCapability

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



NAME
     HBA_GetBindingCapability,             HBA_GetBindingSupport,
     HBA_SetBindingSupport - return and sets binding capabilities
     on an HBA port

SYNOPSIS
     cc [ flag... ] file... -lHBAAPI [ library... ]
     #include 

     HBA_HANDLE HBA_GetBindingCapability(HBA_HANDLE handle,
          HBA_WWN hbaPortWWN, HBA_BIND_CAPABILITY *pFlags);


     HBA_STATUS HBA_GetBindingSupport(HBA_HANDLE handle, HBA_WWN
          hbaPortWWN, HBA_BIND_CAPABILITY *pFlags);


     void HBA_SetBindingSupport(HBA_HANDLE handle, HBA_WWN hbaPortWWN,
          HBA_BIND_CAPABILITY Flags);


PARAMETERS
     handle        an     open     handle      returned      from
                   HBA_OpenAdapter(3HBAAPI)


     hbaPortWWN    the Port WWN of the local  HBA  through  which
                   the  binding  capabilities  implemented by the
                   HBA is returned


     pFlags        a pointer to an HBA_BIND_CAPABILITY  structure
                   that  returns  the persistent binding capabil-
                   ites implemented by the HBA


     Flags         an  HBA_BIND_CAPABILITY  structure  containing
                   the  persistent  binding capabilites to enable
                   for the HBA


DESCRIPTION
     The HBA_GetBindingCapability() function returns the  binding
     capabilities implemented by the HBA.


     The HBA_GetBindingSupport() function returns  the  currently
     enabled binding capabilities for the HBA.






SunOS 5.11           Last change: 1 Sep 2003                    1






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



     The  HBA_SetBindingSupport()  function  sets  the  currently
     enabled  binding  capabilites for the HBA to a subset of the
     binding capabilities implemented by the HBA.

RETURN VALUES
     The HBA_GetBindingCapability()  and  HBA_GetBindingSupport()
     functions return the following values:

     HBA_STATUS_OK

         Persistent binding capabilites have been returned.


     HBA_STATUS_ERROR_ILLEGAL_WWN

         Port WWN hbaPortWWN is not a WWN contained  by  the  HBA
         referenced by handle.


     HBA_STATUS_ERROR_NOT_SUPPORTED

         The HBA handle specified by handle does not support per-
         sistent binding.


     HBA_STATUS_ERROR

         An error occurred. The value of pFlags remains unchanged
         and points to the persistent binding capabilites.



     The HBA_SetBindingSupport() function returns:

     HBA_STATUS_OK

         Persistent binding capabilites have been enabled.


     HBA_STATUS_ERROR_ILLEGAL_WWN

         Port WWN hbaPortWWN is not a WWN contained  by  the  HBA
         referenced by handle.


     HBA_STATUS_ERROR_NOT_SUPPORTED

         The HBA handle specified by handle does not support per-
         sistent binding.





SunOS 5.11           Last change: 1 Sep 2003                    2






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



     HBA_STATUS_ERROR_INCAPABLE

         The flags argument contains a capability not implemented
         by the HBA.


     HBA_STATUS_ERROR

         An error occurred.


ATTRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:



     ____________________________________________________________
   |        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), attributes(5)


     T11 FC-MI Specification


















SunOS 5.11           Last change: 1 Sep 2003                    3






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






















































SunOS 5.11           Last change: 1 Sep 2003                    4