FreeBSD manual
download PDF document: pmc.ucf.3.pdf
PMC.UCF(3) FreeBSD Library Functions Manual PMC.UCF(3)
NAME
pmc.ucf - measurement events for Intel uncore fixed function performance
counters.
LIBRARY
Performance Counters Library (libpmc, -lpmc)
SYNOPSIS
#include <pmc.h>
DESCRIPTION
Each fixed-function PMC measures a specific hardware event. The number
of fixed-function PMCs implemented in a CPU can vary. The number of
fixed-function PMCs present can be determined at runtime by using
function pmc_cpuinfo(3).
Intel uncore fixed-function PMCs are documented in Volume 3B: System
Programming Guide, Part 2, Intel(R) 64 and IA-32 Architectures Software
Developes Manual, Order Number: 253669-033US, Intel Corporation, December
2009.
PMC Capabilities
Fixed-function PMCs support the following capabilities:
Capability Support
PMC_CAP_CASCADE No
PMC_CAP_EDGE No
PMC_CAP_INTERRUPT No
PMC_CAP_INVERT No
PMC_CAP_READ Yes
PMC_CAP_PRECISE No
PMC_CAP_SYSTEM No
PMC_CAP_TAGGING No
PMC_CAP_THRESHOLD No
PMC_CAP_USER No
PMC_CAP_WRITE Yes
Class Name Prefix
These PMCs are named using a class name prefix of "ucf-".
Event Specifiers (Fixed Function PMCs)
The fixed function PMCs are selectable using the following event names:
UCLOCK (Fixed Function Counter 0) The fixed-function uncore counter
increments at the rate of the U-clock. The frequency of the
uncore clock domain can be determined from the uncore clock ratio
which is available in the PCI configuration space register at
offset C0H under device number 0 and Function 0.
SEE ALSO
pmc(3), pmc.atom(3), pmc.core(3), pmc.core2(3), pmc.corei7(3),
pmc.corei7uc(3), pmc.iaf(3), pmc.k7(3), pmc.k8(3), pmc.soft(3),
pmc.tsc(3), pmc.westmere(3), pmc.westmereuc(3), pmc_cpuinfo(3),
pmclog(3), hwpmc(4)
HISTORY
The pmc library first appeared in FreeBSD 6.0.