t
 Title: Callgrind Annotate
 Author: [see the "Author" section]
 Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
 Date: 06/15/2017
 Manual: Release 3.13.0
 Source: Release 3.13.0
 Language: English

 "CALLGRIND ANNOTATE" "1" "06/15/2017" "Release 3.13.0" "Release 3.13.0"
 -----------------------------------------------------------------
 * Define some portability stuff
 -----------------------------------------------------------------
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 http://bugs.debian.org/507673
 http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 -----------------------------------------------------------------
 * set default formatting
 -----------------------------------------------------------------
 disable hyphenation
 disable justification (adjust text to left margin only)
 -----------------------------------------------------------------
 * MAIN CONTENT STARTS HERE *
 -----------------------------------------------------------------
 "NAME"
callgrind_annotate - post-processing tool for the Callgrind

 "SYNOPSIS"
 \w'callgrind_annotate 'u
callgrind_annotate [options] [callgrind-out-file [source-files...]]

 "DESCRIPTION"

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

 "OPTIONS"

-h --help


Show summary of options.




--version


Show version of callgrind_annotate.




--show=A,B,C [default: all]


Only show figures for events A,B,C.




--sort=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 in.




--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 both.




-I, --include=<dir> 


Add
dir
to the list of directories to search for source files.



 "SEE ALSO"

valgrind(1),
$INSTALL/share/doc/valgrind/html/index.html
or
http://www.valgrind.org/docs/manual/index.html.

 "AUTHOR"

Josef Weidendorfer <Josef.Weidendorfer@gmx.de>.


This manual page was written by Philipp Frauenfelder <pfrauenf@debian.org>.