CG_ANNOTATE(1)

🎀 CG_ANNOTATE(1): the cg_annotate bestie era 🎀

okay bestie, you found the CG_ANNOTATE(1) page 💅 this is the manual for cg_annotate, and we’re gonna make it make sense. No cap.

🌸 NAME 🌸

cg_annotate — post-processing tool for Cachegrind ✨

🦋 SYNOPSIS 🦋

cg_annotate [options] cachegrind-out-file [source-files...]

💖 DESCRIPTION 💖

cg_annotate takes one or more Cachegrind output files and prints data about the profiled program in an easy-to-read form. It’s giving “turn the profiler dump into something your eyeballs can actually enjoy” 👑.

🎀 OPTIONS 🎀

• -h, --help — shows the help message. 🫶
• --version — shows the version number. 💜
• --diff — diffs two Cachegrind output files. 🦋
• --mod-filename <regex> — [default: none] specifies an s/old/new/ search-and-replace expression that is applied to all filenames. This is highkey useful when you’re differencing and need to remove 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. It’s 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). The 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. 😭

👀 SEE ALSO 👀

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

💌 AUTHOR 💌

Nicholas Nethercote. 👑

---

okay bye bestie 🫶 this page is from Release 3.27.1, dated 06/23/2026, and it’s the CG_ANNOTATE(1) manual — mwah 💋