NAME

PAPI_write - Write counter values into counters

CONTENTS

Synopsis
Description
Arguments
Return Values
Errors
Examples
Author
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
  The EventSet is currently counting events and the substrate could not change the values of the running counters.

EXAMPLES


/* Yet to be written */

AUTHOR

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_accum (3)


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

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