Lines Matching +full:display +full:- +full:related
1 perf-script(1)
5 ----
6 perf-script - Read perf.data (created by perf record) and display trace output
9 --------
12 'perf script' [<options>] record <script> [<record-options>] <command>
13 'perf script' [<options>] report <script> [script-args]
14 'perf script' [<options>] <script> <required-script-args> [<record-options>] <command>
15 'perf script' [<options>] <top-script> [script-args]
18 -----------
26 You can also run a set of pre-canned scripts that aggregate and
28 available via 'perf script -l'). The following variants allow you to
33 output of 'perf script --list' i.e. the actual script name minus any
35 recorded using the -a (system-wide) 'perf record' option.
37 'perf script report <script> [args]' to run and display the results
39 script --list' i.e. the actual script name minus any language
45 'perf script <script> <required-script-args> <command>' to both
47 using 'live-mode' i.e. without writing anything to disk. <script>
48 is the name displayed in the output of 'perf script --list' i.e. the
50 not specified, the events are recorded using the -a (system-wide)
56 piped to the stdin of the report script, using the '-o -' and '-i -'
59 'perf script <top-script>' to both record the events required for
60 <top-script> and to run the <top-script> using 'live-mode'
61 i.e. without writing anything to disk. <top-script> is the name
62 displayed in the output of 'perf script --list' i.e. the actual
63 script name minus any language extension; a <top-script> is defined
66 [<record-options>] can be passed to the record steps of 'perf script
67 record' and 'live-mode' variants; this isn't possible however for
68 <top-script> 'live-mode' or 'perf script report' variants.
70 See the 'SEE ALSO' section for links to language-specific
74 -------
78 -D::
79 --dump-raw-trace=::
80 Display verbose dump of the trace data.
82 -L::
83 --Latency=::
86 -l::
87 --list=::
88 Display a list of available trace scripts.
90 -s ['lang']::
91 --script=::
96 -g::
97 --gen-script=::
98 Generate perf-script.[ext] starter script for given language,
101 -a::
102 Force system-wide collection. Scripts run without a <command>
103 normally use -a by default, while scripts run with a <command>
104 normally don't - this option allows the latter to be run in
105 system-wide mode.
107 -i::
108 --input=::
111 -d::
112 --debug-mode::
115 -F::
116 --fields::
119 srcline, period, iregs, uregs, brstack, brstacksym, flags, bpf-output, brstackinsn,
123 e.g., -F sw:comm,tid,time,ip,sym and -F trace:time,cpu,trace
125 perf script -F <fields>
129 perf script -F trace:<fields> -F sw:<fields> -F hw:<fields>
137 -F -cpu,+insn
145 -F trace: -F comm,tid,time,ip,sym
147 The first -F suppresses trace events (field list is ""), but then the
155 -F comm,tid,time,ip,sym -F trace:
157 The first -F sets the fields for all events and the second -F
164 -Fsw:-cpu,-period
172 $ perf script -F comm,tid,trace
179 perf script -v -F sw:comm,tid,trace
182 At this point usage is displayed, and perf-script exits.
192 "tr end" for "bE". However the "x" flag will be display separately in those
196 Instruction Trace decoding. For calls and returns, it will display the
210 i.e., -F "" is not allowed.
212 The brstack output includes branch related information with raw addresses using the
216 …M/P/-: M=branch target mispredicted or branch direction was mispredicted, P=target predicted or di…
217 X/- : X=branch inside a transactional region, -=not in transaction region or not supported
218 A/- : A=TSX abort entry, -=not aborted region or not supported
225 sample was recorded with perf record -b or -j any.
237 For sample events it's possible to display misc field with -F +misc option,
250 $ perf script -F +misc ...
251 sched-messaging 1414 K 28690.636582: 4590 cycles ...
252 sched-messaging 1407 U 28690.636600: 325620 cycles ...
253 sched-messaging 1414 K 28690.636608: 19473 cycles ...
256 -k::
257 --vmlinux=<file>::
260 --kallsyms=<file>::
263 --symfs=<directory>::
266 -G::
267 --hide-call-graph::
268 When printing symbols do not display call chain.
270 --stop-bt::
271 Stop display of callgraph at these symbols
273 -C::
274 --cpu:: Only report samples for the list of CPUs provided. Multiple CPUs can
275 be provided as a comma-separated list with no space: 0,1. Ranges of
276 CPUs are specified with -: 0-2. Default is to report samples on all
279 -c::
280 --comms=::
281 Only display events for these comms. CSV that understands
284 --pid=::
287 --tid=::
290 -I::
291 --show-info::
292 Display extended information about the perf.data file. This adds
293 information which may be very large and thus may clutter the display.
297 --show-kernel-path::
300 --show-task-events
301 Display task related events (e.g. FORK, COMM, EXIT).
303 --show-mmap-events
304 Display mmap related events (e.g. MMAP, MMAP2).
306 --show-namespace-events
307 Display namespace events i.e. events of type PERF_RECORD_NAMESPACES.
309 --show-switch-events
310 Display context switch events i.e. events of type PERF_RECORD_SWITCH or
313 --show-lost-events
314 Display lost events i.e. events of type PERF_RECORD_LOST.
316 --show-round-events
317 Display finished round events i.e. events of type PERF_RECORD_FINISHED_ROUND.
319 --show-bpf-events
320 Display bpf events i.e. events of type PERF_RECORD_KSYMBOL and PERF_RECORD_BPF_EVENT.
322 --show-cgroup-events
323 Display cgroup events i.e. events of type PERF_RECORD_CGROUP.
325 --show-text-poke-events
326 Display text poke events i.e. events of type PERF_RECORD_TEXT_POKE and
329 --demangle::
331 disable with --no-demangle.
333 --demangle-kernel::
336 --header
339 --header-only
342 --itrace::
347 To disable decoding entirely, use --no-itrace.
349 --full-source-path::
352 --max-stack::
354 beyond the specified depth will be ignored. This is a trade-off
357 Note that when using the --itrace option the synthesized callchain size
362 --ns::
365 -f::
366 --force::
369 --time::
375 requires the argument to be quoted e.g. --time "1234.567,1234.789 1235,"
378 'a%/n,b%/m,...' or 'a%-b%,c%-%d,...'.
382 perf script --time 10%/2
385 perf script --time 0%-10%
388 perf script --time 10%/1,10%/2
391 perf script --time 0%-10%,30%-40%
393 --max-blocks::
397 --reltime::
400 --deltatime::
403 --per-event-dump::
407 --inline::
410 default, disable with --no-inline.
412 --insn-trace::
413 Show instruction stream for intel_pt traces. Combine with --xed to
416 --xed::
419 -S::
420 --symbols=symbol[,symbol...]::
425 perf script --symbols=noploop,0x4007a0
427 --call-trace::
429 can be filtered with -C.
431 --call-ret-trace::
434 --graph-function::
438 --switch-on EVENT_NAME::
441 --switch-off EVENT_NAME::
444 --show-on-off-events::
445 Show the --switch-on/off events too.
447 --stitch-lbr::
450 perf record --call-graph lbr.
459 --------
460 linkperf:perf-record[1], linkperf:perf-script-perl[1],
461 linkperf:perf-script-python[1], linkperf:perf-intel-pt[1]