Linux Certif

Toute la documentation sur la certification Linux LPI

PAPI_stop_counters

NAME

PAPI_stop_counters - PAPI High Level: stop counting hardware events and reset values to zero

SYNOPSIS

C Interface

 #include <papi.h>
 int PAPI_stop_counters(long_long *values, int array_len);
 

Fortran Interface

 PAPIF_stop_counters(C_LONG_LONG(*) values, C_INT array_len, C_INT check)
 #include fpapi.h
 

DESCRIPTION

PAPI_stop_counters()

This function stops the counters and copies the counts into the values array. The counters must have been started by a previous call to PAPI_start_counters(). After this function is called, the values are reset to zero.

ARGUMENTS

*values -- an array where to put the counter values

array_len -- the number of items in the *values array

RETURN VALUES

On success, this function returns PAPI_OK.
 On error, a non-zero error code is returned.

ERRORS

PAPI_EINVAL

One or more of the arguments is invalid.

PAPI_ENOTRUN

The eventset is not started yet.

PAPI_ENOEVST

The eventset has not been added yet.

EXAMPLES

   int Events[2] = { PAPI_TOT_CYC, PAPI_TOT_INS };
   long_long values[2];
   /* Start counting events */
   if (PAPI_start_counters(Events, 2) != PAPI_OK)
     handle_error(1);
   your_slow_code();
   /* Stop counting events */
   if (PAPI_stop_counters(values, 2) != PAPI_OK)
     handle_error(1);
 

BUGS

This function has no known bugs.

SEE ALSO

PAPI_start_counters(3),PAPI_set_opt(3), PAPI_read_counters(3),PAPI(3),PAPIF(3)