Callgrind Tool for Valgrind (previously named CallTree)
=======================================================

Josef Weidendorfer
Josef.Weidendorfer@gmx.de


What is it?
-----------

This is a skin/tool (aka plugin) for Valgrind,
the runtime instrumentation system for x86-linux.
It is based on the cachegrind skin, a cache simulator
from the valgrind core package and adds call-graph profiling.



Installation
------------

See file INSTALL.
Quick guide: With a Valgrind installation and "valgrind" in PATH, do

    ./configure
    make
    make install

If you get the sources from CVS, run "./autogen.sh" before.


Usage
-----

A executable to be profiled is run under callgrinds supervision with

	callgrind <executable> <args> ...

At termination, it generates a file with profile data "callgrind.out.<pid>".
The script "callgrind_annotate" produces human readable ASCII files from the
profile information in callgrind.out or cachegrind.out files.

A good KDE frontend for browsing the profile information
is KCachegrind (see http://kcachegrind.sourceforge.net).

For more information, see the files in the doc/ subdirectory.



Happy profiling,
Josef
