--- /dev/null	2013-09-06 16:46:15.327715999 +0200
+++ eztrace/doc/man/eztrace.1	2013-09-06 18:00:50.000000000 +0200
@@ -0,0 +1,41 @@
+.\" Manpage for eztrace.
+.\" Contact eztrace-devel@lists.gforge.inria.fr to correct errors or typos.
+.TH man 1 "05 September 2013" "1.0" "eztrace man page"
+.SH NAME
+eztrace \- performance analysis tool
+.SH SYNOPSIS
+eztrace [OPTION] COMMAND_LINE
+.SH DESCRIPTION
+Run COMMAND_LINE and generate an execution trace.
+
+.SH OPTIONS
+.TP 5
+-t [plugin1 plugin2 ... pluginN]
+Select a list of plugins
+.TP
+-o DIRECTORY
+Select the output DIRECTORY
+.TP
+-l DIRECTORY
+Add DIRECTORY to the list of directories in which eztrace search for plugins
+.TP
+-f
+Enable EZTRACE_FLUSH
+.TP
+-d
+Debug mode
+.TP
+-?,  -h
+Display this help and exit
+.SH EXAMPLES
+$ eztrace -t "memory pthread" ./my_program param1 param2
+
+$ mpirun -np 2 eztrace -t "mpi pthread" ./my_program param1 param2
+.SH SEE ALSO
+eztrace_convert(1), eztrace_stats(1), eztrace.old(1), eztrace_cc(1), eztrace_avail(1), eztrace_loaded(1), eztrace_create_plugin(1)
+.SH REPORTING BUGS
+Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr
+.br
+EZTrace home page: <http://eztrace.gforge.inria.fr/>
+.SH AUTHOR
+Francois Trahay (francois.trahay@telecom-sduparis.eu)
--- /dev/null	2013-09-06 16:46:15.327715999 +0200
+++ eztrace/doc/man/eztrace.old.1	2013-09-06 18:00:50.000000000 +0200
@@ -0,0 +1,54 @@
+.\" Manpage for eztrace.old.
+.\" Contact eztrace-devel@lists.gforge.inria.fr to correct errors or typos.
+.TH man 1 "05 September 2013" "1.0" "eztrace.old man page"
+.SH NAME
+eztrace.old \- performance analysis tool
+.SH SYNOPSIS
+eztrace [OPTION] COMMAND_LINE
+.SH DESCRIPTION
+Run COMMAND_LINE and generate an execution trace.
+
+.SH OPTIONS
+.TP
+-d
+Run eztrace.old with gdb
+.TP
+-e
+Show environment
+.TP
+-p
+PadicoTM mode
+.TP
+-m
+MPI mode
+.TP 5
+-t [plugin1 plugin2 ... pluginN]
+Select a list of plugins
+.TP
+-o DIRECTORY
+Select the output DIRECTORY
+.TP
+-l DIRECTORY
+Add DIRECTORY to the list of directories in which eztrace search for plugins
+.TP
+-f
+Enable EZTRACE_FLUSH
+.TP
+-?
+Display this help and exit
+.SH EXAMPLES
+$ eztrace.old -t "memory pthread" ./my_program param1 param2
+
+For MPI programs:
+.br
+$ mpirun -np 2 `eztrace.old -m ./my_program` param1 param2
+.SH SEE ALSO
+eztrace(1), eztrace_convert(1), eztrace_stats(1), eztrace_cc(1), eztrace_avail(1), eztrace_loaded(1), eztrace_create_plugin(1)
+.SH BUGS
+eztrace.old is a fallback launcher for eztrace. It relies on LD_PRELOAD for interception function calls. Thus, it only works for shared libraries.
+.SH REPORTING BUGS
+Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr
+.br
+EZTrace home page: <http://eztrace.gforge.inria.fr/>
+.SH AUTHOR
+Francois Trahay (francois.trahay@telecom-sduparis.eu)
--- /dev/null	2013-09-06 16:46:15.327715999 +0200
+++ eztrace/doc/man/eztrace_avail.1	2013-09-06 18:00:50.000000000 +0200
@@ -0,0 +1,39 @@
+.\" Manpage for eztrace_avail.
+.\" Contact eztrace-devel@lists.gforge.inria.fr to correct errors or typos.
+.TH man 1 "05 September 2013" "1.0" "eztrace_avail man page"
+.SH NAME
+eztrace_avail \- print the list of available EZTrace modules
+.SH SYNOPSIS
+eztrace_avail [OPTIONS]
+.SH DESCRIPTION
+Print the list of available EZTrace modules
+
+.SH OPTIONS
+.TP
+-v
+Select the verbose mode
+.TP
+-h
+Display this help and exit
+.SH EXAMPLES
+$ eztrace_avail
+.br
+3       stdio   Module for stdio functions (read, write, select, poll, etc.)
+.br
+2       pthread Module for PThread synchronization functions (mutex, semaphore, spinlock, etc.)
+.br
+6       papi    Module for PAPI Performance counters
+.br
+1       omp     Module for OpenMP parallel regions
+.br
+4       mpi     Module for MPI functions
+.br
+5       memory  Module for memory functions (malloc, free, etc.)
+.SH SEE ALSO
+eztrace_convert(1), eztrace_stats(1), eztrace.old(1), eztrace_cc(1), eztrace_avail(1), eztrace_loaded(1), eztrace_create_plugin(1)
+.SH REPORTING BUGS
+Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr
+.br
+EZTrace home page: <http://eztrace.gforge.inria.fr/>
+.SH AUTHOR
+Francois Trahay (francois.trahay@telecom-sduparis.eu)
--- /dev/null	2013-09-06 16:46:15.327715999 +0200
+++ eztrace/doc/man/eztrace_cc.1	2013-09-06 18:00:50.000000000 +0200
@@ -0,0 +1,20 @@
+.\" Manpage for eztrace_cc.
+.\" Contact eztrace-devel@lists.gforge.inria.fr to correct errors or typos.
+.TH man 1 "05 September 2013" "1.0" "eztrace_cc man page"
+.SH NAME
+eztrace_cc \- Compile an OpenMP application for eztrace
+.SH SYNOPSIS
+eztrace_cc COMPILATION_COMMAND
+.SH DESCRIPTION
+Compile an OpenMP application for eztrace.
+
+.SH EXAMPLES
+$ eztrace_cc gcc -o openmp_program openmp_program.c -fopenm
+.SH SEE ALSO
+eztrace_convert(1), eztrace_stats(1), eztrace.old(1), eztrace_cc(1), eztrace_avail(1), eztrace_loaded(1), eztrace_create_plugin(1)
+.SH REPORTING BUGS
+Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr
+.br
+EZTrace home page: <http://eztrace.gforge.inria.fr/>
+.SH AUTHOR
+Francois Trahay (francois.trahay@telecom-sduparis.eu)
--- /dev/null	2013-09-06 16:46:15.327715999 +0200
+++ eztrace/doc/man/eztrace_convert.1	2013-09-06 18:00:50.000000000 +0200
@@ -0,0 +1,46 @@
+.\" Manpage for eztrace_convert.
+.\" Contact eztrace-devel@lists.gforge.inria.fr to correct errors or typos.
+.TH man 1 "05 September 2013" "1.0" "eztrace_convert man page"
+.SH NAME
+eztrace_convert \- create PAJE/OTF traces
+.SH SYNOPSIS
+eztrace_convert [OPTIONS] INPUT_FILES
+.SH DESCRIPTION
+Browse the INPUT_FILES generated by the eztrace command (or eztrace.old) and create PAJE or OTF trace files.
+
+.SH OPTIONS
+.TP
+-v
+Enable verbose mode.
+.TP
+-t TRACE_FORMAT
+Select the output trace format. Available trace formats are PAJE, OTF (default: PAJE).
+.TP
+-z
+Enable trace compression.
+.TP
+-o OUTPUT_FILENAME
+Save the output trace as OUTPUT_FILENAME (default: eztrace_output.trace).
+.TP
+-h
+Display this help and exit
+.SH EXAMPLES
+
+$ eztrace -t pthread ./application
+.br
+Starting EZTrace... done
+.br
+[...]
+.br
+Stopping EZTrace... saving trace  /tmp/user_eztrace_log_rank_1
+.br
+$ eztrace_convert /tmp/user_eztrace_log_rank_1
+
+.SH SEE ALSO
+eztrace(1), eztrace_stats(1), eztrace.old(1), eztrace_cc(1), eztrace_avail(1), eztrace_loaded(1), eztrace_create_plugin(1)
+.SH REPORTING BUGS
+Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr
+.br
+EZTrace home page: <http://eztrace.gforge.inria.fr/>
+.SH AUTHOR
+Francois Trahay (francois.trahay@telecom-sduparis.eu)
--- /dev/null	2013-09-06 16:46:15.327715999 +0200
+++ eztrace/doc/man/eztrace_create_plugin.1	2013-09-06 18:00:50.000000000 +0200
@@ -0,0 +1,111 @@
+.\" Manpage for eztrace_create_plugin.
+.\" Contact eztrace-devel@lists.gforge.inria.fr to correct errors or typos.
+.TH man 1 "05 September 2013" "1.0" "eztrace_create_plugin man page"
+.SH NAME
+eztrace_create_plugin \- creates an EZTrace plugin
+.SH SYNOPSIS
+eztrace_create [OPTION] FILE
+.SH DESCRIPTION
+Generate an EZTrace plugin
+
+.SH OPTIONS
+.TP
+-I <incdir1,incdir2,..., --include_dir=<incdir1,incdir2,...>>
+Add specific include directories for the compilation of the generated code.
+.TP
+-o <dir, --output=<dir>>
+Select the output directory.
+.TP
+-h --help
+Print a brief help message and exits.
+.SH 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
+.br
+BEGIN_MODULE
+.br
+NAME example_lib
+.br
+DESC "module for the example library"
+.br
+LANGUAGE C
+.br
+ID 99
+.br
+int foo(int n)
+.br
+BEGIN
+.br
+ EVENT("Do function foo")
+.br
+END
+.br
+void bar(int n)
+.br
+BEGIN
+.br
+ RECORD_STATE("running function bar")
+.br
+END
+.br
+END_MODULE
+.br
+--- 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
+.br
+New Module
+.br
+Module name : 'example_lib'
+.br
+Module description : '"module for the example library"'
+.br
+Language : 'C'
+.br
+Module id : '99'
+.br
+Function 'foo' done
+.br
+Function 'bar' done
+.br
+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
+.br
+$ make
+.br
+$ export EZTRACE_LIBRARY_PATH=$PWD
+.br
+$ eztrace_avail
+.br
+3       stdio   Module for stdio functions (read, write, select, poll, etc.)
+.br
+2       pthread Module for PThread synchronization functions (mutex, semaphore, spinlock, etc.)
+.br
+6       papi    Module for PAPI Performance counters
+.br
+1       omp     Module for OpenMP parallel regions
+.br
+4       mpi     Module for MPI functions
+.br
+5       memory  Module for memory functions (malloc, free, etc.)
+.br
+153     example_lib     module for the example library
+.br
+$ eztrace -t example_lib my_application
+.br
+[...]
+
+.SH SEE ALSO
+eztrace_convert(1), eztrace_stats(1), eztrace.old(1), eztrace_cc(1), eztrace_avail(1), eztrace_loaded(1), eztrace_create_plugin(1)
+.SH REPORTING BUGS
+Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr
+.br
+EZTrace home page: <http://eztrace.gforge.inria.fr/>
+.SH AUTHOR
+Francois Trahay (francois.trahay@telecom-sduparis.eu)
--- /dev/null	2013-09-06 16:46:15.327715999 +0200
+++ eztrace/doc/man/eztrace_loaded.1	2013-09-06 18:00:50.000000000 +0200
@@ -0,0 +1,39 @@
+.\" Manpage for eztrace_loaded.
+.\" Contact eztrace-devel@lists.gforge.inria.fr to correct errors or typos.
+.TH man 1 "05 September 2013" "1.0" "eztrace_loaded man page"
+.SH NAME
+eztrace_loaded \- print the list of selected EZTrace modules
+.SH SYNOPSIS
+eztrace_loaded [OPTIONS]
+.SH DESCRIPTION
+Print the list of selected EZTrace modules
+
+.SH OPTIONS
+.TP
+-v
+Select the verbose mode
+.TP
+-h
+Display this help and exit
+.SH EXAMPLES
+$ eztrace_loaded
+.br
+3       stdio   Module for stdio functions (read, write, select, poll, etc.)
+.br
+2       pthread Module for PThread synchronization functions (mutex, semaphore, spinlock, etc.)
+.br
+6       papi    Module for PAPI Performance counters
+.br
+1       omp     Module for OpenMP parallel regions
+.br
+4       mpi     Module for MPI functions
+.br
+5       memory  Module for memory functions (malloc, free, etc.)
+.SH SEE ALSO
+eztrace_convert(1), eztrace_stats(1), eztrace.old(1), eztrace_cc(1), eztrace_avail(1), eztrace_loaded(1), eztrace_create_plugin(1)
+.SH REPORTING BUGS
+Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr
+.br
+EZTrace home page: <http://eztrace.gforge.inria.fr/>
+.SH AUTHOR
+Francois Trahay (francois.trahay@telecom-sduparis.eu)
--- /dev/null	2013-09-06 16:46:15.327715999 +0200
+++ eztrace/doc/man/eztrace_stats.1	2013-09-06 18:00:50.000000000 +0200
@@ -0,0 +1,49 @@
+.\" Manpage for eztrace_stats.
+.\" Contact eztrace-devel@lists.gforge.inria.fr to correct errors or typos.
+.TH man 1 "05 September 2013" "1.0" "eztrace_stats man page"
+.SH NAME
+eztrace_stats \- compute statistics from execution traces
+.SH SYNOPSIS
+eztrace_stats [OPTIONS] INPUT_FILES
+.SH DESCRIPTION
+Browse the INPUT_FILES generated by the eztrace command (or eztrace.old) and extract statistics.
+.SH OPTIONS
+.TP
+-o DIRECTORY
+Select the output directory
+.TP
+-v
+Enable verbose mode.
+.TP
+-h
+Display this help and exit
+
+.SH EXAMPLES
+$ eztrace_stats /tmp/user_eztrace_log_rank_1 
+.br
+[...]
+.br
+PThread:
+.br
+-------
+.br
+CT_Process #0:
+.br
+        semaphore 0x601300 was acquired 2 times.
+.br
+        semaphore 0x601320 was acquired 10 times.
+.br
+        mutex 0x6012c0 was acquired 20 times. total duration of critical_sections: 1000.065697 ms.
+.br
+        semaphore 0x601340 was acquired 10 times.
+.br
+Total: 4 locks acquired 42 times
+
+.SH SEE ALSO
+eztrace(1), eztrace_convert(1), eztrace.old(1), eztrace_cc(1), eztrace_avail(1), eztrace_loaded(1), eztrace_create_plugin(1)
+.SH REPORTING BUGS
+Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr
+.br
+EZTrace home page: <http://eztrace.gforge.inria.fr/>
+.SH AUTHOR
+Francois Trahay (francois.trahay@telecom-sduparis.eu)
