All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
PAPI_add_named_event Class Reference

add PAPI preset or native hardware event by name to an EventSet More...

Detailed Description

@par C Interface:
\#include <papi.h> @n
int PAPI_add_named_event( int EventSet, char *EventName );

PAPI_add_named_event adds one event to a PAPI EventSet. @n
A hardware event can be either a PAPI preset or a native hardware event code.
For a list of PAPI preset events, see PAPI_presets or run the avail test case
in the PAPI distribution. PAPI presets can be passed to PAPI_query_event to see
if they exist on the underlying architecture.
For a list of native events available on current platform, run the papi_native_avail
utility in the PAPI distribution.

@param EventSet
    An integer handle for a PAPI Event Set as created by PAPI_create_eventset.
@param EventCode 
    A defined event such as PAPI_TOT_INS. 

@retval Positive-Integer
    The number of consecutive elements that succeeded before the error. 
@retval PAPI_EINVAL 
    One or more of the arguments is invalid.
    The PAPI library has not been initialized.
@retval PAPI_ENOMEM 
    Insufficient memory to complete the operation.
    The event set specified does not exist.
@retval PAPI_EISRUN 
    The event set is currently counting events.
    The underlying counter hardware can not count this event and other events 
    in the event set simultaneously.
    The PAPI preset is not available on the underlying hardware.
@retval PAPI_EBUG 
    Internal error, please send mail to the developers. 

@par Examples:
* char EventName = "PAPI_TOT_INS";
* int EventSet = PAPI_NULL;
* unsigned int native = 0x0;
* if ( PAPI_create_eventset( &EventSet ) != PAPI_OK )
* handle_error( 1 );
* // Add Total Instructions Executed to our EventSet
* if ( PAPI_add_named_event( EventSet, EventName ) != PAPI_OK )
* handle_error( 1 );
* // Add native event PM_CYC to EventSet
* if ( PAPI_add_named_event( EventSet, "PM_CYC" ) != PAPI_OK )
* handle_error( 1 );
The vector function should take a pointer to a length argument so a proper return value can be set upon partial success.
@see PAPI_add_event @n
PAPI_query_named_event @n

The documentation for this class was generated from the following file: