NAME

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

CONTENTS

Synopsis
Description
Arguments
Return Values
Errors
Examples
Bugs
See Also

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)


PAPI Programmer’s Reference PAPI_stop_counters (3) September, 2004

  Innovative Computing Laboratory
2001 R&D Winner  
Contact PAPI: papi@cs.utk.edu Computer Science Department
  University of Tennessee