diff options
| -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 |
| 19 | Python script, if any. | 19 | Python script, if any. |
| @@ -23,15 +23,15 @@ A QUICK EXAMPLE | |||
| 23 | 23 | ||
| 24 | This section shows the process, start to finish, of creating a working | 24 | This section shows the process, start to finish, of creating a working |
| 25 | Python script that aggregates and extracts useful information from a | 25 | Python script that aggregates and extracts useful information from a |
| 26 | raw perf trace stream. You can avoid reading the rest of this | 26 | raw perf script stream. You can avoid reading the rest of this |
| 27 | document if an example is enough for you; the rest of the document | 27 | document if an example is enough for you; the rest of the document |
| 28 | provides more details on each step and lists the library functions | 28 | provides more details on each step and lists the library functions |
| 29 | available to script writers. | 29 | available to script writers. |
| 30 | 30 | ||
| 31 | This example actually details the steps that were used to create the | 31 | This example actually details the steps that were used to create the |
| 32 | 'syscall-counts' script you see when you list the available perf trace | 32 | 'syscall-counts' script you see when you list the available perf script |
| 33 | scripts via 'perf trace -l'. As such, this script also shows how to | 33 | scripts via 'perf script -l'. As such, this script also shows how to |
| 34 | integrate your script into the list of general-purpose 'perf trace' | 34 | integrate your script into the list of general-purpose 'perf script' |
| 35 | scripts listed by that command. | 35 | scripts listed by that command. |
| 36 | 36 | ||
| 37 | The syscall-counts script is a simple script, but demonstrates all the | 37 | The syscall-counts script is a simple script, but demonstrates all the |
| @@ -105,31 +105,31 @@ That single stream will be recorded in a file in the current directory | |||
| 105 | called perf.data. | 105 | called perf.data. |
| 106 | 106 | ||
| 107 | Once we have a perf.data file containing our data, we can use the -g | 107 | Once we have a perf.data file containing our data, we can use the -g |
| 108 | 'perf trace' option to generate a Python script that will contain a | 108 | 'perf script' option to generate a Python script that will contain a |
| 109 | callback handler for each event type found in the perf.data trace | 109 | callback handler for each event type found in the perf.data trace |
| 110 | stream (for more details, see the STARTER SCRIPTS section). | 110 | stream (for more details, see the STARTER SCRIPTS section). |
| 111 | 111 | ||
| 112 | ---- | 112 | ---- |
| 113 | # perf trace -g python | 113 | # perf script -g python |
| 114 | generated Python script: perf-trace.py | 114 | generated Python script: perf-script.py |
| 115 | 115 | ||
| 116 | The output file created also in the current directory is named | 116 | The output file created also in the current directory is named |
| 117 | perf-trace.py. Here's the file in its entirety: | 117 | perf-script.py. Here's the file in its entirety: |
| 118 | 118 | ||
| 119 | # perf trace event handlers, generated by perf trace -g python | 119 | # perf script event handlers, generated by perf script -g python |
| 120 | # Licensed under the terms of the GNU GPL License version 2 | 120 | # Licensed under the terms of the GNU GPL License version 2 |
| 121 | 121 | ||
| 122 | # The common_* event handler fields are the most useful fields common to | 122 | # The common_* event handler fields are the most useful fields common to |
| 123 | # all events. They don't necessarily correspond to the 'common_*' fields | 123 | # all events. They don't necessarily correspond to the 'common_*' fields |
| 124 | # in the format files. Those fields not available as handler params can | 124 | # in the format files. Those fields not available as handler params can |
| 125 | # be retrieved using Python functions of the form common_*(context). | 125 | # be retrieved using Python functions of the form common_*(context). |
| 126 | # See the perf-trace-python Documentation for the list of available functions. | 126 | # See the perf-script-python Documentation for the list of available functions. |
| 127 | 127 | ||
| 128 | import os | 128 | import os |
| 129 | import sys | 129 | import sys |
| 130 | 130 | ||
| 131 | sys.path.append(os.environ['PERF_EXEC_PATH'] + \ | 131 | sys.path.append(os.environ['PERF_EXEC_PATH'] + \ |
| 132 | '/scripts/python/Perf-Trace-Util/lib/Perf/Trace') | 132 | '/scripts/python/perf-script-Util/lib/Perf/Trace') |
| 133 | 133 | ||
| 134 | from perf_trace_context import * | 134 | from perf_trace_context import * |
| 135 | from Core import * | 135 | from Core import * |
| @@ -160,7 +160,7 @@ def print_header(event_name, cpu, secs, nsecs, pid, comm): | |||
| 160 | ---- | 160 | ---- |
| 161 | 161 | ||
| 162 | At the top is a comment block followed by some import statements and a | 162 | At the top is a comment block followed by some import statements and a |
| 163 | path append which every perf trace script should include. | 163 | path append which every perf script script should include. |
| 164 | 164 | ||
| 165 | Following that are a couple generated functions, trace_begin() and | 165 | Following that are a couple generated functions, trace_begin() and |
| 166 | trace_end(), which are called at the beginning and the end of the | 166 | trace_end(), which are called at the beginning and the end of the |
| @@ -189,8 +189,8 @@ simply a utility function used for that purpose. Let's rename the | |||
| 189 | script and run it to see the default output: | 189 | script and run it to see the default output: |
| 190 | 190 | ||
| 191 | ---- | 191 | ---- |
| 192 | # mv perf-trace.py syscall-counts.py | 192 | # mv perf-script.py syscall-counts.py |
| 193 | # perf trace -s syscall-counts.py | 193 | # perf script -s syscall-counts.py |
| 194 | 194 | ||
| 195 | raw_syscalls__sys_enter 1 00840.847582083 7506 perf id=1, args= | 195 | raw_syscalls__sys_enter 1 00840.847582083 7506 perf id=1, args= |
| 196 | raw_syscalls__sys_enter 1 00840.847595764 7506 perf id=1, args= | 196 | raw_syscalls__sys_enter 1 00840.847595764 7506 perf id=1, args= |
| @@ -216,7 +216,7 @@ import os | |||
| 216 | import sys | 216 | import sys |
| 217 | 217 | ||
| 218 | sys.path.append(os.environ['PERF_EXEC_PATH'] + \ | 218 | sys.path.append(os.environ['PERF_EXEC_PATH'] + \ |
| 219 | '/scripts/python/Perf-Trace-Util/lib/Perf/Trace') | 219 | '/scripts/python/perf-script-Util/lib/Perf/Trace') |
| 220 | 220 | ||
| 221 | from perf_trace_context import * | 221 | from perf_trace_context import * |
| 222 | from Core import * | 222 | from Core import * |
| @@ -279,7 +279,7 @@ import os | |||
| 279 | import sys | 279 | import sys |
| 280 | 280 | ||
| 281 | sys.path.append(os.environ['PERF_EXEC_PATH'] + \ | 281 | sys.path.append(os.environ['PERF_EXEC_PATH'] + \ |
| 282 | '/scripts/python/Perf-Trace-Util/lib/Perf/Trace') | 282 | '/scripts/python/perf-script-Util/lib/Perf/Trace') |
| 283 | 283 | ||
| 284 | from perf_trace_context import * | 284 | from perf_trace_context import * |
| 285 | from Core import * | 285 | from Core import * |
| @@ -315,7 +315,7 @@ def print_syscall_totals(): | |||
| 315 | 315 | ||
| 316 | The script can be run just as before: | 316 | The script can be run just as before: |
| 317 | 317 | ||
| 318 | # perf trace -s syscall-counts.py | 318 | # perf script -s syscall-counts.py |
| 319 | 319 | ||
| 320 | So those are the essential steps in writing and running a script. The | 320 | So those are the essential steps in writing and running a script. The |
| 321 | process can be generalized to any tracepoint or set of tracepoints | 321 | process can be generalized to any tracepoint or set of tracepoints |
| @@ -324,17 +324,17 @@ interested in by looking at the list of available events shown by | |||
| 324 | 'perf list' and/or look in /sys/kernel/debug/tracing events for | 324 | 'perf list' and/or look in /sys/kernel/debug/tracing events for |
| 325 | detailed event and field info, record the corresponding trace data | 325 | detailed event and field info, record the corresponding trace data |
| 326 | using 'perf record', passing it the list of interesting events, | 326 | using 'perf record', passing it the list of interesting events, |
| 327 | generate a skeleton script using 'perf trace -g python' and modify the | 327 | generate a skeleton script using 'perf script -g python' and modify the |
| 328 | code to aggregate and display it for your particular needs. | 328 | code to aggregate and display it for your particular needs. |
| 329 | 329 | ||
| 330 | After you've done that you may end up with a general-purpose script | 330 | After you've done that you may end up with a general-purpose script |
| 331 | that you want to keep around and have available for future use. By | 331 | that you want to keep around and have available for future use. By |
| 332 | writing a couple of very simple shell scripts and putting them in the | 332 | writing a couple of very simple shell scripts and putting them in the |
| 333 | right place, you can have your script listed alongside the other | 333 | right place, you can have your script listed alongside the other |
| 334 | scripts listed by the 'perf trace -l' command e.g.: | 334 | scripts listed by the 'perf script -l' command e.g.: |
| 335 | 335 | ||
| 336 | ---- | 336 | ---- |
| 337 | root@tropicana:~# perf trace -l | 337 | root@tropicana:~# perf script -l |
| 338 | List of available trace scripts: | 338 | List of available trace scripts: |
| 339 | workqueue-stats workqueue stats (ins/exe/create/destroy) | 339 | workqueue-stats workqueue stats (ins/exe/create/destroy) |
| 340 | wakeup-latency system-wide min/max/avg wakeup latency | 340 | wakeup-latency system-wide min/max/avg wakeup latency |
| @@ -365,14 +365,14 @@ perf record -a -e raw_syscalls:sys_enter | |||
| 365 | The 'report' script is also a shell script with the same base name as | 365 | The 'report' script is also a shell script with the same base name as |
| 366 | your script, but with -report appended. It should also be located in | 366 | your script, but with -report appended. It should also be located in |
| 367 | the perf/scripts/python/bin directory. In that script, you write the | 367 | the perf/scripts/python/bin directory. In that script, you write the |
| 368 | 'perf trace -s' command-line needed for running your script: | 368 | 'perf script -s' command-line needed for running your script: |
| 369 | 369 | ||
| 370 | ---- | 370 | ---- |
| 371 | # cat kernel-source/tools/perf/scripts/python/bin/syscall-counts-report | 371 | # cat kernel-source/tools/perf/scripts/python/bin/syscall-counts-report |
| 372 | 372 | ||
| 373 | #!/bin/bash | 373 | #!/bin/bash |
| 374 | # description: system-wide syscall counts | 374 | # description: system-wide syscall counts |
| 375 | perf trace -s ~/libexec/perf-core/scripts/python/syscall-counts.py | 375 | perf script -s ~/libexec/perf-core/scripts/python/syscall-counts.py |
| 376 | ---- | 376 | ---- |
| 377 | 377 | ||
| 378 | Note that the location of the Python script given in the shell script | 378 | Note that the location of the Python script given in the shell script |
| @@ -390,17 +390,17 @@ total 32 | |||
| 390 | drwxr-xr-x 4 trz trz 4096 2010-01-26 22:30 . | 390 | drwxr-xr-x 4 trz trz 4096 2010-01-26 22:30 . |
| 391 | drwxr-xr-x 4 trz trz 4096 2010-01-26 22:29 .. | 391 | drwxr-xr-x 4 trz trz 4096 2010-01-26 22:29 .. |
| 392 | drwxr-xr-x 2 trz trz 4096 2010-01-26 22:29 bin | 392 | drwxr-xr-x 2 trz trz 4096 2010-01-26 22:29 bin |
| 393 | -rw-r--r-- 1 trz trz 2548 2010-01-26 22:29 check-perf-trace.py | 393 | -rw-r--r-- 1 trz trz 2548 2010-01-26 22:29 check-perf-script.py |
| 394 | drwxr-xr-x 3 trz trz 4096 2010-01-26 22:49 Perf-Trace-Util | 394 | drwxr-xr-x 3 trz trz 4096 2010-01-26 22:49 perf-script-Util |
| 395 | -rw-r--r-- 1 trz trz 1462 2010-01-26 22:30 syscall-counts.py | 395 | -rw-r--r-- 1 trz trz 1462 2010-01-26 22:30 syscall-counts.py |
| 396 | ---- | 396 | ---- |
| 397 | 397 | ||
| 398 | Once you've done that (don't forget to do a new 'make install', | 398 | Once you've done that (don't forget to do a new 'make install', |
| 399 | otherwise your script won't show up at run-time), 'perf trace -l' | 399 | otherwise your script won't show up at run-time), 'perf script -l' |
| 400 | should show a new entry for your script: | 400 | should show a new entry for your script: |
| 401 | 401 | ||
| 402 | ---- | 402 | ---- |
| 403 | root@tropicana:~# perf trace -l | 403 | root@tropicana:~# perf script -l |
| 404 | List of available trace scripts: | 404 | List of available trace scripts: |
| 405 | workqueue-stats workqueue stats (ins/exe/create/destroy) | 405 | workqueue-stats workqueue stats (ins/exe/create/destroy) |
| 406 | wakeup-latency system-wide min/max/avg wakeup latency | 406 | wakeup-latency system-wide min/max/avg wakeup latency |
| @@ -409,19 +409,19 @@ List of available trace scripts: | |||
| 409 | syscall-counts system-wide syscall counts | 409 | syscall-counts system-wide syscall counts |
| 410 | ---- | 410 | ---- |
| 411 | 411 | ||
| 412 | You can now perform the record step via 'perf trace record': | 412 | You can now perform the record step via 'perf script record': |
| 413 | 413 | ||
| 414 | # perf trace record syscall-counts | 414 | # perf script record syscall-counts |
| 415 | 415 | ||
| 416 | and display the output using 'perf trace report': | 416 | and display the output using 'perf script report': |
| 417 | 417 | ||
| 418 | # perf trace report syscall-counts | 418 | # perf script report syscall-counts |
| 419 | 419 | ||
| 420 | STARTER SCRIPTS | 420 | STARTER SCRIPTS |
| 421 | --------------- | 421 | --------------- |
| 422 | 422 | ||
| 423 | You can quickly get started writing a script for a particular set of | 423 | You can quickly get started writing a script for a particular set of |
| 424 | trace data by generating a skeleton script using 'perf trace -g | 424 | trace data by generating a skeleton script using 'perf script -g |
| 425 | python' in the same directory as an existing perf.data trace file. | 425 | python' in the same directory as an existing perf.data trace file. |
| 426 | That will generate a starter script containing a handler for each of | 426 | That will generate a starter script containing a handler for each of |
| 427 | the event types in the trace file; it simply prints every available | 427 | the event types in the trace file; it simply prints every available |
| @@ -430,13 +430,13 @@ field for each event in the trace file. | |||
| 430 | You can also look at the existing scripts in | 430 | You can also look at the existing scripts in |
| 431 | ~/libexec/perf-core/scripts/python for typical examples showing how to | 431 | ~/libexec/perf-core/scripts/python for typical examples showing how to |
| 432 | do basic things like aggregate event data, print results, etc. Also, | 432 | do basic things like aggregate event data, print results, etc. Also, |
| 433 | the check-perf-trace.py script, while not interesting for its results, | 433 | the check-perf-script.py script, while not interesting for its results, |
| 434 | attempts to exercise all of the main scripting features. | 434 | attempts to exercise all of the main scripting features. |
| 435 | 435 | ||
| 436 | EVENT HANDLERS | 436 | EVENT HANDLERS |
| 437 | -------------- | 437 | -------------- |
| 438 | 438 | ||
| 439 | When perf trace is invoked using a trace script, a user-defined | 439 | When perf script is invoked using a trace script, a user-defined |
| 440 | 'handler function' is called for each event in the trace. If there's | 440 | 'handler function' is called for each event in the trace. If there's |
| 441 | no handler function defined for a given event type, the event is | 441 | no handler function defined for a given event type, the event is |
| 442 | ignored (or passed to a 'trace_handled' function, see below) and the | 442 | ignored (or passed to a 'trace_handled' function, see below) and the |
| @@ -510,7 +510,7 @@ write a useful trace script. The sections below cover the rest. | |||
| 510 | SCRIPT LAYOUT | 510 | SCRIPT LAYOUT |
| 511 | ------------- | 511 | ------------- |
| 512 | 512 | ||
| 513 | Every perf trace Python script should start by setting up a Python | 513 | Every perf script Python script should start by setting up a Python |
| 514 | module search path and 'import'ing a few support modules (see module | 514 | module search path and 'import'ing a few support modules (see module |
| 515 | descriptions below): | 515 | descriptions below): |
| 516 | 516 | ||
| @@ -519,7 +519,7 @@ descriptions below): | |||
| 519 | import sys | 519 | import sys |
| 520 | 520 | ||
| 521 | sys.path.append(os.environ['PERF_EXEC_PATH'] + \ | 521 | sys.path.append(os.environ['PERF_EXEC_PATH'] + \ |
| 522 | '/scripts/python/Perf-Trace-Util/lib/Perf/Trace') | 522 | '/scripts/python/perf-script-Util/lib/Perf/Trace') |
| 523 | 523 | ||
| 524 | from perf_trace_context import * | 524 | from perf_trace_context import * |
| 525 | from Core import * | 525 | from Core import * |
| @@ -559,15 +559,15 @@ def trace_unhandled(event_name, context, common_cpu, common_secs, | |||
| 559 | ---- | 559 | ---- |
| 560 | 560 | ||
| 561 | The remaining sections provide descriptions of each of the available | 561 | The remaining sections provide descriptions of each of the available |
| 562 | built-in perf trace Python modules and their associated functions. | 562 | built-in perf script Python modules and their associated functions. |
| 563 | 563 | ||
| 564 | AVAILABLE MODULES AND FUNCTIONS | 564 | AVAILABLE MODULES AND FUNCTIONS |
| 565 | ------------------------------- | 565 | ------------------------------- |
| 566 | 566 | ||
| 567 | The following sections describe the functions and variables available | 567 | The following sections describe the functions and variables available |
| 568 | via the various perf trace Python modules. To use the functions and | 568 | via the various perf script Python modules. To use the functions and |
| 569 | variables from the given module, add the corresponding 'from XXXX | 569 | variables from the given module, add the corresponding 'from XXXX |
| 570 | import' line to your perf trace script. | 570 | import' line to your perf script script. |
| 571 | 571 | ||
| 572 | Core.py Module | 572 | Core.py Module |
| 573 | ~~~~~~~~~~~~~~ | 573 | ~~~~~~~~~~~~~~ |
| @@ -610,7 +610,7 @@ argument. | |||
| 610 | Util.py Module | 610 | Util.py Module |
| 611 | ~~~~~~~~~~~~~~ | 611 | ~~~~~~~~~~~~~~ |
| 612 | 612 | ||
| 613 | Various utility functions for use with perf trace: | 613 | Various utility functions for use with perf script: |
| 614 | 614 | ||
| 615 | nsecs(secs, nsecs) - returns total nsecs given secs/nsecs pair | 615 | nsecs(secs, nsecs) - returns total nsecs given secs/nsecs pair |
| 616 | nsecs_secs(nsecs) - returns whole secs portion given nsecs | 616 | nsecs_secs(nsecs) - returns whole secs portion given nsecs |
| @@ -620,4 +620,4 @@ Various utility functions for use with perf trace: | |||
| 620 | 620 | ||
| 621 | SEE ALSO | 621 | SEE ALSO |
| 622 | -------- | 622 | -------- |
| 623 | linkperf:perf-trace[1] | 623 | linkperf:perf-script[1] |
diff --git a/tools/perf/Documentation/perf-trace.txt b/tools/perf/Documentation/perf-script.txt index 1c61ea99b74a..29ad94293cd2 100644 --- a/tools/perf/Documentation/perf-trace.txt +++ b/tools/perf/Documentation/perf-script.txt | |||
| @@ -1,71 +1,71 @@ | |||
| 1 | perf-trace(1) | 1 | perf-script(1) |
| 2 | ============= | 2 | ============= |
| 3 | 3 | ||
| 4 | NAME | 4 | NAME |
| 5 | ---- | 5 | ---- |
| 6 | perf-trace - Read perf.data (created by perf record) and display trace output | 6 | perf-script - Read perf.data (created by perf record) and display trace output |
| 7 | 7 | ||
| 8 | SYNOPSIS | 8 | SYNOPSIS |
| 9 | -------- | 9 | -------- |
| 10 | [verse] | 10 | [verse] |
| 11 | 'perf trace' [<options>] | 11 | 'perf script' [<options>] |
| 12 | 'perf trace' [<options>] record <script> [<record-options>] <command> | 12 | 'perf script' [<options>] record <script> [<record-options>] <command> |
| 13 | 'perf trace' [<options>] report <script> [script-args] | 13 | 'perf script' [<options>] report <script> [script-args] |
| 14 | 'perf trace' [<options>] <script> <required-script-args> [<record-options>] <command> | 14 | 'perf script' [<options>] <script> <required-script-args> [<record-options>] <command> |
| 15 | 'perf trace' [<options>] <top-script> [script-args] | 15 | 'perf script' [<options>] <top-script> [script-args] |
| 16 | 16 | ||
| 17 | DESCRIPTION | 17 | DESCRIPTION |
| 18 | ----------- | 18 | ----------- |
| 19 | This command reads the input file and displays the trace recorded. | 19 | This command reads the input file and displays the trace recorded. |
| 20 | 20 | ||
| 21 | There are several variants of perf trace: | 21 | There are several variants of perf script: |
| 22 | 22 | ||
| 23 | 'perf trace' to see a detailed trace of the workload that was | 23 | 'perf script' to see a detailed trace of the workload that was |
| 24 | recorded. | 24 | recorded. |
| 25 | 25 | ||
| 26 | You can also run a set of pre-canned scripts that aggregate and | 26 | You can also run a set of pre-canned scripts that aggregate and |
| 27 | summarize the raw trace data in various ways (the list of scripts is | 27 | summarize the raw trace data in various ways (the list of scripts is |
| 28 | available via 'perf trace -l'). The following variants allow you to | 28 | available via 'perf script -l'). The following variants allow you to |
| 29 | record and run those scripts: | 29 | record and run those scripts: |
| 30 | 30 | ||
| 31 | 'perf trace record <script> <command>' to record the events required | 31 | 'perf script record <script> <command>' to record the events required |
| 32 | for 'perf trace report'. <script> is the name displayed in the | 32 | for 'perf script report'. <script> is the name displayed in the |
| 33 | output of 'perf trace --list' i.e. the actual script name minus any | 33 | output of 'perf script --list' i.e. the actual script name minus any |
| 34 | language extension. If <command> is not specified, the events are | 34 | language extension. If <command> is not specified, the events are |
| 35 | recorded using the -a (system-wide) 'perf record' option. | 35 | recorded using the -a (system-wide) 'perf record' option. |
| 36 | 36 | ||
| 37 | 'perf trace report <script> [args]' to run and display the results | 37 | 'perf script report <script> [args]' to run and display the results |
| 38 | of <script>. <script> is the name displayed in the output of 'perf | 38 | of <script>. <script> is the name displayed in the output of 'perf |
| 39 | trace --list' i.e. the actual script name minus any language | 39 | trace --list' i.e. the actual script name minus any language |
| 40 | extension. The perf.data output from a previous run of 'perf trace | 40 | extension. The perf.data output from a previous run of 'perf script |
| 41 | record <script>' is used and should be present for this command to | 41 | record <script>' is used and should be present for this command to |
| 42 | succeed. [args] refers to the (mainly optional) args expected by | 42 | succeed. [args] refers to the (mainly optional) args expected by |
| 43 | the script. | 43 | the script. |
| 44 | 44 | ||
| 45 | 'perf trace <script> <required-script-args> <command>' to both | 45 | 'perf script <script> <required-script-args> <command>' to both |
| 46 | record the events required for <script> and to run the <script> | 46 | record the events required for <script> and to run the <script> |
| 47 | using 'live-mode' i.e. without writing anything to disk. <script> | 47 | using 'live-mode' i.e. without writing anything to disk. <script> |
| 48 | is the name displayed in the output of 'perf trace --list' i.e. the | 48 | is the name displayed in the output of 'perf script --list' i.e. the |
| 49 | actual script name minus any language extension. If <command> is | 49 | actual script name minus any language extension. If <command> is |
| 50 | not specified, the events are recorded using the -a (system-wide) | 50 | not specified, the events are recorded using the -a (system-wide) |
| 51 | 'perf record' option. If <script> has any required args, they | 51 | 'perf record' option. If <script> has any required args, they |
| 52 | should be specified before <command>. This mode doesn't allow for | 52 | should be specified before <command>. This mode doesn't allow for |
| 53 | optional script args to be specified; if optional script args are | 53 | optional script args to be specified; if optional script args are |
| 54 | desired, they can be specified using separate 'perf trace record' | 54 | desired, they can be specified using separate 'perf script record' |
| 55 | and 'perf trace report' commands, with the stdout of the record step | 55 | and 'perf script report' commands, with the stdout of the record step |
| 56 | piped to the stdin of the report script, using the '-o -' and '-i -' | 56 | piped to the stdin of the report script, using the '-o -' and '-i -' |
| 57 | options of the corresponding commands. | 57 | options of the corresponding commands. |
| 58 | 58 | ||
| 59 | 'perf trace <top-script>' to both record the events required for | 59 | 'perf script <top-script>' to both record the events required for |
| 60 | <top-script> and to run the <top-script> using 'live-mode' | 60 | <top-script> and to run the <top-script> using 'live-mode' |
| 61 | i.e. without writing anything to disk. <top-script> is the name | 61 | i.e. without writing anything to disk. <top-script> is the name |
| 62 | displayed in the output of 'perf trace --list' i.e. the actual | 62 | displayed in the output of 'perf script --list' i.e. the actual |
| 63 | script name minus any language extension; a <top-script> is defined | 63 | script name minus any language extension; a <top-script> is defined |
| 64 | as any script name ending with the string 'top'. | 64 | as any script name ending with the string 'top'. |
| 65 | 65 | ||
| 66 | [<record-options>] can be passed to the record steps of 'perf trace | 66 | [<record-options>] can be passed to the record steps of 'perf script |
| 67 | record' and 'live-mode' variants; this isn't possible however for | 67 | record' and 'live-mode' variants; this isn't possible however for |
| 68 | <top-script> 'live-mode' or 'perf trace report' variants. | 68 | <top-script> 'live-mode' or 'perf script report' variants. |
| 69 | 69 | ||
| 70 | See the 'SEE ALSO' section for links to language-specific | 70 | See the 'SEE ALSO' section for links to language-specific |
| 71 | information on how to write and run your own trace scripts. | 71 | information on how to write and run your own trace scripts. |
| @@ -76,7 +76,7 @@ OPTIONS | |||
| 76 | Any command you can specify in a shell. | 76 | Any command you can specify in a shell. |
| 77 | 77 | ||
| 78 | -D:: | 78 | -D:: |
| 79 | --dump-raw-trace=:: | 79 | --dump-raw-script=:: |
| 80 | Display verbose dump of the trace data. | 80 | Display verbose dump of the trace data. |
| 81 | 81 | ||
| 82 | -L:: | 82 | -L:: |
| @@ -95,7 +95,7 @@ OPTIONS | |||
| 95 | 95 | ||
| 96 | -g:: | 96 | -g:: |
| 97 | --gen-script=:: | 97 | --gen-script=:: |
| 98 | Generate perf-trace.[ext] starter script for given language, | 98 | Generate perf-script.[ext] starter script for given language, |
| 99 | using current perf.data. | 99 | using current perf.data. |
| 100 | 100 | ||
| 101 | -a:: | 101 | -a:: |
| @@ -114,5 +114,5 @@ OPTIONS | |||
| 114 | 114 | ||
| 115 | SEE ALSO | 115 | SEE ALSO |
| 116 | -------- | 116 | -------- |
| 117 | linkperf:perf-record[1], linkperf:perf-trace-perl[1], | 117 | linkperf:perf-record[1], linkperf:perf-script-perl[1], |
| 118 | linkperf:perf-trace-python[1] | 118 | linkperf:perf-script-python[1] |
diff --git a/tools/perf/Makefile b/tools/perf/Makefile index e0db1978c858..d88137a4356e 100644 --- a/tools/perf/Makefile +++ b/tools/perf/Makefile | |||
| @@ -495,7 +495,7 @@ BUILTIN_OBJS += $(OUTPUT)builtin-report.o | |||
| 495 | BUILTIN_OBJS += $(OUTPUT)builtin-stat.o | 495 | BUILTIN_OBJS += $(OUTPUT)builtin-stat.o |
| 496 | BUILTIN_OBJS += $(OUTPUT)builtin-timechart.o | 496 | BUILTIN_OBJS += $(OUTPUT)builtin-timechart.o |
| 497 | BUILTIN_OBJS += $(OUTPUT)builtin-top.o | 497 | BUILTIN_OBJS += $(OUTPUT)builtin-top.o |
| 498 | BUILTIN_OBJS += $(OUTPUT)builtin-trace.o | 498 | BUILTIN_OBJS += $(OUTPUT)builtin-script.o |
| 499 | BUILTIN_OBJS += $(OUTPUT)builtin-probe.o | 499 | BUILTIN_OBJS += $(OUTPUT)builtin-probe.o |
| 500 | BUILTIN_OBJS += $(OUTPUT)builtin-kmem.o | 500 | BUILTIN_OBJS += $(OUTPUT)builtin-kmem.o |
| 501 | BUILTIN_OBJS += $(OUTPUT)builtin-lock.o | 501 | BUILTIN_OBJS += $(OUTPUT)builtin-lock.o |
diff --git a/tools/perf/builtin-lock.c b/tools/perf/builtin-lock.c index 821c1586a22b..8452a2ae2191 100644 --- a/tools/perf/builtin-lock.c +++ b/tools/perf/builtin-lock.c | |||
| @@ -982,9 +982,9 @@ int cmd_lock(int argc, const char **argv, const char *prefix __used) | |||
| 982 | usage_with_options(report_usage, report_options); | 982 | usage_with_options(report_usage, report_options); |
| 983 | } | 983 | } |
| 984 | __cmd_report(); | 984 | __cmd_report(); |
| 985 | } else if (!strcmp(argv[0], "trace")) { | 985 | } else if (!strcmp(argv[0], "script")) { |
| 986 | /* Aliased to 'perf trace' */ | 986 | /* Aliased to 'perf script' */ |
| 987 | return cmd_trace(argc, argv, prefix); | 987 | return cmd_script(argc, argv, prefix); |
| 988 | } else if (!strcmp(argv[0], "info")) { | 988 | } else if (!strcmp(argv[0], "info")) { |
| 989 | if (argc) { | 989 | if (argc) { |
| 990 | argc = parse_options(argc, argv, | 990 | argc = parse_options(argc, argv, |
diff --git a/tools/perf/builtin-sched.c b/tools/perf/builtin-sched.c index 55f3b5dcc731..26523c939791 100644 --- a/tools/perf/builtin-sched.c +++ b/tools/perf/builtin-sched.c | |||
| @@ -1888,10 +1888,10 @@ int cmd_sched(int argc, const char **argv, const char *prefix __used) | |||
| 1888 | usage_with_options(sched_usage, sched_options); | 1888 | usage_with_options(sched_usage, sched_options); |
| 1889 | 1889 | ||
| 1890 | /* | 1890 | /* |
| 1891 | * Aliased to 'perf trace' for now: | 1891 | * Aliased to 'perf script' for now: |
| 1892 | */ | 1892 | */ |
| 1893 | if (!strcmp(argv[0], "trace")) | 1893 | if (!strcmp(argv[0], "script")) |
| 1894 | return cmd_trace(argc, argv, prefix); | 1894 | return cmd_script(argc, argv, prefix); |
| 1895 | 1895 | ||
| 1896 | symbol__init(); | 1896 | symbol__init(); |
| 1897 | if (!strncmp(argv[0], "rec", 3)) { | 1897 | if (!strncmp(argv[0], "rec", 3)) { |
diff --git a/tools/perf/builtin-trace.c b/tools/perf/builtin-script.c index 4783ed8bd657..4539551ab40e 100644 --- a/tools/perf/builtin-trace.c +++ b/tools/perf/builtin-script.c | |||
| @@ -56,7 +56,7 @@ static void setup_scripting(void) | |||
| 56 | 56 | ||
| 57 | static int cleanup_scripting(void) | 57 | static int cleanup_scripting(void) |
| 58 | { | 58 | { |
| 59 | pr_debug("\nperf trace script stopped\n"); | 59 | pr_debug("\nperf script stopped\n"); |
| 60 | 60 | ||
| 61 | return scripting_ops->stop_script(); | 61 | return scripting_ops->stop_script(); |
| 62 | } | 62 | } |
| @@ -137,7 +137,7 @@ static void sig_handler(int sig __unused) | |||
| 137 | session_done = 1; | 137 | session_done = 1; |
| 138 | } | 138 | } |
| 139 | 139 | ||
| 140 | static int __cmd_trace(struct perf_session *session) | 140 | static int __cmd_script(struct perf_session *session) |
| 141 | { | 141 | { |
| 142 | int ret; | 142 | int ret; |
| 143 | 143 | ||
| @@ -247,7 +247,7 @@ static void list_available_languages(void) | |||
| 247 | 247 | ||
| 248 | fprintf(stderr, "\n"); | 248 | fprintf(stderr, "\n"); |
| 249 | fprintf(stderr, "Scripting language extensions (used in " | 249 | fprintf(stderr, "Scripting language extensions (used in " |
| 250 | "perf trace -s [spec:]script.[spec]):\n\n"); | 250 | "perf script -s [spec:]script.[spec]):\n\n"); |
| 251 | 251 | ||
| 252 | list_for_each_entry(s, &script_specs, node) | 252 | list_for_each_entry(s, &script_specs, node) |
| 253 | fprintf(stderr, " %-42s [%s]\n", s->spec, s->ops->name); | 253 | fprintf(stderr, " %-42s [%s]\n", s->spec, s->ops->name); |
| @@ -586,12 +586,12 @@ out: | |||
| 586 | return n_args; | 586 | return n_args; |
| 587 | } | 587 | } |
| 588 | 588 | ||
| 589 | static const char * const trace_usage[] = { | 589 | static const char * const script_usage[] = { |
| 590 | "perf trace [<options>]", | 590 | "perf script [<options>]", |
| 591 | "perf trace [<options>] record <script> [<record-options>] <command>", | 591 | "perf script [<options>] record <script> [<record-options>] <command>", |
| 592 | "perf trace [<options>] report <script> [script-args]", | 592 | "perf script [<options>] report <script> [script-args]", |
| 593 | "perf trace [<options>] <script> [<record-options>] <command>", | 593 | "perf script [<options>] <script> [<record-options>] <command>", |
| 594 | "perf trace [<options>] <top-script> [script-args]", | 594 | "perf script [<options>] <top-script> [script-args]", |
| 595 | NULL | 595 | NULL |
| 596 | }; | 596 | }; |
| 597 | 597 | ||
| @@ -608,7 +608,7 @@ static const struct option options[] = { | |||
| 608 | "script file name (lang:script name, script name, or *)", | 608 | "script file name (lang:script name, script name, or *)", |
| 609 | parse_scriptname), | 609 | parse_scriptname), |
| 610 | OPT_STRING('g', "gen-script", &generate_script_lang, "lang", | 610 | OPT_STRING('g', "gen-script", &generate_script_lang, "lang", |
| 611 | "generate perf-trace.xx script in specified language"), | 611 | "generate perf-script.xx script in specified language"), |
| 612 | OPT_STRING('i', "input", &input_name, "file", | 612 | OPT_STRING('i', "input", &input_name, "file", |
| 613 | "input file name"), | 613 | "input file name"), |
| 614 | OPT_BOOLEAN('d', "debug-mode", &debug_mode, | 614 | OPT_BOOLEAN('d', "debug-mode", &debug_mode, |
| @@ -631,7 +631,7 @@ static bool have_cmd(int argc, const char **argv) | |||
| 631 | return argc != 0; | 631 | return argc != 0; |
| 632 | } | 632 | } |
| 633 | 633 | ||
| 634 | int cmd_trace(int argc, const char **argv, const char *prefix __used) | 634 | int cmd_script(int argc, const char **argv, const char *prefix __used) |
| 635 | { | 635 | { |
| 636 | char *rec_script_path = NULL; | 636 | char *rec_script_path = NULL; |
| 637 | char *rep_script_path = NULL; | 637 | char *rep_script_path = NULL; |
| @@ -643,7 +643,7 @@ int cmd_trace(int argc, const char **argv, const char *prefix __used) | |||
| 643 | 643 | ||
| 644 | setup_scripting(); | 644 | setup_scripting(); |
| 645 | 645 | ||
| 646 | argc = parse_options(argc, argv, options, trace_usage, | 646 | argc = parse_options(argc, argv, options, script_usage, |
| 647 | PARSE_OPT_STOP_AT_NON_OPTION); | 647 | PARSE_OPT_STOP_AT_NON_OPTION); |
| 648 | 648 | ||
| 649 | if (argc > 1 && !strncmp(argv[0], "rec", strlen("rec"))) { | 649 | if (argc > 1 && !strncmp(argv[0], "rec", strlen("rec"))) { |
| @@ -657,7 +657,7 @@ int cmd_trace(int argc, const char **argv, const char *prefix __used) | |||
| 657 | if (!rep_script_path) { | 657 | if (!rep_script_path) { |
| 658 | fprintf(stderr, | 658 | fprintf(stderr, |
| 659 | "Please specify a valid report script" | 659 | "Please specify a valid report script" |
| 660 | "(see 'perf trace -l' for listing)\n"); | 660 | "(see 'perf script -l' for listing)\n"); |
| 661 | return -1; | 661 | return -1; |
| 662 | } | 662 | } |
| 663 | } | 663 | } |
| @@ -675,8 +675,8 @@ int cmd_trace(int argc, const char **argv, const char *prefix __used) | |||
| 675 | 675 | ||
| 676 | if (!rec_script_path && !rep_script_path) { | 676 | if (!rec_script_path && !rep_script_path) { |
| 677 | fprintf(stderr, " Couldn't find script %s\n\n See perf" | 677 | fprintf(stderr, " Couldn't find script %s\n\n See perf" |
| 678 | " trace -l for available scripts.\n", argv[0]); | 678 | " script -l for available scripts.\n", argv[0]); |
| 679 | usage_with_options(trace_usage, options); | 679 | usage_with_options(script_usage, options); |
| 680 | } | 680 | } |
| 681 | 681 | ||
| 682 | if (is_top_script(argv[0])) { | 682 | if (is_top_script(argv[0])) { |
| @@ -688,9 +688,9 @@ int cmd_trace(int argc, const char **argv, const char *prefix __used) | |||
| 688 | rec_args = (argc - 1) - rep_args; | 688 | rec_args = (argc - 1) - rep_args; |
| 689 | if (rec_args < 0) { | 689 | if (rec_args < 0) { |
| 690 | fprintf(stderr, " %s script requires options." | 690 | fprintf(stderr, " %s script requires options." |
| 691 | "\n\n See perf trace -l for available " | 691 | "\n\n See perf script -l for available " |
| 692 | "scripts and options.\n", argv[0]); | 692 | "scripts and options.\n", argv[0]); |
| 693 | usage_with_options(trace_usage, options); | 693 | usage_with_options(script_usage, options); |
| 694 | } | 694 | } |
| 695 | } | 695 | } |
| 696 | 696 | ||
| @@ -823,7 +823,7 @@ int cmd_trace(int argc, const char **argv, const char *prefix __used) | |||
| 823 | return -1; | 823 | return -1; |
| 824 | } | 824 | } |
| 825 | 825 | ||
| 826 | err = scripting_ops->generate_script("perf-trace"); | 826 | err = scripting_ops->generate_script("perf-script"); |
| 827 | goto out; | 827 | goto out; |
| 828 | } | 828 | } |
| 829 | 829 | ||
| @@ -831,10 +831,10 @@ int cmd_trace(int argc, const char **argv, const char *prefix __used) | |||
| 831 | err = scripting_ops->start_script(script_name, argc, argv); | 831 | err = scripting_ops->start_script(script_name, argc, argv); |
| 832 | if (err) | 832 | if (err) |
| 833 | goto out; | 833 | goto out; |
| 834 | pr_debug("perf trace started with script %s\n\n", script_name); | 834 | pr_debug("perf script started with script %s\n\n", script_name); |
| 835 | } | 835 | } |
| 836 | 836 | ||
| 837 | err = __cmd_trace(session); | 837 | err = __cmd_script(session); |
| 838 | 838 | ||
| 839 | perf_session__delete(session); | 839 | perf_session__delete(session); |
| 840 | cleanup_scripting(); | 840 | cleanup_scripting(); |
diff --git a/tools/perf/builtin.h b/tools/perf/builtin.h index 921245b28583..c7798c7f24ed 100644 --- a/tools/perf/builtin.h +++ b/tools/perf/builtin.h | |||
| @@ -27,7 +27,7 @@ extern int cmd_report(int argc, const char **argv, const char *prefix); | |||
| 27 | extern int cmd_stat(int argc, const char **argv, const char *prefix); | 27 | extern int cmd_stat(int argc, const char **argv, const char *prefix); |
| 28 | extern int cmd_timechart(int argc, const char **argv, const char *prefix); | 28 | extern int cmd_timechart(int argc, const char **argv, const char *prefix); |
| 29 | extern int cmd_top(int argc, const char **argv, const char *prefix); | 29 | extern int cmd_top(int argc, const char **argv, const char *prefix); |
| 30 | extern int cmd_trace(int argc, const char **argv, const char *prefix); | 30 | extern int cmd_script(int argc, const char **argv, const char *prefix); |
| 31 | extern int cmd_version(int argc, const char **argv, const char *prefix); | 31 | extern int cmd_version(int argc, const char **argv, const char *prefix); |
| 32 | extern int cmd_probe(int argc, const char **argv, const char *prefix); | 32 | extern int cmd_probe(int argc, const char **argv, const char *prefix); |
| 33 | extern int cmd_kmem(int argc, const char **argv, const char *prefix); | 33 | extern int cmd_kmem(int argc, const char **argv, const char *prefix); |
diff --git a/tools/perf/command-list.txt b/tools/perf/command-list.txt index 949d77fc0b97..16b5088cf8f4 100644 --- a/tools/perf/command-list.txt +++ b/tools/perf/command-list.txt | |||
| @@ -16,7 +16,7 @@ perf-report mainporcelain common | |||
| 16 | perf-stat mainporcelain common | 16 | perf-stat mainporcelain common |
| 17 | perf-timechart mainporcelain common | 17 | perf-timechart mainporcelain common |
| 18 | perf-top mainporcelain common | 18 | perf-top mainporcelain common |
| 19 | perf-trace mainporcelain common | 19 | perf-script mainporcelain common |
| 20 | perf-probe mainporcelain common | 20 | perf-probe mainporcelain common |
| 21 | perf-kmem mainporcelain common | 21 | perf-kmem mainporcelain common |
| 22 | perf-lock mainporcelain common | 22 | perf-lock mainporcelain common |
diff --git a/tools/perf/perf.c b/tools/perf/perf.c index cdd6c03f1e14..595d0f4a7103 100644 --- a/tools/perf/perf.c +++ b/tools/perf/perf.c | |||
| @@ -323,7 +323,7 @@ static void handle_internal_command(int argc, const char **argv) | |||
| 323 | { "top", cmd_top, 0 }, | 323 | { "top", cmd_top, 0 }, |
| 324 | { "annotate", cmd_annotate, 0 }, | 324 | { "annotate", cmd_annotate, 0 }, |
| 325 | { "version", cmd_version, 0 }, | 325 | { "version", cmd_version, 0 }, |
| 326 | { "trace", cmd_trace, 0 }, | 326 | { "script", cmd_script, 0 }, |
| 327 | { "sched", cmd_sched, 0 }, | 327 | { "sched", cmd_sched, 0 }, |
| 328 | { "probe", cmd_probe, 0 }, | 328 | { "probe", cmd_probe, 0 }, |
| 329 | { "kmem", cmd_kmem, 0 }, | 329 | { "kmem", cmd_kmem, 0 }, |
diff --git a/tools/perf/scripts/python/Perf-Trace-Util/Context.c b/tools/perf/scripts/python/Perf-Trace-Util/Context.c index 957085dd5d8d..315067b8f552 100644 --- a/tools/perf/scripts/python/Perf-Trace-Util/Context.c +++ b/tools/perf/scripts/python/Perf-Trace-Util/Context.c | |||
| @@ -1,5 +1,5 @@ | |||
| 1 | /* | 1 | /* |
| 2 | * Context.c. Python interfaces for perf trace. | 2 | * Context.c. Python interfaces for perf script. |
| 3 | * | 3 | * |
| 4 | * Copyright (C) 2010 Tom Zanussi <tzanussi@gmail.com> | 4 | * Copyright (C) 2010 Tom Zanussi <tzanussi@gmail.com> |
| 5 | * | 5 | * |
diff --git a/tools/perf/util/scripting-engines/trace-event-perl.c b/tools/perf/util/scripting-engines/trace-event-perl.c index b059dc50cc2d..93680818e244 100644 --- a/tools/perf/util/scripting-engines/trace-event-perl.c +++ b/tools/perf/util/scripting-engines/trace-event-perl.c | |||
| @@ -1,5 +1,5 @@ | |||
| 1 | /* | 1 | /* |
| 2 | * trace-event-perl. Feed perf trace events to an embedded Perl interpreter. | 2 | * trace-event-perl. Feed perf script events to an embedded Perl interpreter. |
| 3 | * | 3 | * |
| 4 | * Copyright (C) 2009 Tom Zanussi <tzanussi@gmail.com> | 4 | * Copyright (C) 2009 Tom Zanussi <tzanussi@gmail.com> |
| 5 | * | 5 | * |
| @@ -411,8 +411,8 @@ static int perl_generate_script(const char *outfile) | |||
| 411 | return -1; | 411 | return -1; |
| 412 | } | 412 | } |
| 413 | 413 | ||
| 414 | fprintf(ofp, "# perf trace event handlers, " | 414 | fprintf(ofp, "# perf script event handlers, " |
| 415 | "generated by perf trace -g perl\n"); | 415 | "generated by perf script -g perl\n"); |
| 416 | 416 | ||
| 417 | fprintf(ofp, "# Licensed under the terms of the GNU GPL" | 417 | fprintf(ofp, "# Licensed under the terms of the GNU GPL" |
| 418 | " License version 2\n\n"); | 418 | " License version 2\n\n"); |
diff --git a/tools/perf/util/scripting-engines/trace-event-python.c b/tools/perf/util/scripting-engines/trace-event-python.c index 33a632523743..c6d99334bdfa 100644 --- a/tools/perf/util/scripting-engines/trace-event-python.c +++ b/tools/perf/util/scripting-engines/trace-event-python.c | |||
| @@ -442,8 +442,8 @@ static int python_generate_script(const char *outfile) | |||
| 442 | fprintf(stderr, "couldn't open %s\n", fname); | 442 | fprintf(stderr, "couldn't open %s\n", fname); |
| 443 | return -1; | 443 | return -1; |
| 444 | } | 444 | } |
| 445 | fprintf(ofp, "# perf trace event handlers, " | 445 | fprintf(ofp, "# perf script event handlers, " |
| 446 | "generated by perf trace -g python\n"); | 446 | "generated by perf script -g python\n"); |
| 447 | 447 | ||
| 448 | fprintf(ofp, "# Licensed under the terms of the GNU GPL" | 448 | fprintf(ofp, "# Licensed under the terms of the GNU GPL" |
| 449 | " License version 2\n\n"); | 449 | " License version 2\n\n"); |
