PAPI_destroy_eventset - Online Linux Manual PageSection : 3
Updated : September, 2004
Source : PAPI Programmer's Reference
Note : PAPI
NAMEPAPI_destroy_eventset, PAPI_cleanup_eventset − empty and destroy an EventSet
SYNOPSISC Interface #include <papi.h>
int PAPI_cleanup_eventset(int EventSet);
int PAPI_destroy_eventset(int *EventSet);Fortran Interface #include "fpapi.h"
PAPIF_cleanup_eventset(C_INT EventSet, C_INT check)
PAPIF_destroy_eventset(C_INT EventSet, C_INT check)
DESCRIPTIONPAPI_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. PAPI_destroy_eventset() deallocates the memory associated with an empty PAPI event set.
ARGUMENTSEventSet" -- an integer handle for a PAPI event set as created by "PAPI_create_eventset(3). *EventSet" -- a pointer to the integer handle for a PAPI event set as created by "PAPI_create_eventset(3). The value pointed to by EventSet is then set to PAPI_NULL on success.
RETURN VALUES
On success, this function returns PAPI_OK."
On error, a non-zero error code is returned.
ERRORSPAPI_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);
/* Free all memory and data structures, EventSet must be empty. */
if (PAPI_destroy_eventset(&EventSet) != PAPI_OK)
handle_error(1);
BUGSIf the user has set profile on an event with the PAPI_profil (3) call, then when destroying the EventSet the memory allocated by PAPI_profil (3) will not be freed. The user should turn off profiling on the Events before destroying the EventSet to prevent this behavior.
SEE ALSOPAPI_create_eventset(3),PAPI_add_event (3), PAPI_stop (3)," PAPI_profil(3)" 0
Johanes Gumabo
Data Size : 8,421 byte
man-PAPI_destroy_eventset.3Build : 2024-12-05, 20:55 :
Visitor Screen : x
Visitor Counter ( page / site ) : 4 / 174,530
Visitor ID : :
Visitor IP : 13.58.245.158 :
Visitor Provider : AMAZON-02 :
Provider Position ( lat x lon ) : 39.962500 x -83.006100 : x
Provider Accuracy Radius ( km ) : 1000 :
Provider City : Columbus :
Provider Province : Ohio , : ,
Provider Country : United States :
Provider Continent : North America :
Visitor Recorder : Version :
Visitor Recorder : Library :
Online Linux Manual Page : Version : Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page : Library : lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page : Library : lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base : Version : Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base : Library : lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.