Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

papi_read(3) [centos man page]

PAPI_read(3)							       PAPI							      PAPI_read(3)

NAME
PAPI_read - Read hardware counters from an event set. SYNOPSIS
Detailed Description C Interface: #include <papi.h> int PAPI_read(int EventSet, long_long * values ); PAPI_read() copies the counters of the indicated event set into the provided array. The counters continue counting after the read. Note the differences between PAPI_read() and PAPI_accum(), specifically that PAPI_accum() resets the values array to zero. PAPI_read() assumes an initialized PAPI library and a properly added event set. Parameters: EventSet -- an integer handle for a PAPI Event Set as created by PAPI_create_eventset() *values -- an array to hold the counter values of the counting events Return values: PAPI_EINVAL One or more of the arguments is invalid. PAPI_ESYS A system or C library call failed inside PAPI, see the errno variable. PAPI_ENOEVST The event set specified does not exist. Examples * do_100events(); * if (PAPI_read(EventSet, values) != PAPI_OK) * handle_error(1); * // values[0] now equals 100 * do_100events(); * if (PAPI_accum(EventSet, values) != PAPI_OK) * handle_error(1); * // values[0] now equals 200 * values[0] = -100; * do_100events(); * if (PAPI_accum(EventSet, values) != PAPI_OK) * handle_error(1); * // values[0] now equals 0 * See Also: PAPI_accum PAPI_start PAPI_stop PAPI_reset Author Generated automatically by Doxygen for PAPI from the source code. Version 5.2.0.0 Tue Jun 17 2014 PAPI_read(3)

Check Out this Related Man Page

PAPI_reset(3)							       PAPI							     PAPI_reset(3)

NAME
PAPI_reset - Reset the hardware event counts in an event set. SYNOPSIS
Detailed Description @par C Prototype: int PAPI_reset( int EventSet ); @param EventSet an integer handle for a PAPI event set as created by PAPI_create_eventset @retval PAPI_OK @retval PAPI_ESYS A system or C library call failed inside PAPI, see the errno variable. @retval PAPI_ENOEVST The EventSet specified does not exist. PAPI_reset() zeroes the values of the counters contained in EventSet. This call assumes an initialized PAPI library and a properly added event set @par Example: int EventSet = PAPI_NULL; int Events[] = {PAPI_TOT_INS, PAPI_FP_OPS}; int ret; // Create an empty EventSet ret = PAPI_create_eventset(&EventSet); if (ret != PAPI_OK) handle_error(ret); // Add two events to our EventSet ret = PAPI_add_events(EventSet, Events, 2); if (ret != PAPI_OK) handle_error(ret); // Start counting ret = PAPI_start(EventSet); if (ret != PAPI_OK) handle_error(ret); // Stop counting, ignore values ret = PAPI_stop(EventSet, NULL); if (ret != PAPI_OK) handle_error(ret); // reset the counters in this EventSet ret = PAPI_reset(EventSet); if (ret != PAPI_OK) handle_error(ret); * See Also: PAPI_create_eventset Author Generated automatically by Doxygen for PAPI from the source code. Version 5.2.0.0 Tue Jun 17 2014 PAPI_reset(3)
Man Page