summaryrefslogtreecommitdiffstats
path: root/man/tapset::perf.3stap
blob: 180a503cc4b7aaa6802a1d3e8143c1e49219fd21 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
.\" -*- nroff -*-
.TH TAPSET::PERF 3stap "" "IBM"
.SH NAME
tapset::perf \- systemtap perf probe points

.\" macros
.de SAMPLE
.br
.RS
.nf
.nh
..
.de ESAMPLE
.hy
.fi
.RE
..

.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.

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.*
A variety of hardware events, as generalized by the kernel.  These
generally require running on bare hardware with selected processors.
.SAMPLE
probe perf.hw.cpu_cycles
probe perf.hw.instructions
probe perf.hw.cache_references
probe perf.hw.cache_misses
probe perf.hw.branch_instructions
probe perf.hw.branch_misses
probe perf.hw.bus_cycles
.ESAMPLE

.TP
.B perf.sw.*
Special "software" events provided by the kernel.  These sometimes work
in virtualized environments and with more processor architectures.
.SAMPLE
probe perf.sw.cpu_clock
probe perf.sw.task_clock
probe perf.sw.page_faults
probe perf.sw.context_switches
probe perf.sw.cpu_migrations
probe perf.sw.page_faults_min
probe perf.sw.page_faults_maj
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)