Content-type: text/html Man page of HBA_GetEventBuffer

HBA_GetEventBuffer

Section: Common Fibre Channel HBA Information Library Functions (3HBAAPI)
Updated: 1 Sep 2003
Index Return to Main Contents
 

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

EventBufferCount a 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 EventBufferCount 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 undefined.  

ERRORS

See libhbaapi(3LIB) for general error status values.  

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface Stability Standard: FC-MI 1.92 (API version 1)
Standard: FC-HBA Version 4 (API version 2)
MT-LevelSafe

 

SEE ALSO

HBA_OpenAdapter(3HBAAPI), libhbaapi(3LIB), attributes(5)

T11 FC-MI Specification


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:52 GMT, October 02, 2010