f526d68b6c
'perf trace -s list' prints a list of the supported scripting languages. One problem with it is that it falls through and prints the trace as well. The use of 'list' for this also makes it easy to confuse with 'perf trace -l', used for listing available scripts. So change 'perf trace -s list' to 'perf trace -s lang' and fixes the fall-through problem. Signed-off-by: Tom Zanussi <tzanussi@gmail.com> Cc: Ingo Molnar <mingo@elte.hu> Cc: Steven Rostedt <rostedt@goodmis.org> Cc: Keiichi KII <k-keiichi@bx.jp.nec.com> Cc: Peter Zijlstra <a.p.zijlstra@chello.nl> Cc: Paul Mackerras <paulus@samba.org> Cc: Arnaldo Carvalho de Melo <acme@redhat.com> LKML-Reference: <1264580883-15324-2-git-send-email-tzanussi@gmail.com> Signed-off-by: Frederic Weisbecker <fweisbec@gmail.com>
61 lines
1.6 KiB
Text
61 lines
1.6 KiB
Text
perf-trace(1)
|
|
==============
|
|
|
|
NAME
|
|
----
|
|
perf-trace - Read perf.data (created by perf record) and display trace output
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'perf trace' {record <script> | report <script> [args] }
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This command reads the input file and displays the trace recorded.
|
|
|
|
There are several variants of perf trace:
|
|
|
|
'perf trace' to see a detailed trace of the workload that was
|
|
recorded.
|
|
|
|
'perf trace record <script>' to record the events required for 'perf
|
|
trace report'. <script> is the name displayed in the output of
|
|
'perf trace --list' i.e. the actual script name minus any language
|
|
extension.
|
|
|
|
'perf trace report <script>' to run and display the results of
|
|
<script>. <script> is the name displayed in the output of 'perf
|
|
trace --list' i.e. the actual script name minus any language
|
|
extension. The perf.data output from a previous run of 'perf trace
|
|
record <script>' is used and should be present for this command to
|
|
succeed.
|
|
|
|
OPTIONS
|
|
-------
|
|
-D::
|
|
--dump-raw-trace=::
|
|
Display verbose dump of the trace data.
|
|
|
|
-L::
|
|
--Latency=::
|
|
Show latency attributes (irqs/preemption disabled, etc).
|
|
|
|
-l::
|
|
--list=::
|
|
Display a list of available trace scripts.
|
|
|
|
-s ['lang']::
|
|
--script=::
|
|
Process trace data with the given script ([lang]:script[.ext]).
|
|
If the string 'lang' is specified in place of a script name, a
|
|
list of supported languages will be displayed instead.
|
|
|
|
-g::
|
|
--gen-script=::
|
|
Generate perf-trace.[ext] starter script for given language,
|
|
using current perf.data.
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkperf:perf-record[1], linkperf:perf-trace-perl[1]
|