NAME¶
eztrace_create_plugin - creates an EZTrace plugin
SYNOPSIS¶
eztrace_create [OPTION] FILE
DESCRIPTION¶
Generate an EZTrace plugin
OPTIONS¶
- -I <incdir1,incdir2,...,
--include_dir=<incdir1,incdir2,...>>
- Add specific include directories for the compilation of the generated
code.
- -o <dir, --output=<dir>>
- Select the output directory.
- -h --help
- Print a brief help message and exits.
EXAMPLES¶
eztrace_create_plugin generates the source code of an EZTrace plugin described
by a template file. The template file has to be structure as follows:
--- foo.tpl
BEGIN_MODULE
NAME example_lib
DESC "module for the example library"
LANGUAGE C
ID 99
int foo(int n)
BEGIN
EVENT("Do function foo")
END
void bar(int n)
BEGIN
RECORD_STATE("running function bar")
END
END_MODULE
--- end of foo.tpl
Passing foo.tpl to eztrace_create_plugin will result in a directory (default:
output) that contains the source code of an EZTrace plugin that intercepts the
foo and bar functions. $ eztrace_create_plugin foo.tpl
New Module
Module name : 'example_lib'
Module description : '"module for the example library"'
Language : 'C'
Module id : '99'
Function 'foo' done
Function 'bar' done
End of Module example_lib
Once the generated source code is compiled, the resulting plugin can be used
with eztrace or eztrace.old:
$ cd output
$ make
$ export EZTRACE_LIBRARY_PATH=$PWD
$ eztrace_avail
3 stdio Module for stdio functions (read, write, select, poll, etc.)
2 pthread Module for PThread synchronization functions (mutex, semaphore,
spinlock, etc.)
6 papi Module for PAPI Performance counters
1 omp Module for OpenMP parallel regions
4 mpi Module for MPI functions
5 memory Module for memory functions (malloc, free, etc.)
153 example_lib module for the example library
$ eztrace -t example_lib my_application
[...]
SEE ALSO¶
eztrace_convert(1),
eztrace_stats(1),
eztrace.old(1),
eztrace_cc(1),
eztrace_avail(1),
eztrace_loaded(1),
eztrace_create_plugin(1)
REPORTING BUGS¶
Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr
EZTrace home page: <
http://eztrace.gforge.inria.fr/>
AUTHOR¶
Francois Trahay (francois.trahay@telecom-sduparis.eu)