
LiTL: Lightweight Trace Library
=============================================
LiTL is a lightweight tool for recording events during the execution of 
scientific high-performance applications. LiTL is designed to record events on 
the user level only. Therefore, it consumes much less resources (CPU time, 
memory, and the disk space) as the alternative tools, e.g. FxT that gather 
events on both user and kernel levels. As a result, LiTL is well-suited for 
recording events on embedded systems like ARM architectures.

Requirements
=============================================
In order to use LiTL, the following software is needed:
    * autoconf 2.63;

Getting LiTL
=============================================
Current development version of LiTL is available via Git
    git clone git+ssh://fusionforge.int-evry.fr//var/lib/gforge/chroot/
    scmrepos/git/litl/litl.git

After getting the latest development version (from Git), './bootstrap' should 
be run in the root directory and only then the tool can be built.

Installing LiTL
=============================================
At first, to configure LiTL the following script should be invoked:
    $ ./configure --prefix=<LITL_INSTALL_DIR>

The configuration script contains many different options that can be set. 
However, we recommend to use the default settings.

Once LiTL is configured, the next two commands should be executed:
    $ make
    $ make install

In order to check whether LiTL was installed correctly, a set of tests can be 
run as
    $ make check

Using LiTL
=============================================
litl_print
----------
  This tool is used to analyze trace files produced by LiTL as
    $ litl_print -f trace.file

litl_merge
----------
  This tool is used to merge severals traces into one archive as
    $ litl_merge -o archive.trace trace.0 trace.1 ... trace.n

litl_split
----------
  This tool is used to split an archive of traces into separate trace files as
    $ litl_split -f archive.trace -d output.dir  
