Content-type: text/html Man page of HBA_GetAdapterAttributes

HBA_GetAdapterAttributes

Section: Common Fibre Channel HBA Information Library Functions (3HBAAPI)
Updated: 1 Sep 2003
Index Return to Main Contents
 

NAME

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:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface Stability Standard: FC-MI 1.92 (API version 1)
Standard: FC-HBA Version 4 (API version 2)
MT-LevelSafe

 

SEE ALSO

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

T11 FC-MI Specification


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
EXAMPLES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:51 GMT, October 02, 2010