|
Packit Service |
a1973e |
.TH "PAPI_reset" 3 "Mon Dec 18 2017" "Version 5.6.0.0" "PAPI" \" -*- nroff -*-
|
|
Packit Service |
a1973e |
.ad l
|
|
Packit Service |
a1973e |
.nh
|
|
Packit Service |
a1973e |
.SH NAME
|
|
Packit Service |
a1973e |
PAPI_reset \-
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
Reset the hardware event counts in an event set\&.
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.SH SYNOPSIS
|
|
Packit Service |
a1973e |
.br
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
.SH "Detailed Description"
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
.nf
|
|
Packit Service |
a1973e |
@par C Prototype:
|
|
Packit Service |
a1973e |
\#include <papi.h> @n
|
|
Packit Service |
a1973e |
int PAPI_reset( int EventSet );
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
@param EventSet
|
|
Packit Service |
a1973e |
an integer handle for a PAPI event set as created by PAPI_create_eventset
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
@retval PAPI_OK
|
|
Packit Service |
a1973e |
@retval PAPI_ESYS
|
|
Packit Service |
a1973e |
A system or C library call failed inside PAPI, see the errno variable.
|
|
Packit Service |
a1973e |
@retval PAPI_ENOEVST
|
|
Packit Service |
a1973e |
The EventSet specified does not exist.
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
PAPI_reset() zeroes the values of the counters contained in EventSet.
|
|
Packit Service |
a1973e |
This call assumes an initialized PAPI library and a properly added event set
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
@par Example:
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.fi
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
.nf
|
|
Packit Service |
a1973e |
int EventSet = PAPI_NULL;
|
|
Packit Service |
a1973e |
int Events[] = {PAPI_TOT_INS, PAPI_FP_OPS};
|
|
Packit Service |
a1973e |
int ret;
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
// Create an empty EventSet
|
|
Packit Service |
a1973e |
ret = PAPI_create_eventset(&EventSet);
|
|
Packit Service |
a1973e |
if (ret != PAPI_OK) handle_error(ret);
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
// Add two events to our EventSet
|
|
Packit Service |
a1973e |
ret = PAPI_add_events(EventSet, Events, 2);
|
|
Packit Service |
a1973e |
if (ret != PAPI_OK) handle_error(ret);
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
// Start counting
|
|
Packit Service |
a1973e |
ret = PAPI_start(EventSet);
|
|
Packit Service |
a1973e |
if (ret != PAPI_OK) handle_error(ret);
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
// Stop counting, ignore values
|
|
Packit Service |
a1973e |
ret = PAPI_stop(EventSet, NULL);
|
|
Packit Service |
a1973e |
if (ret != PAPI_OK) handle_error(ret);
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
// reset the counters in this EventSet
|
|
Packit Service |
a1973e |
ret = PAPI_reset(EventSet);
|
|
Packit Service |
a1973e |
if (ret != PAPI_OK) handle_error(ret);
|
|
Packit Service |
a1973e |
*
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.fi
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
\fBSee Also:\fP
|
|
Packit Service |
a1973e |
.RS 4
|
|
Packit Service |
a1973e |
\fBPAPI_create_eventset\fP
|
|
Packit Service |
a1973e |
.RE
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.SH "Author"
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
Generated automatically by Doxygen for PAPI from the source code\&.
|