HP A6795A Fibre Channel PCI XL2 Adapter Release Notes, March 2004

HP A6795A Fibre Channel Adapter Driver Release Notes
Known Problems and Workarounds (11.00)
Chapter 1
7
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 A6795A adapter problems, but you may encounter them during
installation or when booting the system. Therefore, they are listed as dependencies.
You may see the following SD (Software Distributor) warnings and errors when you install the A6795A
software using swinstall. These messages are related only to SD. They do not apply to the A6795A Tachyon
XL2 product. This problem will be fixed in a later version of SD.
•During the swinstall step, the following warnings are logged in the swagent.log file:
WARNING: The filesystems in the filesystem table will not be checked against those
currently mounted because the “mount_all_filesystems” option is set to “false.”
You can ignore the message, or you can set the “mount_all_filesystems” option to “true” and make sure
that all the fstab entries are available.
WARNING: The Analysis Phase had warnings. See the above output for details.