Lines Matching +full:ext +full:- +full:gen
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.
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=::
82 -L::
83 --Latency=::
86 -l::
87 --list=::
90 -s ['lang']::
91 --script=::
92 Process trace data with the given script ([lang]:script[.ext]).
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
166 $ perf script -F comm,tid,trace
173 perf script -v -F sw:comm,tid,trace
176 At this point usage is displayed, and perf-script exits.
201 i.e., -F "" is not allowed.
207 …M/P/-: M=branch target mispredicted or branch direction was mispredicted, P=target predicted or di…
208 X/- : X=branch inside a transactional region, -=not in transaction region or not supported
209 A/- : A=TSX abort entry, -=not aborted region or not supported
216 sample was recorded with perf record -b or -j any.
228 For sample events it's possible to display misc field with -F +misc option,
241 $ perf script -F +misc ...
242 sched-messaging 1414 K 28690.636582: 4590 cycles ...
243 sched-messaging 1407 U 28690.636600: 325620 cycles ...
244 sched-messaging 1414 K 28690.636608: 19473 cycles ...
247 -k::
248 --vmlinux=<file>::
251 --kallsyms=<file>::
254 --symfs=<directory>::
257 -G::
258 --hide-call-graph::
261 --stop-bt::
264 -C::
265 --cpu:: Only report samples for the list of CPUs provided. Multiple CPUs can
266 be provided as a comma-separated list with no space: 0,1. Ranges of
267 CPUs are specified with -: 0-2. Default is to report samples on all
270 -c::
271 --comms=::
275 --pid=::
278 --tid=::
281 -I::
282 --show-info::
288 --show-kernel-path::
291 --show-task-events
294 --show-mmap-events
297 --show-namespace-events
300 --show-switch-events
304 --show-lost-events
307 --show-round-events
310 --demangle::
312 disable with --no-demangle.
314 --demangle-kernel::
317 --header
320 --header-only
323 --itrace::
328 To disable decoding entirely, use --no-itrace.
330 --full-source-path::
333 --max-stack::
335 beyond the specified depth will be ignored. This is a trade-off
338 Note that when using the --itrace option the synthesized callchain size
343 --ns::
346 -f::
347 --force::
350 --time::
358 'a%/n,b%/m,...' or 'a%-b%,c%-%d,...'.
362 perf script --time 10%/2
365 perf script --time 0%-10%
368 perf script --time 10%/1,10%/2
371 perf script --time 0%-10%,30%-40%
373 --max-blocks::
377 --per-event-dump::
381 --inline::
384 default, disable with --no-inline.
387 --------
388 linkperf:perf-record[1], linkperf:perf-script-perl[1],
389 linkperf:perf-script-python[1]