Commit | Line | Data |
---|---|---|
1d8c8b20 | 1 | perf-top(1) |
6e6b754f | 2 | =========== |
1d8c8b20 IM |
3 | |
4 | NAME | |
5 | ---- | |
83617983 | 6 | perf-top - System profiling tool. |
1d8c8b20 IM |
7 | |
8 | SYNOPSIS | |
9 | -------- | |
10 | [verse] | |
83617983 | 11 | 'perf top' [-e <EVENT> | --event=EVENT] [<options>] |
1d8c8b20 IM |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
2e7a9881 | 15 | This command generates and displays a performance counter profile in real time. |
1d8c8b20 IM |
16 | |
17 | ||
18 | OPTIONS | |
19 | ------- | |
83617983 MG |
20 | -a:: |
21 | --all-cpus:: | |
22 | System-wide collection. (default) | |
23 | ||
24 | -c <count>:: | |
25 | --count=<count>:: | |
26 | Event period to sample. | |
27 | ||
c45c6ea2 SE |
28 | -C <cpu-list>:: |
29 | --cpu=<cpu>:: | |
2e7a9881 SB |
30 | Monitor only on the list of CPUs provided. Multiple CPUs can be provided as a |
31 | comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. | |
c45c6ea2 | 32 | Default is to monitor all CPUS. |
83617983 MG |
33 | |
34 | -d <seconds>:: | |
35 | --delay=<seconds>:: | |
36 | Number of seconds to delay between refreshes. | |
1d8c8b20 | 37 | |
83617983 MG |
38 | -e <event>:: |
39 | --event=<event>:: | |
386b05e3 TG |
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 | |
83617983 | 43 | hexadecimal event descriptor. |
1d8c8b20 | 44 | |
83617983 MG |
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 | ||
2e7a9881 SB |
53 | -g:: |
54 | --group:: | |
55 | Put the counters into a counter group. | |
56 | ||
83617983 MG |
57 | -F <freq>:: |
58 | --freq=<freq>:: | |
59 | Profile at this frequency. | |
60 | ||
61 | -i:: | |
62 | --inherit:: | |
2376c67a | 63 | Child tasks do not inherit counters. |
83617983 MG |
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>:: | |
b52956c9 | 75 | Profile events on existing Process ID (comma separated list). |
2e7a9881 SB |
76 | |
77 | -t <tid>:: | |
78 | --tid=<tid>:: | |
b52956c9 | 79 | Profile events on existing thread ID (comma separated list). |
83617983 | 80 | |
0d37aa34 ACM |
81 | -u:: |
82 | --uid=:: | |
83 | Record events in threads owned by uid. Name or number. | |
84 | ||
83617983 MG |
85 | -r <priority>:: |
86 | --realtime=<priority>:: | |
87 | Collect data with this RT SCHED_FIFO priority. | |
88 | ||
89 | -s <symbol>:: | |
90 | --sym-annotate=<symbol>:: | |
6cff0e8d | 91 | Annotate this symbol. |
83617983 | 92 | |
2e7a9881 SB |
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 | ||
83617983 MG |
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 | ||
ab81f3fd ACM |
113 | -s:: |
114 | --sort:: | |
f5d05bce AK |
115 | Sort by key(s): pid, comm, dso, symbol, parent, srcline, weight, |
116 | local_weight, abort, in_tx | |
ab81f3fd ACM |
117 | |
118 | -n:: | |
119 | --show-nr-samples:: | |
120 | Show a column with the number of samples. | |
121 | ||
122 | --show-total-period:: | |
123 | Show a column with the sum of periods. | |
124 | ||
125 | --dsos:: | |
126 | Only consider symbols in these dsos. | |
127 | ||
128 | --comms:: | |
129 | Only consider symbols in these comms. | |
130 | ||
131 | --symbols:: | |
132 | Only consider these symbols. | |
133 | ||
64c6f0c7 ACM |
134 | -M:: |
135 | --disassembler-style=:: Set disassembler style for objdump. | |
136 | ||
137 | --source:: | |
138 | Interleave source code with assembly code. Enabled by default, | |
139 | disable with --no-source. | |
140 | ||
141 | --asm-raw:: | |
142 | Show raw instruction encoding of assembly instructions. | |
143 | ||
19d4ac3c ACM |
144 | -G [type,min,order]:: |
145 | --call-graph:: | |
146 | Display call chains using type, min percent threshold and order. | |
147 | type can be either: | |
148 | - flat: single column, linear exposure of call chains. | |
149 | - graph: use a graph tree, displaying absolute overhead rates. | |
150 | - fractal: like graph, but displays relative rates. Each branch of | |
151 | the tree is considered as a new profiled object. | |
152 | ||
153 | order can be either: | |
154 | - callee: callee based call graph. | |
155 | - caller: inverted caller based call graph. | |
156 | ||
157 | Default: fractal,0.5,callee. | |
158 | ||
b21484f1 GP |
159 | --ignore-callees=<regex>:: |
160 | Ignore callees of the function(s) matching the given regex. | |
161 | This has the effect of collecting the callers of each such | |
162 | function into one place in the call-graph tree. | |
163 | ||
fa5df943 NK |
164 | --percent-limit:: |
165 | Do not show entries which have an overhead under that percent. | |
166 | (Default: 0). | |
167 | ||
83617983 MG |
168 | INTERACTIVE PROMPTING KEYS |
169 | -------------------------- | |
170 | ||
171 | [d]:: | |
172 | Display refresh delay. | |
173 | ||
174 | [e]:: | |
175 | Number of entries to display. | |
176 | ||
177 | [E]:: | |
178 | Event to display when multiple counters are active. | |
179 | ||
180 | [f]:: | |
181 | Profile display filter (>= hit count). | |
182 | ||
183 | [F]:: | |
184 | Annotation display filter (>= % of total). | |
185 | ||
186 | [s]:: | |
187 | Annotate symbol. | |
188 | ||
189 | [S]:: | |
190 | Stop annotation, return to full profile display. | |
191 | ||
83617983 MG |
192 | [z]:: |
193 | Toggle event count zeroing across display updates. | |
194 | ||
195 | [qQ]:: | |
196 | Quit. | |
197 | ||
198 | Pressing any unmapped key displays a menu, and prompts for input. | |
1d8c8b20 | 199 | |
1d8c8b20 | 200 | |
1d8c8b20 IM |
201 | SEE ALSO |
202 | -------- | |
386b05e3 | 203 | linkperf:perf-stat[1], linkperf:perf-list[1] |