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



Usage
-----

A executable to be profiled is run under the supervision of the calltree skin
with "callgrind <executable> <args> ...".
This runs the executable and 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
