Lines Matching +full:switch +full:- +full:freq +full:- +full:select
1 perf-top(1)
5 ----
6 perf-top - System profiling tool.
9 --------
11 'perf top' [-e <EVENT> | --event=EVENT] [<options>]
14 -----------
19 -------
20 -a::
21 --all-cpus::
22 System-wide collection. (default)
24 -c <count>::
25 --count=<count>::
28 -C <cpu-list>::
29 --cpu=<cpu>::
31 comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
34 -d <seconds>::
35 --delay=<seconds>::
38 -e <event>::
39 --event=<event>::
40 Select the PMU event. Selection can be a symbolic event name
46 -E <entries>::
47 --entries=<entries>::
50 -f <count>::
51 --count-filter=<count>::
54 --group::
57 --group-sort-idx::
62 -F <freq>::
63 --freq=<freq>::
68 -i::
69 --inherit::
72 -k <path>::
73 --vmlinux=<path>::
76 --ignore-vmlinux::
79 --kallsyms=<file>::
82 -m <pages>::
83 --mmap-pages=<pages>::
85 specification with appended unit character - B/K/M/G. The
88 -p <pid>::
89 --pid=<pid>::
92 -t <tid>::
93 --tid=<tid>::
96 -u::
97 --uid=::
100 -r <priority>::
101 --realtime=<priority>::
104 --sym-annotate=<symbol>::
107 -K::
108 --hide_kernel_symbols::
111 -U::
112 --hide_user_symbols::
115 --demangle-kernel::
118 -D::
119 --dump-symtab::
122 -v::
123 --verbose::
126 -z::
127 --zero::
130 -s::
131 --sort::
134 Please see description of --sort in the perf-report man page.
136 --fields=::
137 Specify output field - multiple keys can be specified in CSV format.
142 By default, every sort keys not specified in --field will be appended
145 -n::
146 --show-nr-samples::
149 --show-total-period::
152 --dsos::
154 percentage of the overhead column. See --percentage for more info.
156 --comms::
158 percentage of the overhead column. See --percentage for more info.
160 --symbols::
162 percentage of the overhead column. See --percentage for more info.
164 -M::
165 --disassembler-style=:: Set disassembler style for objdump.
167 --prefix=PREFIX::
168 --prefix-strip=N::
173 --source::
175 disable with --no-source.
177 --asm-raw::
180 -g::
181 Enables call-graph (stack chain/backtrace) recording.
183 --call-graph [mode,type,min[,limit],order[,key][,branch]]::
184 Setup and enable call-graph (stack chain/backtrace) recording,
185 implies -g. See `--call-graph` section in perf-record and
186 perf-report man pages for details.
188 --children::
191 and will be sorted on the data. It requires -g/--call-graph option
193 Enabled by default, disable with --no-children.
195 --max-stack::
197 beyond the specified depth will be ignored. This is a trade-off
203 --ignore-callees=<regex>::
206 function into one place in the call-graph tree.
208 --percent-limit::
212 --percentage::
214 Filters can be applied by --comms, --dsos and/or --symbols options and
221 -w::
222 --column-widths=<width[,width...]>::
226 --proc-map-timeout::
227 When processing pre-existing threads /proc/XXX/mmap, it may take
233 -b::
234 --branch-any::
236 This is a shortcut for --branch-filter any. See --branch-filter for more infos.
238 -j::
239 --branch-filter::
243 It is possible to select the types of branches captured by enabling filters.
251 The various filters must be specified as a comma separated list: --branch-filter any_ret,u,k
254 --raw-trace::
257 --hierarchy::
260 --overwrite::
270 --force::
273 --num-thread-synthesize::
277 --namespaces::
281 -G name::
282 --cgroup name::
284 in per-cpu mode. The cgroup filesystem must be mounted. All threads belonging to
288 an empty cgroup (monitor all the time) using, e.g., -G foo,,bar. Cgroups must have
291 use '-e e1 -e e2 -G foo,foo' or just use '-e e1 -e e2 -G foo'.
293 --all-cgroups::
297 --switch-on EVENT_NAME::
304 perf probe -L icmp_rcv
314 perf top -e cycles,probe:icmp_rcv --switch-on=probe:icmp_rcv
316 Alternatively one can ask for --group and then two overhead columns
317 will appear, the first for cycles and the second for the switch-on event.
319 perf top --group -e cycles,probe:icmp_rcv --switch-on=probe:icmp_rcv
323 examples replacing probe:icmp_rcv with the just-after-init probe.
325 --switch-off EVENT_NAME::
328 --show-on-off-events::
329 Show the --switch-on/off events too. This has no effect in 'perf top' now
330 but probably we'll make the default not to show the switch-on/off events
331 on the --group mode and if there is only one event besides the off/on ones,
335 --stitch-lbr::
337 callgraph. The option must be used with --call-graph lbr recording.
346 --pfm-events events::
347 Select a PMU event using libpfm4 syntax (see http://perfmon2.sf.net)
348 including support for event filters. For example '--pfm-events
351 events cannot be mixed together. The latter must be used with the -e
352 option. The -e option and this one can be mixed and matched. Events
357 --------------------------
394 include::callchain-overhead-calculation.txt[]
397 --------
398 linkperf:perf-stat[1], linkperf:perf-list[1], linkperf:perf-report[1]