hba_geteventbuffer(3hbaapi) [sunos man page]
HBA_GetEventBuffer(3HBAAPI) Common Fibre Channel HBA Information Library Functions HBA_GetEventBuffer(3HBAAPI) NAME
HBA_GetEventBuffer - remove and return the next event from the HBA's event queue SYNOPSIS
cc [ flag... ] file... -lHBAAPI [ library... ] #include <hbaapi.h> HBA_STATUS HBA_GetEventBuffer(HBA_HANDLE handle, HBA_EVENTINFO *EventBuffer, HBA_UINT32 *EventBufferCount); PARAMETERS
handle an open handle returned from HBA_OpenAdapter(3HBAAPI) EventBuffer a pointer to an HBA_EVENTINFO buffer EventBufferCounta pointer to the maximum number of events that can be stored in the HBA_EVENTINFO buffer. The value will be changed to the actual number of events placed in the buffer on completion. DESCRIPTION
The HBA_GetEventBuffer() function retrieves events from the HBA's event queue. The number of events returned is the lesser of EventBuffer- Count and the number of events on the queue. The returned events are removed from the queue. RETURN VALUES
Upon successful completion, HBA_STATUS_OK is returned. Otherwise, an error value is returned and the value of EventBufferCount is unde- fined. ERRORS
See libhbaapi(3LIB) for general error status values. 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_GetEventBuffer(3HBAAPI)
Check Out this Related Man Page
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 ver- | | |sion 2) | +-----------------------------+-------------------------------------+ |MT-Level |Safe | +-----------------------------+-------------------------------------+ SEE ALSO
HBA_OpenAdapter(3HBAAPI), libhbaapi(3LIB), attributes(5) T11 FC-MI Specification SunOS 5.11 1 Sep 2003 HBA_GetAdapterAttributes(3HBAAPI)