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

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 allocat-
       ing 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".
", hbaCount, adaptername);
	       HBA_CloseAdapter(handle);
	       continue;
       }

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 ALSO

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

       T11 FC-MI Specification

SunOS 5.10							    1 Sep 2003					 HBA_GetAdapterAttributes(3HBAAPI)