summaryrefslogtreecommitdiffstats
path: root/lib/libpmc
diff options
context:
space:
mode:
authorjkoshy <jkoshy@FreeBSD.org>2008-11-12 17:43:37 +0000
committerjkoshy <jkoshy@FreeBSD.org>2008-11-12 17:43:37 +0000
commit4f8c998b6a1f8848fbcac2c452752afd51137150 (patch)
treed7712950f37ee925b792e20b5e148cfda7777d4a /lib/libpmc
parent10ed8c311724de7fd91fd85da53a87f6a899ea53 (diff)
downloadFreeBSD-src-4f8c998b6a1f8848fbcac2c452752afd51137150.zip
FreeBSD-src-4f8c998b6a1f8848fbcac2c452752afd51137150.tar.gz
Document the alternate event names supported for "architectural" PMC events.
Diffstat (limited to 'lib/libpmc')
-rw-r--r--lib/libpmc/pmc.atom.334
-rw-r--r--lib/libpmc/pmc.core.330
-rw-r--r--lib/libpmc/pmc.core2.335
3 files changed, 74 insertions, 25 deletions
diff --git a/lib/libpmc/pmc.atom.3 b/lib/libpmc/pmc.atom.3
index 85cd6b6..f8b32a7 100644
--- a/lib/libpmc/pmc.atom.3
+++ b/lib/libpmc/pmc.atom.3
@@ -23,7 +23,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd September 24, 2008
+.Dd November 12, 2008
.Os
.Dt PMC.ATOM 3
.Sh NAME
@@ -273,13 +273,17 @@ The number of branch instructions decoded.
The number of branches executed, but not necessarily retired.
.It Li BR_INST_RETIRED.ANY
.Pq Event C4H , Umask 00H
+.Pq Alias Qq "Branch Instruction Retired"
The number of branch instructions retired.
+This is an architectural performance event.
.It Li BR_INST_RETIRED.ANY1
.Pq Event C4H , Umask 0FH
The number of branch instructions retired that were mispredicted.
.It Li BR_INST_RETIRED.MISPRED
.Pq Event C5, Umask 00H
+.Pq Alias Qq "Branch Misses Retired"
The number of mispredicted branch instructions retired.
+This is an architectural performance event.
.It Li BR_INST_RETIRED.MISPRED_NOT_TAKEN
.Pq Event C4H , Umask 02H
The number of not taken branch instructions retired that were
@@ -458,10 +462,14 @@ The number of times the L1 data cache is snooped by the other core in
the same processor.
.It Li CPU_CLK_UNHALTED.BUS
.Pq Event 3CH , Umask 01H
+.Pq Alias Qq "Unhalted Reference Cycles"
The number of bus cycles when the core is not in the halt state.
+This is an architectural performance event.
.It Li CPU_CLK_UNHALTED.CORE_P
.Pq Event 3CH , Umask 00H
+.Pq Alias Qq "Unhalted Core Cycles"
The number of core cycles while the core is not in a halt state.
+This is an architectural performance event.
.It Li CPU_CLK_UNHALTED.NO_OTHER
.Pq Event 3CH , Umask 02H
The number of bus cycles during which the core remains unhalted and
@@ -597,7 +605,9 @@ length changing prefix.
The number of cycles during which the instruction queue is full.
.It Li INST_RETIRED.ANY_P
.Pq Event C0H , Umask 00H
+.Pq Alias Qq "Instruction Retired"
The number of instructions retired.
+This is an architectural performance event.
.It Li INST_RETIRED.LOADS
.Pq Event C0H , Umask 01H
The number of instructions retired that contained a load operation.
@@ -744,10 +754,13 @@ The number of L2 cache requests that were rejected.
The number of completed L2 cache requests.
.It Li L2_RQSTS.SELF.DEMAND.I_STATE
.Pq Event 2EH , Umask 41H
+.Pq Alias Qq "LLC Misses"
The number of completed L2 cache demand requests from this core that
missed the L2 cache.
+This is an architectural performance event.
.It Li L2_RQSTS.SELF.DEMAND.MESI
.Pq Event 2EH , Umask 4FH
+.Pq Alias Qq "LLC References"
The number of completed L2 cache demand requests from this core.
.It Li L2_ST Xo
.Op ,cachestate= Ns Ar state
@@ -1154,16 +1167,15 @@ instructions retired.
The following table shows the mapping between the PMC-independent
aliases supported by
.Lb libpmc
-and the underlying hardware events used.
-.Bl -column "branch-mispredicts" "Description"
-.It Em Alias Ta Em Event
-.It Li branches Ta Li BR_INST_RETIRED.ANY
-.It Li branch-mispredicts Ta Li BR_INST_RETIRED.MISPRED
-.It Li dc-misses Ta Li L2_ST,core=this,cachestate=mesi
-.It Li ic-misses Ta Li ICACHE.MISSES
-.It Li instructions Ta Li INST_RETIRED.ANY_P
-.It Li interrupts Ta Li HW_INT_RCV
-.It Li unhalted-cycles Ta Li CPU_CLK_UNHALTED.CORE_P
+and the underlying hardware events used on these CPUs.
+.Bl -column "branch-mispredicts" "cpu_clk_unhalted.core_p" "PMC Class"
+.It Em Alias Ta Em Event Ta Em PMC Class
+.It Li branches Ta Li BR_INST_RETIRED.ANY Ta Li PMC_CLASS_IAP
+.It Li branch-mispredicts Ta Li BR_INST_RETIRED.MISPRED Ta Li PMC_CLASS_IAP
+.It Li ic-misses Ta Li ICACHE.MISSES Ta Li PMC_CLASS_IAP
+.It Li instructions Ta Li INST_RETIRED.ANY_P Ta Li PMC_CLASS_IAF
+.It Li interrupts Ta Li HW_INT_RCV Ta Li PMC_CLASS_IAP
+.It Li unhalted-cycles Ta Li CPU_CLK_UNHALTED.CORE_P Ta Li PMC_CLASS_IAF
.El
.Sh SEE ALSO
.Xr pmc 3 ,
diff --git a/lib/libpmc/pmc.core.3 b/lib/libpmc/pmc.core.3
index 6861eaf..6cfffa0 100644
--- a/lib/libpmc/pmc.core.3
+++ b/lib/libpmc/pmc.core.3
@@ -23,7 +23,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd September 21, 2008
+.Dd November 12, 2008
.Os
.Dt PMC.CORE 3
.Sh NAME
@@ -234,11 +234,15 @@ The number of branch instructions executed including speculative branches.
.Pq Event E0H
The number of branch instructions decoded.
.It Li Br_Instr_Ret
-.Pq Event C4H
+.Pq Event C4H, Umask 00H
+.Pq Alias Qq "Branch Instruction Retired"
The number of branch instructions retired.
+This is an architectural performance event.
.It Li Br_MisPred_Ret
-.Pq Event C5H
+.Pq Event C5H, Umask 00H
+.Pq Alias Qq "Branch Misses Retired"
The number of mispredicted branch instructions retired.
+This is an architectural performance event.
.It Li Br_MisPred_Taken_Ret
.Pq Event CAH
The number of taken and mispredicted branches retired.
@@ -475,7 +479,9 @@ The number of instruction TLB misses.
The number of instructions decoded.
.It Li Instr_Ret
.Pq Event C0H
+.Pq Alias Qq "Instruction Retired"
The number of instructions retired.
+This is an architectural performance event.
.It Li L1_Pref_Req
.Pq Event 4FH
The number of L1 prefetch request due to data cache misses.
@@ -546,6 +552,17 @@ The number of L2 cache writes including speculative writes.
.It Li LD_Blocks
.Pq Event 03H
The number of load operations delayed due to store buffer blocks.
+.It Li LLC_Misses
+.Pq Event 2EH, Umask 41H
+The number of cache misses for references to the last level cache,
+excluding misses due to hardware prefetches.
+This is an architectural performance event.
+.It Li LLC_Reference
+The number of references to the last level cache,
+excluding those due to hardware prefetches.
+This is an architectural performance event.
+.Pq Event 2EH, Umask 4FH
+This is an architectural performance event.
.It Li MMX_Assist
.Pq Event CDH
The number of EMMX instructions executed.
@@ -573,7 +590,9 @@ and integer multiplies.
This event is available on PMC1 only.
.It Li NonHlt_Ref_Cycles
.Pq Event 3CH , Umask 01H
+.Pq Alias Qq "Unhalted Reference Cycles"
The number of non-halted bus cycles.
+This is an architectural performance event.
.It Li Pref_Rqsts_Dn
.Pq Event F8H
The number of hardware prefetch requests issued in backward streams.
@@ -690,6 +709,11 @@ The duration in a thermal trip based on the current core clock.
.It Li Unfusion
.Pq Event DBH
The number of unfusion events.
+.It Li "Unhalted_Core_Cycles"
+.Pq Event 3CH , Umask 00H
+The number of core clock cycles when the clock signal on a specific
+core is not halted.
+This is an architectural performance event.
.It Li Uops_Ret
.Pq Event C2H
The number of micro-ops retired.
diff --git a/lib/libpmc/pmc.core2.3 b/lib/libpmc/pmc.core2.3
index 82d1ad2..055ce82 100644
--- a/lib/libpmc/pmc.core2.3
+++ b/lib/libpmc/pmc.core2.3
@@ -23,7 +23,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd September 24, 2008
+.Dd November 12, 2008
.Os
.Dt PMC.CORE2 3
.Sh NAME
@@ -271,10 +271,14 @@ The number of branch instructions decoded.
The number of branches executed, but not necessarily retired.
.It Li BR_INST_RETIRED.ANY
.Pq Event C4H , Umask 00H
+.Pq Alias Qq "Branch Instruction Retired"
The number of branch instructions retired.
+This is an architectural performance event.
.It Li BR_INST_RETIRED.MISPRED
-.Pq Event C5H
+.Pq Event C5H, Umask 00H
+.Pq Alias Qq "Branch Misses Retired"
The number of mispredicted branch instructions retired.
+This is an architectural performance event.
.It Li BR_INST_RETIRED.MISPRED_NOT_TAKEN
.Pq Event C4H , Umask 02H
The number of not taken branch instructions retired that were
@@ -446,10 +450,14 @@ The number of times the L1 data cache is snooped by the other core in
the same processor.
.It Li CPU_CLK_UNHALTED.BUS
.Pq Event 3CH , Umask 01H
+.Pq Alias Qq "Unhalted Reference Cycles"
The number of bus cycles when the core is not in the halt state.
+This is an architectural performance event.
.It Li CPU_CLK_UNHALTED.CORE_P
.Pq Event 3CH , Umask 00H
+.Pq Alias Qq "Unhalted Core Cycles"
The number of core cycles while the core is not in a halt state.
+This is an architectural performance event.
.It Li CPU_CLK_UNHALTED.NO_OTHER
.Pq Event 3CH , Umask 02H
The number of bus cycles during which the core remains unhalted and
@@ -553,7 +561,9 @@ length changing prefix.
The number of cycles during which the instruction queue is full.
.It Li INST_RETIRED.ANY_P
.Pq Event C0H , Umask 00H
+.Pq Alias Qq "Instruction Retired"
The number of instructions retired.
+This is an architectural performance event.
.It Li INST_RETIRED.LOADS
.Pq Event C0H , Umask 01H
The number of instructions retired that contained a load operation.
@@ -705,11 +715,15 @@ The number of L2 cache requests that were rejected.
The number of completed L2 cache requests.
.It Li L2_RQSTS.SELF.DEMAND.I_STATE
.Pq Event 2EH , Umask 41H
+.Pq Alias Qq "LLC Misses"
The number of completed L2 cache demand requests from this core that
missed the L2 cache.
+This is an architectural performance event.
.It Li L2_RQSTS.SELF.DEMAND.MESI
.Pq Event 2EH , Umask 4FH
+.Pq Alias Qq "LLC References"
The number of completed L2 cache demand requests from this core.
+This is an architectural performance event.
.It Li L2_ST Xo
.Op ,cachestate= Ns Ar state
.Op ,core= Ns Ar core
@@ -1075,15 +1089,14 @@ The following table shows the mapping between the PMC-independent
aliases supported by
.Lb libpmc
and the underlying hardware events used.
-.Bl -column "branch-mispredicts" "Description"
-.It Em Alias Ta Em Event
-.It Li branches Ta Li BR_INST_RETIRED.ANY
-.It Li branch-mispredicts Ta Li BR_INST_RETIRED.MISPRED
-.It Li dc-misses Ta Li L2_ST,core=this,cachestate=mesi
-.It Li ic-misses Ta Li L1I_MISSES
-.It Li instructions Ta Li INST_RETIRED.ANY_P
-.It Li interrupts Ta Li HW_INT_RCV
-.It Li unhalted-cycles Ta Li CPU_CLK_UNHALTED.CORE_P
+.Bl -column "branch-mispredicts" "cpu_clk_unhalted.core_p" "PMC Class"
+.It Em Alias Ta Em Event Ta Em PMC Class
+.It Li branches Ta Li BR_INST_RETIRED.ANY Ta Li PMC_CLASS_IAP
+.It Li branch-mispredicts Ta Li BR_INST_RETIRED.MISPRED Ta Li PMC_CLASS_IAP
+.It Li ic-misses Ta Li L1I_MISSES Ta Li PMC_CLASS_IAP
+.It Li instructions Ta Li INST_RETIRED.ANY_P Ta Li PMC_CLASS_IAF
+.It Li interrupts Ta Li HW_INT_RCV Ta Li PMC_CLASS_IAP
+.It Li unhalted-cycles Ta Li CPU_CLK_UNHALTED.CORE_P Ta Li PMC_CLASS_IAF
.El
.Sh SEE ALSO
.Xr pmc 3 ,
OpenPOWER on IntegriCloud