diff options
| author | Ingo Molnar <mingo@elte.hu> | 2010-12-01 03:18:12 -0500 |
|---|---|---|
| committer | Ingo Molnar <mingo@elte.hu> | 2010-12-01 03:22:19 -0500 |
| commit | b3d006c0e745bfd2dab4984ffe3279d5cf4e926a (patch) | |
| tree | 4d1e831872d397cc5bb9cdab6c0e239a0080909c | |
| parent | 4c635a4e04700a371ef7e4d4bb33ed88747e801e (diff) | |
| parent | 133dc4c39c57eeef2577ca5b4ed24765b7a78ce2 (diff) | |
Merge branch 'perf/rename' into perf/core
Merge reason: This is an older commit under testing that was not pushed yet - merge it.
Also fix up the merge in command-list.txt.
Signed-off-by: Ingo Molnar <mingo@elte.hu>
Acked-by: Tom Zanussi <tzanussi@gmail.com>
| -rw-r--r-- | tools/perf/Documentation/perf-script-perl.txt (renamed from tools/perf/Documentation/perf-trace-perl.txt) | 28 | ||||
| -rw-r--r-- | tools/perf/Documentation/perf-script-python.txt (renamed from tools/perf/Documentation/perf-trace-python.txt) | 88 | ||||
| -rw-r--r-- | tools/perf/Documentation/perf-script.txt (renamed from tools/perf/Documentation/perf-trace.txt) | 54 | ||||
| -rw-r--r-- | tools/perf/Makefile | 2 | ||||
| -rw-r--r-- | tools/perf/builtin-lock.c | 6 | ||||
| -rw-r--r-- | tools/perf/builtin-sched.c | 6 | ||||
| -rw-r--r-- | tools/perf/builtin-script.c (renamed from tools/perf/builtin-trace.c) | 40 | ||||
| -rw-r--r-- | tools/perf/builtin.h | 2 | ||||
| -rw-r--r-- | tools/perf/command-list.txt | 2 | ||||
| -rw-r--r-- | tools/perf/perf.c | 2 | ||||
| -rw-r--r-- | tools/perf/scripts/python/Perf-Trace-Util/Context.c | 2 | ||||
| -rw-r--r-- | tools/perf/util/scripting-engines/trace-event-perl.c | 6 | ||||
| -rw-r--r-- | tools/perf/util/scripting-engines/trace-event-python.c | 4 |
13 files changed, 121 insertions, 121 deletions
diff --git a/tools/perf/Documentation/perf-trace-perl.txt b/tools/perf/Documentation/perf-script-perl.txt index ee6525ee6d69..5bb41e55a3ac 100644 --- a/tools/perf/Documentation/perf-trace-perl.txt +++ b/tools/perf/Documentation/perf-script-perl.txt | |||
| @@ -1,19 +1,19 @@ | |||
| 1 | perf-trace-perl(1) | 1 | perf-script-perl(1) |
| 2 | ================== | 2 | ================== |
| 3 | 3 | ||
| 4 | NAME | 4 | NAME |
| 5 | ---- | 5 | ---- |
| 6 | perf-trace-perl - Process trace data with a Perl script | 6 | perf-script-perl - Process trace data with a Perl script |
| 7 | 7 | ||
| 8 | SYNOPSIS | 8 | SYNOPSIS |
| 9 | -------- | 9 | -------- |
| 10 | [verse] | 10 | [verse] |
| 11 | 'perf trace' [-s [Perl]:script[.pl] ] | 11 | 'perf script' [-s [Perl]:script[.pl] ] |
| 12 | 12 | ||
| 13 | DESCRIPTION | 13 | DESCRIPTION |
| 14 | ----------- | 14 | ----------- |
| 15 | 15 | ||
| 16 | This perf trace option is used to process perf trace data using perf's | 16 | This perf script option is used to process perf script data using perf's |
| 17 | built-in Perl interpreter. It reads and processes the input file and | 17 | built-in Perl interpreter. It reads and processes the input file and |
| 18 | displays the results of the trace analysis implemented in the given | 18 | displays the results of the trace analysis implemented in the given |
| 19 | Perl script, if any. | 19 | Perl script, if any. |
| @@ -21,7 +21,7 @@ Perl script, if any. | |||
| 21 | STARTER SCRIPTS | 21 | STARTER SCRIPTS |
| 22 | --------------- | 22 | --------------- |
| 23 | 23 | ||
| 24 | You can avoid reading the rest of this document by running 'perf trace | 24 | You can avoid reading the rest of this document by running 'perf script |
| 25 | -g perl' in the same directory as an existing perf.data trace file. | 25 | -g perl' in the same directory as an existing perf.data trace file. |
| 26 | That will generate a starter script containing a handler for each of | 26 | That will generate a starter script containing a handler for each of |
| 27 | the event types in the trace file; it simply prints every available | 27 | the event types in the trace file; it simply prints every available |
| @@ -30,13 +30,13 @@ field for each event in the trace file. | |||
| 30 | You can also look at the existing scripts in | 30 | You can also look at the existing scripts in |
| 31 | ~/libexec/perf-core/scripts/perl for typical examples showing how to | 31 | ~/libexec/perf-core/scripts/perl for typical examples showing how to |
| 32 | do basic things like aggregate event data, print results, etc. Also, | 32 | do basic things like aggregate event data, print results, etc. Also, |
| 33 | the check-perf-trace.pl script, while not interesting for its results, | 33 | the check-perf-script.pl script, while not interesting for its results, |
| 34 | attempts to exercise all of the main scripting features. | 34 | attempts to exercise all of the main scripting features. |
| 35 | 35 | ||
| 36 | EVENT HANDLERS | 36 | EVENT HANDLERS |
| 37 | -------------- | 37 | -------------- |
| 38 | 38 | ||
| 39 | When perf trace is invoked using a trace script, a user-defined | 39 | When perf script is invoked using a trace script, a user-defined |
| 40 | 'handler function' is called for each event in the trace. If there's | 40 | 'handler function' is called for each event in the trace. If there's |
| 41 | no handler function defined for a given event type, the event is | 41 | no handler function defined for a given event type, the event is |
| 42 | ignored (or passed to a 'trace_handled' function, see below) and the | 42 | ignored (or passed to a 'trace_handled' function, see below) and the |
| @@ -112,13 +112,13 @@ write a useful trace script. The sections below cover the rest. | |||
| 112 | SCRIPT LAYOUT | 112 | SCRIPT LAYOUT |
| 113 | ------------- | 113 | ------------- |
| 114 | 114 | ||
| 115 | Every perf trace Perl script should start by setting up a Perl module | 115 | Every perf script Perl script should start by setting up a Perl module |
| 116 | search path and 'use'ing a few support modules (see module | 116 | search path and 'use'ing a few support modules (see module |
| 117 | descriptions below): | 117 | descriptions below): |
| 118 | 118 | ||
| 119 | ---- | 119 | ---- |
| 120 | use lib "$ENV{'PERF_EXEC_PATH'}/scripts/perl/Perf-Trace-Util/lib"; | 120 | use lib "$ENV{'PERF_EXEC_PATH'}/scripts/perl/perf-script-Util/lib"; |
| 121 | use lib "./Perf-Trace-Util/lib"; | 121 | use lib "./perf-script-Util/lib"; |
| 122 | use Perf::Trace::Core; | 122 | use Perf::Trace::Core; |
| 123 | use Perf::Trace::Context; | 123 | use Perf::Trace::Context; |
| 124 | use Perf::Trace::Util; | 124 | use Perf::Trace::Util; |
| @@ -162,7 +162,7 @@ sub trace_unhandled | |||
| 162 | ---- | 162 | ---- |
| 163 | 163 | ||
| 164 | The remaining sections provide descriptions of each of the available | 164 | The remaining sections provide descriptions of each of the available |
| 165 | built-in perf trace Perl modules and their associated functions. | 165 | built-in perf script Perl modules and their associated functions. |
| 166 | 166 | ||
| 167 | AVAILABLE MODULES AND FUNCTIONS | 167 | AVAILABLE MODULES AND FUNCTIONS |
| 168 | ------------------------------- | 168 | ------------------------------- |
| @@ -170,7 +170,7 @@ AVAILABLE MODULES AND FUNCTIONS | |||
| 170 | The following sections describe the functions and variables available | 170 | The following sections describe the functions and variables available |
| 171 | via the various Perf::Trace::* Perl modules. To use the functions and | 171 | via the various Perf::Trace::* Perl modules. To use the functions and |
| 172 | variables from the given module, add the corresponding 'use | 172 | variables from the given module, add the corresponding 'use |
| 173 | Perf::Trace::XXX' line to your perf trace script. | 173 | Perf::Trace::XXX' line to your perf script script. |
| 174 | 174 | ||
| 175 | Perf::Trace::Core Module | 175 | Perf::Trace::Core Module |
| 176 | ~~~~~~~~~~~~~~~~~~~~~~~~ | 176 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
| @@ -204,7 +204,7 @@ argument. | |||
| 204 | Perf::Trace::Util Module | 204 | Perf::Trace::Util Module |
| 205 | ~~~~~~~~~~~~~~~~~~~~~~~~ | 205 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
| 206 | 206 | ||
| 207 | Various utility functions for use with perf trace: | 207 | Various utility functions for use with perf script: |
| 208 | 208 | ||
| 209 | nsecs($secs, $nsecs) - returns total nsecs given secs/nsecs pair | 209 | nsecs($secs, $nsecs) - returns total nsecs given secs/nsecs pair |
| 210 | nsecs_secs($nsecs) - returns whole secs portion given nsecs | 210 | nsecs_secs($nsecs) - returns whole secs portion given nsecs |
| @@ -214,4 +214,4 @@ Various utility functions for use with perf trace: | |||
| 214 | 214 | ||
| 215 | SEE ALSO | 215 | SEE ALSO |
| 216 | -------- | 216 | -------- |
| 217 | linkperf:perf-trace[1] | 217 | linkperf:perf-script[1] |
diff --git a/tools/perf/Documentation/perf-trace-python.txt b/tools/perf/Documentation/perf-script-python.txt index 693be804dd3d..36b38277422c 100644 --- a/tools/perf/Documentation/perf-trace-python.txt +++ b/tools/perf/Documentation/perf-script-python.txt | |||
| @@ -1,19 +1,19 @@ | |||
| 1 | perf-trace-python(1) | 1 | perf-script-python(1) |
| 2 | ==================== | 2 | ==================== |
| 3 | 3 | ||
| 4 | NAME | 4 | NAME |
| 5 | ---- | 5 | ---- |
| 6 | perf-trace-python - Process trace data with a Python script | 6 | perf-script-python - Process trace data with a Python script |
| 7 | 7 | ||
| 8 | SYNOPSIS | 8 | SYNOPSIS |
| 9 | -------- | 9 | -------- |
| 10 | [verse] | 10 | [verse] |
| 11 | 'perf trace' [-s [Python]:script[.py] ] | 11 | 'perf script' [-s [Python]:script[.py] ] |
| 12 | 12 | ||
| 13 | DESCRIPTION | 13 | DESCRIPTION |
| 14 | ----------- | 14 | ----------- |
| 15 | 15 | ||
| 16 | This perf trace option is used to process perf trace data using perf's | 16 | This perf script option is used to process perf script data using perf's |
| 17 | built-in Python interpreter. It reads and processes the input file and | 17 | built-in Python interpreter. It reads and processes the input file and |
| 18 | displays the results of the trace analysis implemented in the given | 18 | displays the results of the trace analysis implemented in the given |
