1perf-trace(1)
2=============
3
4NAME
5----
6perf-trace - Read perf.data (created by perf record) and display trace output
7
8SYNOPSIS
9--------
10[verse]
11'perf trace' {record <script> | report <script> [args] }
12
13DESCRIPTION
14-----------
15This command reads the input file and displays the trace recorded.
16
17There are several variants of perf trace:
18
19  'perf trace' to see a detailed trace of the workload that was
20  recorded.
21
22  You can also run a set of pre-canned scripts that aggregate and
23  summarize the raw trace data in various ways (the list of scripts is
24  available via 'perf trace -l').  The following variants allow you to
25  record and run those scripts:
26
27  'perf trace record <script>' to record the events required for 'perf
28  trace report'.  <script> is the name displayed in the output of
29  'perf trace --list' i.e. the actual script name minus any language
30  extension.
31
32  'perf trace report <script>' to run and display the results of
33  <script>.  <script> is the name displayed in the output of 'perf
34  trace --list' i.e. the actual script name minus any language
35  extension.  The perf.data output from a previous run of 'perf trace
36  record <script>' is used and should be present for this command to
37  succeed.
38
39  See the 'SEE ALSO' section for links to language-specific
40  information on how to write and run your own trace scripts.
41
42OPTIONS
43-------
44-D::
45--dump-raw-trace=::
46        Display verbose dump of the trace data.
47
48-L::
49--Latency=::
50        Show latency attributes (irqs/preemption disabled, etc).
51
52-l::
53--list=::
54        Display a list of available trace scripts.
55
56-s ['lang']::
57--script=::
58        Process trace data with the given script ([lang]:script[.ext]).
59	If the string 'lang' is specified in place of a script name, a
60        list of supported languages will be displayed instead.
61
62-g::
63--gen-script=::
64        Generate perf-trace.[ext] starter script for given language,
65        using current perf.data.
66
67SEE ALSO
68--------
69linkperf:perf-record[1], linkperf:perf-trace-perl[1],
70linkperf:perf-trace-python[1]
71