|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | AUTHOR | COLOPHON |
|
|
|
CG_ANNOTATE(1) cg_annotate CG_ANNOTATE(1)
cg_annotate - post-processing tool for Cachegrind
cg_annotate [options] cachegrind-out-file [source-files...]
cg_annotate takes one or more Cachegrind output files and prints
data about the profiled program in an easy-to-read form.
-h --help
Show the help message.
--version
Show the version number.
--diff
Diff two Cachegrind output files.
--mod-filename <regex> [default: none]
Specifies an s/old/new/ search-and-replace expression that is
applied to all filenames. Useful when differencing, for
removing minor differences in paths between two different
versions of a program that are sitting in different
directories. An i suffix makes the regex case-insensitive, and
a g suffix makes it match multiple times.
--mod-funcname <regex> [default: none]
Like --mod-filename, but for filenames. Useful for removing
minor differences in randomized names of auto-generated
functions generated by some compilers.
--show=A,B,C [default: all, using order in the Cachegrind output
file]
Specifies which events to show (and the column order). Default
is to use all present in the Cachegrind output file (and use
the order in the file). Best used in conjunction with --sort.
--sort=A,B,C [default: order in the Cachegrind output file]
Specifies the events upon which the sorting of the
file:function and function:file entries will be based.
--threshold=X [default: 0.1%]
Sets the significance threshold for the file:function and
function:files sections. A file or function is shown if it
accounts for more than X% of the counts for the primary sort
event. If annotating source files, this also affects which
files are annotated.
--show-percs, --no-show-percs, --show-percs=<no|yes> [default:
yes]
When enabled, a percentage is printed next to all event
counts. This helps gauge the relative importance of each
function and line.
--annotate, --no-annotate, --auto=<no|yes> [default: yes]
Enables or disables source file annotation.
--context=N [default: 8]
The number of lines of context to show before and after each
annotated line. Use a large number (e.g. 100000) to show all
source lines.
valgrind(1), $INSTALL/share/doc/valgrind/html/index.html or
http://www.valgrind.org/docs/manual/index.html.
Nicholas Nethercote.
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
man-pages@man7.org
Release 3.26.0.GIT 08/11/2025 CG_ANNOTATE(1)
Pages that refer to this page: cg_diff(1), cg_merge(1), valgrind(1)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|