perf/Documentation/perf-script-perl.txt

1 perf-script-perl(1)
6 perf-script-perl - Process trace data with a Perl script
11 'perf script' [-s [Perl]:script[.pl] ]
16 This perf script option is used to process perf script data using perf's
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.
31 ~/libexec/perf-core/scripts/perl for typical examples showing how to
33 the check-perf-script.pl script, while not interesting for its results,
39 When perf script is invoked using a trace script, a user-defined
47 available as calls back into the perf executable (see below).
49 As an example, the following perf record command can be used to record
52  # perf record -a -e sched:sched_wakeup
96  $context		    an opaque 'cookie' used in calls back into perf
114 Every perf script Perl script should start by setting up a Perl module
119  use lib "$ENV{'PERF_EXEC_PATH'}/scripts/perl/Perf-Trace-Util/lib";
120  use lib "./Perf-Trace-Util/lib";
121  use Perf::Trace::Core;
122  use Perf::Trace::Context;
123  use Perf::Trace::Util;
164 built-in perf script Perl modules and their associated functions.
170 via the various Perf::Trace::* Perl modules.  To use the functions and
172 Perf::Trace::XXX' line to your perf script script.
174 Perf::Trace::Core Module
187 Perf::Trace::Context Module
193 Perf::Trace::Context defines a set of functions that can be used to
203 Perf::Trace::Util Module
206 Various utility functions for use with perf script:
216 linkperf:perf-script[1]