Commit cff68e58 authored by Tom Zanussi's avatar Tom Zanussi Committed by Frederic Weisbecker

perf/scripts: Add perf-trace-python Documentation

Also small update to perf-trace-perl and perf-trace docs.
Signed-off-by: default avatarTom 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-13-git-send-email-tzanussi@gmail.com>
Signed-off-by: default avatarFrederic Weisbecker <fweisbec@gmail.com>
parent 44ad9cd8
...@@ -8,7 +8,7 @@ perf-trace-perl - Process trace data with a Perl script ...@@ -8,7 +8,7 @@ perf-trace-perl - Process trace data with a Perl script
SYNOPSIS SYNOPSIS
-------- --------
[verse] [verse]
'perf trace' [-s [lang]:script[.ext] ] 'perf trace' [-s [Perl]:script[.pl] ]
DESCRIPTION DESCRIPTION
----------- -----------
...@@ -213,6 +213,7 @@ Various utility functions for use with perf trace: ...@@ -213,6 +213,7 @@ Various utility functions for use with perf trace:
nsecs_nsecs($nsecs) - returns nsecs remainder given nsecs nsecs_nsecs($nsecs) - returns nsecs remainder given nsecs
nsecs_str($nsecs) - returns printable string in the form secs.nsecs nsecs_str($nsecs) - returns printable string in the form secs.nsecs
avg($total, $n) - returns average given a sum and a total number of values avg($total, $n) - returns average given a sum and a total number of values
syscall_name($id) - returns the syscall name for the specified syscall_nr
SEE ALSO SEE ALSO
-------- --------
......
This diff is collapsed.
...@@ -19,6 +19,11 @@ There are several variants of perf trace: ...@@ -19,6 +19,11 @@ There are several variants of perf trace:
'perf trace' to see a detailed trace of the workload that was 'perf trace' to see a detailed trace of the workload that was
recorded. recorded.
You can also run a set of pre-canned scripts that aggregate and
summarize the raw trace data in various ways (the list of scripts is
available via 'perf trace -l'). The following variants allow you to
record and run those scripts:
'perf trace record <script>' to record the events required for 'perf 'perf trace record <script>' to record the events required for 'perf
trace report'. <script> is the name displayed in the output of trace report'. <script> is the name displayed in the output of
'perf trace --list' i.e. the actual script name minus any language 'perf trace --list' i.e. the actual script name minus any language
...@@ -31,6 +36,9 @@ There are several variants of perf trace: ...@@ -31,6 +36,9 @@ There are several variants of perf trace:
record <script>' is used and should be present for this command to record <script>' is used and should be present for this command to
succeed. succeed.
See the 'SEE ALSO' section for links to language-specific
information on how to write and run your own trace scripts.
OPTIONS OPTIONS
------- -------
-D:: -D::
...@@ -58,4 +66,5 @@ OPTIONS ...@@ -58,4 +66,5 @@ OPTIONS
SEE ALSO SEE ALSO
-------- --------
linkperf:perf-record[1], linkperf:perf-trace-perl[1] linkperf:perf-record[1], linkperf:perf-trace-perl[1],
linkperf:perf-trace-python[1]
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment