HBA_OpenAdapter, HBA_OpenAdapterByWWN, HBA_CloseAdapter - open and close a specific adapter
cc [ flag… ] file… –lHBAAPI [ library… ] #include <hbaapi.h> HBA_HANDLE HBA_OpenAdapter(char *adaptername);
HBA_STATUS HBA_OpenAdapterByWWN(HBA_HANDLE *handle, HBA_WWN wwn);
void HBA_CloseAdapter(HBA_HANDLE handle);
the name of the adapter to open, as returned by HBA_GetAdapterName(3HBAAPI)
a pointer to an HBA_HANDLE
the open handle of the adapter to close, as returned by HBA_OpenAdapter(3HBAAPI)
the WWN to match the Node WWN or Port WWN of the HBA to open
The HBA_OpenAdapter() function opens the adapter specified by adaptername and returns a handle used for subsequent operations on the HBA.
The HBA_OpenAdapterByWWN() function opens a handle to the HBA whose Node or Port WWN matches the wwn argument.
The HBA_CloseAdapter() function closes the open handle.
Upon successful completion, HBA_OpenAdapter() returns a valid HBA_HANDLE with a numeric value greater than 0. Otherwise, 0 is returned.
The HBA_OpenAdapterByWWN() function returns the following values:
The handle argument contains a valid HBA handle.
The wwn argument is not a valid port WWN on the specified HBA.
The WWN is matched to multiple adapters.
An error occurred while opening the adapter.
The following example opens the specified adapter.
handle = HBA_OpenAdapter(adaptername); if (handle == 0) { fprintf(stderr, "Unable to open HBA %d with name " "\"%s\".\n", hbaCount, adaptername); continue; }
See attributes(5) for descriptions of the following attributes:
|
HBA_GetAdapterName(3HBAAPI), HBA_OpenAdapter(3HBAAPI), libhbaapi(3LIB), attributes(5)