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.