60 lines · plain
1Perf-Trace-Util version 0.012============================3 4This module contains utility functions for use with perf script.5 6Core.pm and Util.pm are pure Perl modules; Core.pm contains routines7that the core perf support for Perl calls on and should always be8'used', while Util.pm contains useful but optional utility functions9that scripts may want to use. Context.pm contains the Perl->C10interface that allows scripts to access data in the embedding perf11executable; scripts wishing to do that should 'use Context.pm'.12 13The Perl->C perf interface is completely driven by Context.xs. If you14want to add new Perl functions that end up accessing C data in the15perf executable, you add desciptions of the new functions here.16scripting_context is a pointer to the perf data in the perf executable17that you want to access - it's passed as the second parameter,18$context, to all handler functions.19 20After you do that:21 22 perl Makefile.PL # to create a Makefile for the next step23 make # to create Context.c24 25 edit Context.c to add const to the char* file = __FILE__ line in26 XS(boot_Perf__Trace__Context) to silence a warning/error.27 28 You can delete the Makefile, object files and anything else that was29 generated e.g. blib and shared library, etc, except for of course30 Context.c31 32 You should then be able to run the normal perf make as usual.33 34INSTALLATION35 36Building perf with perf script Perl scripting should install this37module in the right place.38 39You should make sure libperl and ExtUtils/Embed.pm are installed first40e.g. apt-get install libperl-dev or yum install perl-ExtUtils-Embed.41 42DEPENDENCIES43 44This module requires these other modules and libraries:45 46 None47 48COPYRIGHT AND LICENCE49 50Copyright (C) 2009 by Tom Zanussi <tzanussi@gmail.com>51 52This library is free software; you can redistribute it and/or modify53it under the same terms as Perl itself, either Perl version 5.10.0 or,54at your option, any later version of Perl 5 you may have available.55 56Alternatively, this software may be distributed under the terms of the57GNU General Public License ("GPL") version 2 as published by the Free58Software Foundation.59 60