HBA_GetBindiCommonbFibre(Channel)HBA InformatHBA_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 <hbaapi.h>
HBA_HANDLE HBA_GetBindingCapability(HBA_HANDLE handle, HBA_WWN hba‐
PortWWN, 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 capabilites implemented
by the HBA
Flags an HBA_BIND_CAPABILITY structure containing the persis‐
tent binding capabilites to enable for the HBA
DESCRIPTION
The HBA_GetBindingCapability() function returns the binding capabili‐
ties implemented by the HBA.
The HBA_GetBindingSupport() function returns the currently enabled
binding capabilities for the HBA.
The HBA_SetBindingSupport() function sets the currently enabled binding
capabilites for the HBA to a subset of the binding capabilities imple‐
mented 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 persistent
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 persistent
binding.
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 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 ALSOlibhbaapi(3LIB), attributes(5)
T11 FC-MI Specification
SunOS 5.10 1 Sep 2003 HBA_GetBindingCapability(3HBAAPI)