HBA_GetAdapterAttributes

- retrieve attributes about a specific HBA

Synopsis

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

HBA_STATUS HBA_GetAdapterAttributes(HBA_HANDLE handle,
     HBA_ADAPTERATTRIBUTES *hbaattributes);

Parameters

handle

an open handle returned from HBA_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. Otherwise, an error value is returned and the values in hbaattributes 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;
}

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

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

T11 FC-MI Specification