CALLGRIND ANNOTATE(1)          Release 3.13.0          CALLGRIND ANNOTATE(1)

NAME         top

       callgrind_annotate - post-processing tool for the Callgrind

SYNOPSIS         top

       callgrind_annotate [options] [callgrind-out-file [source-files...]]

DESCRIPTION         top

       callgrind_annotate takes an output file produced by the Valgrind tool
       Callgrind and prints the information in an easy-to-read form.

OPTIONS         top

       -h --help
           Show summary of options.

           Show version of callgrind_annotate.

       --show=A,B,C [default: all]
           Only show figures for events A,B,C.

           Sort columns by events A,B,C [event column order].

           Optionally, each event is followed by a : and a threshold, to
           specify different thresholds depending on the event.

       --threshold=<0--100> [default: 99%]
           Percentage of counts (of primary sort event) we are interested

       --auto=<yes|no> [default: no]
           Annotate all source files containing functions that helped reach
           the event count threshold.

       --context=N [default: 8]
           Print N lines of context before and after annotated lines.

       --inclusive=<yes|no> [default: no]
           Add subroutine costs to functions calls.

       --tree=<none|caller|calling|both> [default: none]
           Print for each function their callers, the called functions or

       -I, --include=<dir>
           Add dir to the list of directories to search for source files.

SEE ALSO         top

       valgrind(1), $INSTALL/share/doc/valgrind/html/index.html or

AUTHOR         top

       Josef Weidendorfer <>.

       This manual page was written by Philipp Frauenfelder

COLOPHON         top

       This page is part of the valgrind (a system for debugging and
       profiling Linux programs) project.  Information about the project can
       be found at ⟨⟩.  If you have a bug report for
       this manual page, see 
       ⟨⟩.  This page was
       obtained from the project's upstream Subversion repository 
       ⟨svn://⟩ on 2017-09-15.  If you dis‐
       cover any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

Release 3.13.0                   09/15/2017            CALLGRIND ANNOTATE(1)