GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PMC.IAF (3)

NAME

pmc.iaf - measurement events for Intel fixed function performance counters.

CONTENTS

Library
Synopsis
Description
     PMC Capabilities
     Class Name Prefix
     Event Qualifiers (Fixed Function PMCs)
     Event Specifiers (Fixed Function PMCs)
Examples
See Also
History
Authors

LIBRARY


.Lb libpmc

SYNOPSIS


.In pmc.h

DESCRIPTION

Intel fixed-function PMCs are present in CPUs that conform to version 2 or later of the Intel Performance Measurement Architecture. 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 fixed-function PMCs are documented in
.Rs Volume 3: System Programming Guide
.Re

    PMC Capabilities

Fixed-function PMCs support the following capabilities:
Capability      Support
PMC_CAP_CASCADE      No
PMC_CAP_EDGE      No
PMC_CAP_INTERRUPT      Yes
PMC_CAP_INVERT      No
PMC_CAP_READ      Yes
PMC_CAP_PRECISE      No
PMC_CAP_SYSTEM      Yes
PMC_CAP_TAGGING      No
PMC_CAP_THRESHOLD      No
PMC_CAP_USER      Yes
PMC_CAP_WRITE      Yes
 

    Class Name Prefix

These PMCs are named using a class name prefix of "iaf-".

    Event Qualifiers (Fixed Function PMCs)

These PMCs support the following modifiers:
os Configure the PMC to count events occurring at ring level 0.
usr Configure the PMC to count events occurring at ring levels 1, 2 or 3.
anythread
  (Atom CPUs) Configure the PMC to count events on all logical processors sharing a processor core. The default is to count events on the current logical processor.

If neither of the "os" or "usr" qualifiers are specified, the default is to enable both.

    Event Specifiers (Fixed Function PMCs)

The fixed function PMCs are selectable using the following event names:
INSTR_RETIRED.ANY
  (Fixed Function Counter 0) The number of instructions retired.
CPU_CLK_UNHALTED.CORE
  (Fixed Function Counter 1) The number of core cycles for which the core is not halted.
CPU_CLK_UNHALTED.REF
  (Fixed Function Counter 2) The number of reference cycles for which the core is not halted.

EXAMPLES

To measure the number of core cycles for which the core was not halted use the event specifier "iaf-cpu-clk-unhalted.core".

To measure the number of user instructions retired use the event specifier "iaf-instr-retired.any,usr".

To measure the number of user instructions retired on all logical processors in an Atom CPU, use the event specifier "iaf-instr-retired.any,usr,anythread".

SEE ALSO

pmc(3), pmc.atom(3), pmc.core(3), pmc.core2(3), pmc.k7(3), pmc.k8(3), pmc.p4(3), pmc.p5(3), pmc.p6(3), pmc.soft(3), pmc.tsc(3), pmc_cpuinfo(3), pmclog(3), hwpmc(4)

HISTORY

The pmc library first appeared in
.Fx 6.0 .

AUTHORS

The
.Lb libpmc library was written by
.An Joseph Koshy <jkoshy@FreeBSD.org>.
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.