|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | AUTHOR | COLOPHON |
|
|
|
CALLGRIND ANNOTATE(1) callgrind_annotate CALLGRIND ANNOTATE(1)
callgrind_annotate - post-processing tool for the Callgrind
callgrind_annotate [options]
[callgrind-out-file [source-files...]]
callgrind_annotate takes an output file produced by the Valgrind
tool Callgrind and prints the information in an easy-to-read form.
-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.
--threshold=<0--100> [default: 99%]
Percentage of counts (of primary sort event) we are interested
in.
callgrind_annotate stops printing functions when the sum of
the cost percentage of the printed functions is bigger or
equal to the given threshold percentage.
--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.
callgrind_annotate stops printing functions when the sum of
the cost percentage of the printed functions for all the
events is bigger or equal to the given event threshold
percentages.
When one or more thresholds are given via this option, the
value of --threshold is ignored.
--show-percs=<no|yes> [default: no]
When enabled, a percentage is printed next to all event
counts. This helps gauge the relative importance of each
function and line.
--auto=<yes|no> [default: yes]
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.
valgrind(1), $INSTALL/share/doc/valgrind/html/index.html or
http://www.valgrind.org/docs/manual/index.html.
Josef Weidendorfer <[email protected]>.
This manual page was written by Philipp Frauenfelder
<[email protected]>.
This page is part of the valgrind (a system for debugging and
profiling Linux programs) project. Information about the project
can be found at ⟨http://www.valgrind.org/⟩. If you have a bug
report for this manual page, see
⟨http://www.valgrind.org/support/bug_reports.html⟩. This page was
obtained from the project's upstream Git repository
⟨http://sourceware.org/git/valgrind.git⟩ on 2025-08-11. (At that
time, the date of the most recent commit that was found in the
repository was 2025-08-09.) If you discover 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 to
[email protected]
Release 3.26.0.GIT 08/11/2025 CALLGRIND ANNOTATE(1)
Pages that refer to this page: valgrind(1)