GitHub - trahay/Generic-Trace-Generator: Generic Trace Generator (GTG) aims at providing a simple and generic interface for generating execution traces in several formats (OTF, Paje, etc.) It will be used by EZTrace and ViTE, but it can also be used by any application.

trahay / Generic-Trace-Generator Public

Notifications You must be signed in to change notification settings
Fork 1
Star 1

Generic Trace Generator (GTG) aims at providing a simple and generic interface for generating execution traces in several formats (OTF, Paje, etc.) It will be used by EZTrace and ViTE, but it can also be used by any application.

View license

1 star 1 fork Branches Tags Activity

Star

Notifications

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 197 Commits
doc		doc
exm		exm
extlib		extlib
inc		inc
src		src
test		test
AUTHORS		AUTHORS
COPYING		COPYING
COPYRIGHT		COPYRIGHT
ChangeLog		ChangeLog
Makefile.am		Makefile.am
NEWS		NEWS
README		README
ROADMAP		ROADMAP
configure.ac		configure.ac
gtg.pc.in		gtg.pc.in
release_notes		release_notes

Repository files navigation

==============================================
===            Introduction :               ==
==============================================
This directory contains the Generic Trace Generator (GTG) project.
Authors are : 
            Francois Rue    ,
            Francois Trahay ,
            Johnny   Jazeix ,
            Kevin    Coulomb,
            Mathieu  Faverge,
            Olivier  Lagrasse

==============================================
===                Files :                  ==
==============================================

-- Files
README        : This file, presenting the project
AUTHORS		  : The authors of the project
ChangeLog     : The list of the changes by version
configure.ac  : Used to create the configure file with autoreconf
COPYING		  : The copying rule
COPYRIGHT	  : The licence of the library
INSTALL		  : How to install the GTG library
Makefile.am	  : Some hints to generate the Makefile throught configure
NEWS		  : News about the project

-- Directories
*exm*         : Contains examples of programm using the library
*inc*         : Contains files to include
*src/C*       : Contains the C implementation of the API
*src/FORTRAN* : Contains the Fortran implementation of the API
*test*		  : Regular developers test



==============================================
===    Building from the Git repository:    ==
==============================================

First, you need to generate the configure files by running autoreconf:

$ autoreconf -vfi

Then, simply run configure && make && make install


==============================================
===               Examples :                ==
==============================================

The examples show code using the library.
You can compile them with *make examples*.
Their execution enables the creation of traces :
gtg_color creates the gtg_color.trace trace
cpaje     creates the cpaje.trace using the C API
fpaje     creates the fpaje.trace using the Fortran API
cpaje2    creates the cpaje2.trace using the C API
cvite     creates the cvite_root.ept trace (with cvite_proc*.ept) using the C API <DO NOT USE YET>

The traces can be viewed using the ViTE tool. This API is used by the eztrace
 that automatically generate traces for code, without modifying it manually.


==============================================
===               Support :                 ==
==============================================

If you encounter any problem, please fill an issue
(https://github.com/trahay/Generic-Trace-Generator/issues)
so that we can fix the feature as soon as possible.
You can also give us some feedback to help us improve the API.