Calltree Skin for Valgrind 1.9.5
================================

Josef Weidendorfer
Josef.Weidendorfer@gmx.de



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

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



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

See file INSTALL.
Quick guide: With a Valgrind 1.9.5 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 "calltree <executable> <args> ...".
This runs the executable and generates a file with profile data
"cachegrind.out.<pid>".

The script "ct_annotate" produces human readable ASCII files from the
profile information in cachegrind.out files.

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

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



Happy profiling,
Josef
