From bb9fd173b2bc8aa73478dc04f732e2ce482f77b3 Mon Sep 17 00:00:00 2001
From: "Frank Ch. Eigler" <fche@elastic.org>
Date: Thu, 18 Mar 2010 17:54:29 -0400
Subject: PR909: add perf.hw_cache.* aliases

* tapset/perf.stp: Add 'em.
* man/tapset::perf.3stap: Document 'em a little.
* stapprobes.3stap.in: Fix .sample (not .samples) probe point typo.
---
 man/tapset::perf.3stap | 34 ++++++++++++++++++++++++++++++----
 1 file changed, 30 insertions(+), 4 deletions(-)

(limited to 'man/tapset::perf.3stap')

diff --git a/man/tapset::perf.3stap b/man/tapset::perf.3stap
index 5aff9799..180a503c 100644
--- a/man/tapset::perf.3stap
+++ b/man/tapset::perf.3stap
@@ -18,10 +18,15 @@ tapset::perf \- systemtap perf probe points
 
 .SH DESCRIPTION
 
-This family of probe points is used to probe "perf events"
-on suitably configured kernels (2.6.33+).  It contains a
-number of aliases for the ABI-specified event type/config
-tuples.
+This family of probe points is used to probe "perf events" on suitably
+configured kernels (2.6.33+).  It contains a number of aliases for the
+ABI-specified event type/config tuples.
+
+The default sampling interval of the translator (1000000) is not
+overridden, so some of these probe points may fire very infrequently.
+Use the lower level
+.B perf.type(AA).config(BB).sample(CC)
+probe point if this is a problem.
 
 .TP
 .B perf.hw.*
@@ -53,6 +58,27 @@ probe perf.sw.alignment_faults
 probe perf.sw.emulation_faults
 .ESAMPLE
 
+
+.TP
+.B perf.hw_cache.TYPE.ACCESS.RESULT
+Hardware cache events, where available.  A subset of the following
+cartesian product may be available:
+.SAMPLE
+probe perf.hw_cache.l1d.*.*
+probe perf.hw_cache.l1i.*.*
+probe perf.hw_cache.ll.*.*
+probe perf.hw_cache.dtlb.*.*
+probe perf.hw_cache.itlb.*.*
+probe perf.hw_cache.bpu.*.*
+
+probe perf.hw_cache.*.read.*
+probe perf.hw_cache.*.write.*
+probe perf.hw_cache.*.prefetch.*
+
+probe perf.hw_cache.*.*.access
+probe perf.hw_cache.*.*.miss
+.ESAMPLE
+
 .SH SEE ALSO
 .IR stap (1),
 .IR stapprobes (3stap)
-- 
cgit