Common Fibre Channel HBA Information Library Functions
HBA_GetAdapterAttributes(3HBAAPI)
NAME
HBA_GetAdapterAttributes - retrieve attributes about a
specific HBASYNOPSIS
cc [ flag... ] file... -lHBAAPI [ library... ]
#include
HBA_STATUS HBA_GetAdapterAttributes(HBA_HANDLE handle,
HBA_ADAPTERATTRIBUTES *hbaattributes);
PARAMETERS
handle an open handle returned fromHBA_OpenAdapter(3HBAAPI)
hbaattributes a pointer to an HBA_ADAPTERATTRIBUTES
structure. Upon successful completion, this structure contains the specified adapter attributes.DESCRIPTION
The HBA_GetAdapterAttributes() function retrieves the
adapter attributes structure for a given HBA. The caller is responsible for allocating hbaattributes.RETURN VALUES
Upon successful completion, HBA_STATUS_OK is returned. Oth-
erwise, an error value is returned and the values in hbaat-
tributes are undefined.ERRORS
See libhbaapi(3LIB) for general error status values.EXAMPLES
Example 1 Return adapter attributes. The following example returns the adapter attributes into hbaAttrs for the given handle.if ((status = HBA_GetAdapterAttributes(handle, &hbaAttrs)) !=
HBA_STATUS_OK) {
fprintf(stderr, "Unable to get adapter attributes for ""HBA %d with name \"%s\".\n", hbaCount, adaptername);
HBA_CloseAdapter(handle);
continue; }SunOS 5.11 Last change: 1 Sep 2003 1
Common Fibre Channel HBA Information Library FunctionsHBA_GetAdapterAttributes(3HBAAPI)
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
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 FunctionsHBA_GetAdapterAttributes(3HBAAPI)
SunOS 5.11 Last change: 1 Sep 2003 3