diff options
author | jkoshy <jkoshy@FreeBSD.org> | 2008-11-15 11:34:30 +0000 |
---|---|---|
committer | jkoshy <jkoshy@FreeBSD.org> | 2008-11-15 11:34:30 +0000 |
commit | b73772de6881c90475d12618c802c6186f615bd0 (patch) | |
tree | 2e3f658aba9f94ca8c778d19fa62886ab967045a /lib/libpmc | |
parent | c3c6b9be19173ab7196fc9f956578a2baf3830a3 (diff) | |
download | FreeBSD-src-b73772de6881c90475d12618c802c6186f615bd0.zip FreeBSD-src-b73772de6881c90475d12618c802c6186f615bd0.tar.gz |
- Document the class name prefix for these PMCs.
- Document the "anythread" qualifier, available on Atom CPUs.
- Add examples.
Diffstat (limited to 'lib/libpmc')
-rw-r--r-- | lib/libpmc/pmc.iaf.3 | 23 |
1 files changed, 22 insertions, 1 deletions
diff --git a/lib/libpmc/pmc.iaf.3 b/lib/libpmc/pmc.iaf.3 index d651f17..76e0cc8 100644 --- a/lib/libpmc/pmc.iaf.3 +++ b/lib/libpmc/pmc.iaf.3 @@ -23,7 +23,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 3, 2008 +.Dd November 14, 2008 .Os .Dt PMC.IAF 3 .Sh NAME @@ -72,6 +72,9 @@ Fixed-function PMCs support the following capabilities: .It PMC_CAP_USER Ta Yes .It PMC_CAP_WRITE Ta Yes .El +.Ss Class Name Prefix +These pmcs are named using a class name prefix of +.Dq Li iaf- . .Ss Event Qualifiers (Fixed Function PMCs) These PMCs support the following modifiers: .Bl -tag -width indent @@ -80,6 +83,11 @@ Configure the PMC to count events occurring at ring level 0. .It Li usr Configure the PMC to count events occurring at ring levels 1, 2 or 3. +.It Li anythread +.Pq Tn 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. .El .Pp If neither of the @@ -101,6 +109,19 @@ The number of core cycles for which the core is not halted. .Pq Fixed Function Counter 2 The number of reference cycles for which the core is not halted. .El +.Sh EXAMPLES +To measure the number of core cycles for which the core was not halted +use the event specifier +.Qq iaf-cpu-clk-unhalted.core . +.Pp +To measure the number of user instructions retired use the event specifier +.Qq iaf-instr-retired.any,usr . +.Pp +To measure the number of user instructions retired on all logical processors +in an +.Tn Atom +CPU, use the event specifier +.Qq iaf-instr-retired.any,usr,anythread . .Sh SEE ALSO .Xr pmc 3 , .Xr pmc.atom 3 , |