Callgrind Tool for Valgrind 3
=============================

Josef Weidendorfer
Josef.Weidendorfer@gmx.de


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

Callgrind is a profiling tool for user level applications,
generating call graph information of unmodified binaries.
It is based on the runtime instrumentation framework Valgrind.


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
