pmc_read_1to4 Subroutine

Purpose

Reads the performance monitoring counters (PMC) registers PMC 1 to PMC 4 in problem state.

Performance Monitor APIs Library (libpmapi.a)

#include <pmapi.h>
int pmc_read_1to4 (void * buffer)

The pmc_read_1to4 subroutine reads the registers PMC 1 to PMC 4 into the address of the buffer that is passed as a parameter to the function.

All the four 32- bit PMC registers such as PMC1, PMC2, PMC3, and PMC4 are read in the same order into the buffer.

If the read operation is successful, a value of zero is returned. If the read operation fails, a value of -1 is returned.

The pmapi.h file defines standard macros, data types, and subroutines.