0001 Perf-Trace-Util version 0.01
0002 ============================
0003
0004 This module contains utility functions for use with perf script.
0005
0006 Core.pm and Util.pm are pure Perl modules; Core.pm contains routines
0007 that the core perf support for Perl calls on and should always be
0008 'used', while Util.pm contains useful but optional utility functions
0009 that scripts may want to use. Context.pm contains the Perl->C
0010 interface that allows scripts to access data in the embedding perf
0011 executable; scripts wishing to do that should 'use Context.pm'.
0012
0013 The Perl->C perf interface is completely driven by Context.xs. If you
0014 want to add new Perl functions that end up accessing C data in the
0015 perf executable, you add desciptions of the new functions here.
0016 scripting_context is a pointer to the perf data in the perf executable
0017 that you want to access - it's passed as the second parameter,
0018 $context, to all handler functions.
0019
0020 After you do that:
0021
0022 perl Makefile.PL # to create a Makefile for the next step
0023 make # to create Context.c
0024
0025 edit Context.c to add const to the char* file = __FILE__ line in
0026 XS(boot_Perf__Trace__Context) to silence a warning/error.
0027
0028 You can delete the Makefile, object files and anything else that was
0029 generated e.g. blib and shared library, etc, except for of course
0030 Context.c
0031
0032 You should then be able to run the normal perf make as usual.
0033
0034 INSTALLATION
0035
0036 Building perf with perf script Perl scripting should install this
0037 module in the right place.
0038
0039 You should make sure libperl and ExtUtils/Embed.pm are installed first
0040 e.g. apt-get install libperl-dev or yum install perl-ExtUtils-Embed.
0041
0042 DEPENDENCIES
0043
0044 This module requires these other modules and libraries:
0045
0046 None
0047
0048 COPYRIGHT AND LICENCE
0049
0050 Copyright (C) 2009 by Tom Zanussi <tzanussi@gmail.com>
0051
0052 This library is free software; you can redistribute it and/or modify
0053 it under the same terms as Perl itself, either Perl version 5.10.0 or,
0054 at your option, any later version of Perl 5 you may have available.
0055
0056 Alternatively, this software may be distributed under the terms of the
0057 GNU General Public License ("GPL") version 2 as published by the Free
0058 Software Foundation.
0059
