PAPI_destroy_eventset(3) PAPI PAPI_destroy_eventset(3)NAMEPAPI_destroy_eventset-
Empty and destroy an EventSet.
SYNOPSISDetailed Description
@par C Interface:
int PAPI_destroy_eventset( int * EventSet );
PAPI_destroy_eventset deallocates the memory associated with an empty
PAPI EventSet.
Parameters:
*EventSet A pointer to the integer handle for a PAPI event set as
created by PAPI_create_eventset. The value pointed to by EventSet
is then set to PAPI_NULL on success.
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:
* // Free all memory and data structures, EventSet must be empty.
* if ( PAPI_destroy_eventset( &EventSet ) != PAPI_OK )
* handle_error( 1 );
*
@see PAPI_profil @n
PAPI_create_eventset @n
PAPI_add_event @n
PAPI_stop.fi
Author
Generated automatically by Doxygen for PAPI from the source code.
Version 5.2.0.0 Mon Oct 28 2013 PAPI_destroy_eventset(3)