| pmc_disable, pmc_enable(3) | administrative control of hardware performance counters |
| pmc_enable, pmc_disable(3) | administrative control of hardware performance counters |
| PMC_ENABLE(3) | MidnightBSD Library Functions Manual | PMC_ENABLE(3) |
pmc_disable,
pmc_enable — administrative
control of hardware performance counters
Performance Counters Library (libpmc, -lpmc)
#include
<pmc.h>
int
pmc_disable(int
cpu, int pmc);
int
pmc_enable(int
cpu, int pmc);
These functions allow specific hardware performance monitoring counters in a system to be disabled and enabled administratively. The hardware performance counters available on each CPU are numbered using small non-negative integers, in a system dependent manner. Disabled counters will not be available to applications for use.
The invoking process needs to have the
PRIV_PMC_MANAGE privilege to perform these
operations.
Function
pmc_disable()
disables the hardware counter numbered by argument pmc
on CPU number cpu.
Function
pmc_enable()
enables the hardware counter numbered by argument pmc
on CPU number cpu.
Hardware PMCs that are currently in use by applications cannot be disabled. Allocation of a process scope software PMC marks all hardware PMCs in the system with the same pmc number as being in-use.
Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
A call to these functions may fail with the following errors:
pmc(3), pmc_cpuinfo(3), pmc_pmcinfo(3), hwpmc(4), pmccontrol(8), priv_check(9)
| September 22, 2008 | midnightbsd-3.1 |