                                functracer-postproc

                        Functracer Post-Processor Tool

                  Copyright (C) 2008 by Nokia Corporation

Contents
--------
 0. Authors
 1. Introduction
 2. Where can I find it
 3. How does it work
 4. How to use
 5. Where does it work
 6. Bugs
 7. License


0. Authors
----------
Functracer post-processor has been developed by:

Allan Bezerra <allan.bezerra@indt.org.br>
Bruna Moreira <bruna.moreira@indt.org.br>
Bruno Abinader <bruno.abinader@indt.org.br>
Ricardo Guimaraes <ricardo.guimaraes@indt.org.br>

1. Introduction
---------------
Funtracer-postproc is a post-processing tool. It generates detailed reports
from Functracer output data. For now, functracer-postproc generates the
following reports:

- List non-freed allocations (possible leaks).
- List freed allocations.

2. Where can I find it
----------------------
FIXME: there is no website setup for it yet.

3. How does it work
-------------------
functracer-postproc reads data from a file and creates a report with useful
information.

4. How to use
--------------

Output from "functracer-postproc --help":

Usage: functracer-postproc options [ inputfile ]
   -c   --compress    Join allocations with same backtrace (use with -f or -l).
   -h   --help        Display this usage information.
   -v   --verbose     Print verbose messages.
   -f   --free        List freed allocations.
   -l   --leak        List non-freed allocations (possible leaks).
   -V   --version     Print program version.

5. Where does it work
---------------------
It works with ELF based Linux systems running on x86 or ARM architecture.

6. Bugs
-------
- memory leak generated by bfd_read_nearest_line function on 'src/resolve.c'.

To do:
- Test-suite framework infrastructure.
- Multi-arch support.

7. License
----------
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License version 2 as published by the Free
Software Foundation.
