NAME

PAPI_reset - reset the hardware event counts in an EventSet

CONTENTS

Synopsis
Description
Arguments
Return Values
Errors
Examples
Authors
Bugs
See Also

SYNOPSIS

C Interface

#include <papi.h> 

int PAPI_reset (int EventSet); 

Fortran Interface

#include fpapi.h 

PAPIF_reset(C_INT EventSet, C_INT check) 

DESCRIPTION

PAPI_reset() zeroes the values of the counters contained in EventSet.

ARGUMENTS

EventSet -- an integer handle for a PAPI event set as created by PAPI_create_eventset (3)

RETURN VALUES

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

ERRORS

PAPI_ESYS
  A system or C library call failed inside PAPI, see the errno variable.
PAPI_ENOEVST
  The EventSet specified does not exist.

EXAMPLES


int EventSet = PAPI_NULL;
unsigned int native = 0x0;
long_long values[1];
        
if (PAPI_create_eventset(&EventSet) != PAPI_OK)
  handle_error(1);

/* Add Total Instructions Executed to our EventSet */

if (PAPI_add_event(EventSet, PAPI_TOT_INS) != PAPI_OK) handle_error(1);

/* Start counting */

if (PAPI_start(EventSet) != PAPI_OK) handle_error(1);

poorly_tuned_function();

if (PAPI_stop(EventSet, values) != PAPI_OK) handle_error(1);

printf("%lld\n",values[0]);

if (PAPI_reset(EventSet) != PAPI_OK) handle_error(1);

AUTHORS

The PAPI Team. See them at the PAPI Web Site: http://icl.cs.utk.edu/projects/papi

BUGS

This function has no known bugs.

SEE ALSO

PAPI_add_event (3), PAPI_reset (3), PAPI_read (3), PAPI_set_opt (3), PAPI_remove_event (3), PAPI_cleanup_eventset (3), PAPI_destroy_eventset (3)


PAPI Programmer’s Reference PAPI_reset (3) November, 2003

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