HP A6684A and A6685A HSC Fibre Channel Adapter Release Notes, December 2001

HP A6684A and A6685A HSC Fibre Channel Adapter Release Notes
Known Problems and Workarounds (11.00)
10
Known Problems and Workarounds (11.00)
1. This problem concerns the HP Fibre Channel SNIA HBA API.
Problem: When the HBA_OpenAdapter() API returns 0, it does not set the errno variable
appropriately under the following scenarios:
• When there is a file open error, the errno variable is not set to EACCES.
• When the adapter for open is not available, the errno variable is not set to ENXIO.
• When there is an internal error, the API does not always set the errno variable to EIO.
If the errno is not set appropriately, the user application may fail to identify the cause of
the failure.
Workaround or Fix: The user application may set the errno value to 0 immediately
before the call to HBA_OpenAdapter(). If the call returns 0, the application can verify if
there is a change in the errno value. If the errno value remains 0, the API has not set the
errno value due to any one of the above listed error scenarios. Otherwise, the errno value
set by the API may be interpreted as given in the programmer’s guide.
Example code:
HBA _HANDLE adapter_handle;
errno = 0;
adapter_handle = HBA_OpenAdapter(adapter_name);
if (adapter_handle == 0)
{
if (errno == 0)
{
printf(“HBA_OpenAdapter() failed - Error cause not available\n”);
}else
{
printf(“HBA_OpenAdapter() failed - errno set to %d\n”, errno);
}
}else
{
printf(“HBA_OpenAdapter() returned a handle of %u\n”, adapter_handle);
}
Dependencies
The following dependencies are not A6684A or A6685A adapter problems, but you may