Loading...
1perf-top(1)
2===========
3
4NAME
5----
6perf-top - System profiling tool.
7
8SYNOPSIS
9--------
10[verse]
11'perf top' [-e <EVENT> | --event=EVENT] [<options>]
12
13DESCRIPTION
14-----------
15This command generates and displays a performance counter profile in real time.
16
17
18OPTIONS
19-------
20-a::
21--all-cpus::
22 System-wide collection. (default)
23
24-c <count>::
25--count=<count>::
26 Event period to sample.
27
28-C <cpu-list>::
29--cpu=<cpu>::
30Monitor only on the list of CPUs provided. Multiple CPUs can be provided as a
31comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
32Default is to monitor all CPUS.
33
34-d <seconds>::
35--delay=<seconds>::
36 Number of seconds to delay between refreshes.
37
38-e <event>::
39--event=<event>::
40 Select the PMU event. Selection can be a symbolic event name
41 (use 'perf list' to list all events) or a raw PMU
42 event (eventsel+umask) in the form of rNNN where NNN is a
43 hexadecimal event descriptor.
44
45-E <entries>::
46--entries=<entries>::
47 Display this many functions.
48
49-f <count>::
50--count-filter=<count>::
51 Only display functions with more events than this.
52
53-g::
54--group::
55 Put the counters into a counter group.
56
57-F <freq>::
58--freq=<freq>::
59 Profile at this frequency.
60
61-i::
62--inherit::
63 Child tasks inherit counters, only makes sens with -p option.
64
65-k <path>::
66--vmlinux=<path>::
67 Path to vmlinux. Required for annotation functionality.
68
69-m <pages>::
70--mmap-pages=<pages>::
71 Number of mmapped data pages.
72
73-p <pid>::
74--pid=<pid>::
75 Profile events on existing Process ID (comma separated list).
76
77-t <tid>::
78--tid=<tid>::
79 Profile events on existing thread ID (comma separated list).
80
81-u::
82--uid=::
83 Record events in threads owned by uid. Name or number.
84
85-r <priority>::
86--realtime=<priority>::
87 Collect data with this RT SCHED_FIFO priority.
88
89-s <symbol>::
90--sym-annotate=<symbol>::
91 Annotate this symbol.
92
93-K::
94--hide_kernel_symbols::
95 Hide kernel symbols.
96
97-U::
98--hide_user_symbols::
99 Hide user symbols.
100
101-D::
102--dump-symtab::
103 Dump the symbol table used for profiling.
104
105-v::
106--verbose::
107 Be more verbose (show counter open errors, etc).
108
109-z::
110--zero::
111 Zero history across display updates.
112
113-s::
114--sort::
115 Sort by key(s): pid, comm, dso, symbol, parent
116
117-n::
118--show-nr-samples::
119 Show a column with the number of samples.
120
121--show-total-period::
122 Show a column with the sum of periods.
123
124--dsos::
125 Only consider symbols in these dsos.
126
127--comms::
128 Only consider symbols in these comms.
129
130--symbols::
131 Only consider these symbols.
132
133-M::
134--disassembler-style=:: Set disassembler style for objdump.
135
136--source::
137 Interleave source code with assembly code. Enabled by default,
138 disable with --no-source.
139
140--asm-raw::
141 Show raw instruction encoding of assembly instructions.
142
143-G [type,min,order]::
144--call-graph::
145 Display call chains using type, min percent threshold and order.
146 type can be either:
147 - flat: single column, linear exposure of call chains.
148 - graph: use a graph tree, displaying absolute overhead rates.
149 - fractal: like graph, but displays relative rates. Each branch of
150 the tree is considered as a new profiled object.
151
152 order can be either:
153 - callee: callee based call graph.
154 - caller: inverted caller based call graph.
155
156 Default: fractal,0.5,callee.
157
158INTERACTIVE PROMPTING KEYS
159--------------------------
160
161[d]::
162 Display refresh delay.
163
164[e]::
165 Number of entries to display.
166
167[E]::
168 Event to display when multiple counters are active.
169
170[f]::
171 Profile display filter (>= hit count).
172
173[F]::
174 Annotation display filter (>= % of total).
175
176[s]::
177 Annotate symbol.
178
179[S]::
180 Stop annotation, return to full profile display.
181
182[z]::
183 Toggle event count zeroing across display updates.
184
185[qQ]::
186 Quit.
187
188Pressing any unmapped key displays a menu, and prompts for input.
189
190
191SEE ALSO
192--------
193linkperf:perf-stat[1], linkperf:perf-list[1]
1perf-top(1)
2===========
3
4NAME
5----
6perf-top - System profiling tool.
7
8SYNOPSIS
9--------
10[verse]
11'perf top' [-e <EVENT> | --event=EVENT] [<options>]
12
13DESCRIPTION
14-----------
15This command generates and displays a performance counter profile in real time.
16
17
18OPTIONS
19-------
20-a::
21--all-cpus::
22 System-wide collection. (default)
23
24-c <count>::
25--count=<count>::
26 Event period to sample.
27
28-C <cpu-list>::
29--cpu=<cpu>::
30Monitor only on the list of CPUs provided. Multiple CPUs can be provided as a
31comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
32Default is to monitor all CPUS.
33
34-d <seconds>::
35--delay=<seconds>::
36 Number of seconds to delay between refreshes.
37
38-e <event>::
39--event=<event>::
40 Select the PMU event. Selection can be a symbolic event name
41 (use 'perf list' to list all events) or a raw PMU
42 event (eventsel+umask) in the form of rNNN where NNN is a
43 hexadecimal event descriptor.
44
45-E <entries>::
46--entries=<entries>::
47 Display this many functions.
48
49-f <count>::
50--count-filter=<count>::
51 Only display functions with more events than this.
52
53-g::
54--group::
55 Put the counters into a counter group.
56
57-F <freq>::
58--freq=<freq>::
59 Profile at this frequency.
60
61-i::
62--inherit::
63 Child tasks inherit counters, only makes sens with -p option.
64
65-k <path>::
66--vmlinux=<path>::
67 Path to vmlinux. Required for annotation functionality.
68
69-m <pages>::
70--mmap-pages=<pages>::
71 Number of mmapped data pages.
72
73-p <pid>::
74--pid=<pid>::
75 Profile events on existing Process ID.
76
77-t <tid>::
78--tid=<tid>::
79 Profile events on existing thread ID.
80
81-r <priority>::
82--realtime=<priority>::
83 Collect data with this RT SCHED_FIFO priority.
84
85-s <symbol>::
86--sym-annotate=<symbol>::
87 Annotate this symbol.
88
89-K::
90--hide_kernel_symbols::
91 Hide kernel symbols.
92
93-U::
94--hide_user_symbols::
95 Hide user symbols.
96
97-D::
98--dump-symtab::
99 Dump the symbol table used for profiling.
100
101-v::
102--verbose::
103 Be more verbose (show counter open errors, etc).
104
105-z::
106--zero::
107 Zero history across display updates.
108
109INTERACTIVE PROMPTING KEYS
110--------------------------
111
112[d]::
113 Display refresh delay.
114
115[e]::
116 Number of entries to display.
117
118[E]::
119 Event to display when multiple counters are active.
120
121[f]::
122 Profile display filter (>= hit count).
123
124[F]::
125 Annotation display filter (>= % of total).
126
127[s]::
128 Annotate symbol.
129
130[S]::
131 Stop annotation, return to full profile display.
132
133[w]::
134 Toggle between weighted sum and individual count[E]r profile.
135
136[z]::
137 Toggle event count zeroing across display updates.
138
139[qQ]::
140 Quit.
141
142Pressing any unmapped key displays a menu, and prompts for input.
143
144
145SEE ALSO
146--------
147linkperf:perf-stat[1], linkperf:perf-list[1]