NAME
PAPI_write - Write counter values into counters
CONTENTS
Synopsis
Description
Arguments
Return Values
Errors
Examples
Bugs
See Also
SYNOPSIS
C Interface
#include <papi.h>
int PAPI_write(int EventSet, long_long *values);
Fortran Interface
#include fpapi.h
PAPIF_write(C_INT EventSet, C_LONG_LONG(*) values, C_INT check)
DESCRIPTION
PAPI_write() writes the counter values provided in the array
values into the event set
EventSet. The virtual counters managed by the PAPI library will be set to the
values provided. If the event set is running, an attempt will be made
to write the values to the running counters. This operation is
not permitted by all substrates and may result in a run-time error.
ARGUMENTS
EventSet -- an integer handle for a PAPI event set as created by
PAPI_create_eventset (3)
*values -- an array to hold the counter values of the counting events
RETURN VALUES
On success, this function returns
PAPI_OK.
On error, a non-zero error code is returned.
ERRORS
PAPI_ENOEVST | |
The EventSet specified does not exist.
|
PAPI_ESBSTR | |
PAPI_write() is not implemented for this architecture.
PAPI_ESYS The EventSet is currently counting events and the substrate could
not change the values of the running counters.
|
|
EXAMPLES
/* Yet to be written */
BUGS
This function has no known bugs.
SEE ALSO
PAPI_read (3),
PAPI (3),
PAPIF (3),
PAPI Programmers Reference | PAPI_write (3) | September, 2004 |
|
|