PMC.UCF(3)

NAME
pmc.ucf - measurement events for Intel uncore fixed function performance counters.

LIBRARY
libpmc

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 Intel(R) 64 and IA-32 Architectures Software Developes Manual, Volume 3B: System Programming Guide, Part 2, Order Number: 253669-033US, December 2009, Intel Corporation.

  PMC Capabilities
Fixed-function PMCs support the following capabilities:
Capability | Support
PMC_CAP_CASCADE |
PMC_CAP_EDGE |
PMC_CAP_INTERRUPT |
PMC_CAP_INVERT |
PMC_CAP_READ | Yes
PMC_CAP_PRECISE |
PMC_CAP_SYSTEM |
PMC_CAP_TAGGING |
PMC_CAP_THRESHOLD |
PMC_CAP_USER |
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.iaf(3), pmc.k7(3), pmc.k8(3), pmc.p4(3), pmc.p5(3), pmc.p6(3), pmc.corei7(3), pmc.corei7uc(3), pmc.westmere(3), pmc.westmereuc(3), pmc.soft(3), pmc.tsc(3), pmc_cpuinfo(3), pmclog(3), hwpmc(4)

HISTORY
The pmc library first appeared in FreeBSD 6.0.

AUTHORS
The libpmc library was written by Joseph Koshy <jkoshy@FreeBSD.org>.