Main
Development
Information
Community
Social media
Other
  1. Manuals
  2. Tumbleweed
  3. papi-devel
  4. PAPI_accum(3)

Scroll to navigation

PAPI_accum(3) PAPI PAPI_accum(3)

NAME

PAPI_accum - Accumulate and reset counters in an EventSet.

SYNOPSIS

Detailed Description

C Interface:

#include <papi.h>
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, PAPI_accum() adds the values of the counters to the values stored in the array (the second parameter in PAPI_accum()) and then resets the counters to zero.

Note: The provided array (second parameter in PAPI_accum) must be initialized for PAPI_accum because its values are read inside the function.

Parameters

EventSet an integer handle for a PAPI Event Set as created by PAPI_create_eventset
*values an array to hold the counter values of the counting events

Return values

PAPI_EINVAL One or more of the arguments is invalid.
PAPI_ESYS A system or C library call failed inside PAPI, see the errno variable.
PAPI_ENOEVST The event set specified does not exist.

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.

Mon Feb 24 2025 21:11:21 Version 7.2.0.0b2