SysTutorials

Linux Manual Pages › Section 3

papi_accum(3)

PAPI_accum –

Accumulate and reset counters in an EventSet.

Synopsis

Detailed Description

@par C Interface:
#include <papi.h> @n
int PAPI_accum( int EventSet, long_long * values );
These calls assume an initialized PAPI library and a properly added event set. 
PAPI_accum adds the counters of the indicated event set into the array values. 
The counters are zeroed and continue counting after the operation.
Note the differences between PAPI_read and PAPI_accum, specifically 
that PAPI_accum resets the values array to zero. 
@param EventSet
 an integer handle for a PAPI Event Set 
 as created by PAPI_create_eventset
@param *values 
 an array to hold the counter values of the counting events 
@retval PAPI_EINVAL 
 One or more of the arguments is invalid.
@retval PAPI_ESYS 
 A system or C library call failed inside PAPI, see the errno variable.
@retval PAPI_ENOEVST 
 The event set specified does not exist. 
@par Examples:

 

* do_100events( );
* if ( PAPI_read( EventSet, values) != PAPI_OK )
* handle_error( 1 );
* // values[0] now equals 100
* do_100events( );
* if (PAPI_accum( EventSet, values ) != PAPI_OK )
* handle_error( 1 );
* // values[0] now equals 200
* values[0] = -100;
* do_100events( );
* if (PAPI_accum( EventSet, values ) != PAPI_OK )
* handle_error( 1 );
* // values[0] now equals 0
* 

See Also:

PAPIF_accum

PAPI_start

PAPI_set_opt

PAPI_reset

Author

Generated automatically by Doxygen for PAPI from the source code.