Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

HBA_GetAdapterAttributes(3) OSS Library Calls Reference Manual
NAME
HBA_GetAdapterAttributes - Retrieves attributes of a Fibre Channel Host Bus Adapter
LIBRARY
H-series OSS processes: /usr/lib/libcmnapi.a
SYNOPSIS
#include <snia_common.h>
HBA_STATUS HBA_GetAdapterAttributes (
HBA_HANDLE handle,
PHBA_ADAPTERATTRIBUTES *adapter_attributes
);
PARAMETERS
handle Handle to an adapter that has been opened by a call to the
HBA_OpenAdapter( ) function.
hba_attributes Used for returning the adapter attributes.
DESCRIPTION
The HBA_GetAdapterAttributes( ) function retrieves the attributes for the adapter. The handle
parameter is of type HBA_HANDLE (defined in the Fibre Channel - Methodologies for Intercon-
nects (FC-MI) Revision 1.6) and is obtained through a call to the HBA_OpenAdapter( ) func-
tion. The adapter_attributes parameter is a pointer to a structure of type
HBA_ADAPTER_ATTRIBUTES, which is defined in the Fibre Channel - Methodologies for
Interconnects (FC-MI) Revision 1.6.
If a string variable is not supported, the string attribute is set to the value Not Supported.
Calling Order
You must call the HBA_GetAdapterAttributes( ) function for an adapter before you can call the
HBA_GetAdapterPortAttributes( ) function or the HBA_GetPortStatistics( ) function for the
same adapter.
You must call the HBA_GetAdapterPortAttributes( ) function for an adapter and port before
you can call the HBA_DiscoveredPortAttributes( ) function for the same adapter and port.
EXAMPLES
This example shows using this function call to print the manufacturer and the serial number of an
adapter.
HBA_STATUS status;
HBA_ADAPTERATTRIBUTES adapter_attributes;
status = HBA_GetAdapterAttributes(adapter_handle,
&adapter_attributes);
if (status == HBA_STATUS_OK) {
printf("Manufacturer: %s",
adapter_attributes.Manufacturer);
printf("Serial Number: %s",
adapter_attributes.SerialNumber);
}
RETURN VALUES
The HBA_GetAdapterAttributes( ) function returns these values:
HBA_STATUS_OK
The call to this function was successful.
3−172 Hewlett-Packard Company 527187-017