1CALLGRIND ANNOTATE(1)         callgrind_annotate         CALLGRIND ANNOTATE(1)
2
3
4

NAME

6       callgrind_annotate - post-processing tool for the Callgrind
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

16       -h --help
17           Show summary of options.
18
19       --version
20           Show version of callgrind_annotate.
21
22       --show=A,B,C [default: all]
23           Only show figures for events A,B,C.
24
25       --threshold=<0--100> [default: 99%]
26           Percentage of counts (of primary sort event) we are interested in.
27
28           callgrind_annotate stops printing functions when the sum of the
29           cost percentage of the printed functions is bigger or equal to the
30           given threshold percentage.
31
32       --sort=A,B,C
33           Sort columns by events A,B,C [event column order].
34
35           Optionally, each event is followed by a : and a threshold, to
36           specify different thresholds depending on the event.
37
38           callgrind_annotate stops printing functions when the sum of the
39           cost percentage of the printed functions for all the events is
40           bigger or equal to the given event threshold percentages.
41
42           When one or more thresholds are given via this option, the value of
43           --threshold is ignored.
44
45       --show-percs=<no|yes> [default: no]
46           When enabled, a percentage is printed next to all event counts.
47           This helps gauge the relative importance of each function and line.
48
49       --auto=<yes|no> [default: yes]
50           Annotate all source files containing functions that helped reach
51           the event count threshold.
52
53       --context=N [default: 8]
54           Print N lines of context before and after annotated lines.
55
56       --inclusive=<yes|no> [default: no]
57           Add subroutine costs to functions calls.
58
59       --tree=<none|caller|calling|both> [default: none]
60           Print for each function their callers, the called functions or
61           both.
62
63       -I, --include=<dir>
64           Add dir to the list of directories to search for source files.
65

SEE ALSO

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

AUTHOR

71       Josef Weidendorfer <Josef.Weidendorfer@gmx.de>.
72
73       This manual page was written by Philipp Frauenfelder
74       <pfrauenf@debian.org>.
75
76
77
78Release 3.22.0                    10/31/2023             CALLGRIND ANNOTATE(1)
Impressum