diff options
-rw-r--r-- | tools/perf/Documentation/perf-trace.txt | 27 |
1 files changed, 26 insertions, 1 deletions
diff --git a/tools/perf/Documentation/perf-trace.txt b/tools/perf/Documentation/perf-trace.txt index 07065efa60e0..60e5900da483 100644 --- a/tools/perf/Documentation/perf-trace.txt +++ b/tools/perf/Documentation/perf-trace.txt | |||
@@ -8,18 +8,43 @@ perf-trace - Read perf.data (created by perf record) and display trace output | |||
8 | SYNOPSIS | 8 | SYNOPSIS |
9 | -------- | 9 | -------- |
10 | [verse] | 10 | [verse] |
11 | 'perf trace' [-i <file> | --input=file] symbol_name | 11 | 'perf trace' {record <script> | report <script> [args] } |
12 | 12 | ||
13 | DESCRIPTION | 13 | DESCRIPTION |
14 | ----------- | 14 | ----------- |
15 | This command reads the input file and displays the trace recorded. | 15 | This command reads the input file and displays the trace recorded. |
16 | 16 | ||
17 | There are several variants of perf trace: | ||
18 | |||
19 | 'perf trace' to see a detailed trace of the workload that was | ||
20 | recorded. | ||
21 | |||
22 | 'perf trace record <script>' to record the events required for 'perf | ||
23 | trace report'. <script> is the name displayed in the output of | ||
24 | 'perf trace --list' i.e. the actual script name minus any language | ||
25 | extension. | ||
26 | |||
27 | 'perf trace report <script>' to run and display the results of | ||
28 | <script>. <script> is the name displayed in the output of 'perf | ||
29 | trace --list' i.e. the actual script name minus any language | ||
30 | extension. The perf.data output from a previous run of 'perf trace | ||
31 | record <script>' is used and should be present for this command to | ||
32 | succeed. | ||
33 | |||
17 | OPTIONS | 34 | OPTIONS |
18 | ------- | 35 | ------- |
19 | -D:: | 36 | -D:: |
20 | --dump-raw-trace=:: | 37 | --dump-raw-trace=:: |
21 | Display verbose dump of the trace data. | 38 | Display verbose dump of the trace data. |
22 | 39 | ||
40 | -L:: | ||
41 | --Latency=:: | ||
42 | Show latency attributes (irqs/preemption disabled, etc). | ||
43 | |||
44 | -l:: | ||
45 | --list=:: | ||
46 | Display a list of available trace scripts. | ||
47 | |||
23 | -s:: | 48 | -s:: |
24 | --script=:: | 49 | --script=:: |
25 | Process trace data with the given script ([lang]:script[.ext]). | 50 | Process trace data with the given script ([lang]:script[.ext]). |