PAPI_cleanup_eventset(3) PAPI PAPI_cleanup_eventset(3)NAMEPAPI_cleanup_eventset-
Empty and destroy an EventSet.
SYNOPSISDetailed Description
C Interface:
#include <papi.h>
int PAPI_cleanup_eventset( int EventSet );
PAPI_cleanup_eventset removes all events from a PAPI event set and
turns off profiling and overflow for all events in the EventSet. This
can not be called if the EventSet is not stopped.
Parameters:
EventSet An integer handle for a PAPI event set as created by
PAPI_create_eventset.
Return values:
PAPI_EINVAL One or more of the arguments is invalid. Attempting to
destroy a non-empty event set or passing in a null pointer to be
destroyed.
PAPI_ENOEVST The EventSet specified does not exist.
PAPI_EISRUN The EventSet is currently counting events.
PAPI_EBUG Internal error, send mail to ptools-perfapi@ptools.org
and complain.
Examples:
// Remove all events in the eventset
if ( PAPI_cleanup_eventset( EventSet ) != PAPI_OK )
handle_error( 1 );
See also:
PAPI_profil
PAPI_create_eventset
PAPI_add_event
PAPI_stop
Author
Generated automatically by Doxygen for PAPI from the source code.
Version 5.1.1.0 Tue May 21 2013 PAPI_cleanup_eventset(3)