CALLGRIND_ANNOTATE(1)

💖 NAME 💖

Okay bestie, welcome to the CALLGRIND ANNOTATE(1) manual page ✨ We're talking about callgrind_annotate — the post-processing tool for the Callgrind, periodt 💅

---

✨ SYNOPSIS ✨

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

---

🦋 DESCRIPTION 🦋

So callgrind_annotate takes an output file produced by the Valgrind tool Callgrind and prints the information in an easy-to-read form. No cap, that's her whole main character energy 🌈

---

🎀 OPTIONS 🎀

• -h, --help — shows a summary of options. Ur welcome 🫶
• --version — shows the version of callgrind_annotate ⭐
• --show=A,B,C [default: all] — only show figures for events A,B,C. Keep it selective, bestie 💅
• --threshold=<0--100> [default: 99%] — this is the percentage of counts (of the primary sort event) we are interested in 👑

Here's the vibe: 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. Literally the cutoff point, iykyk ✨

• --sort=A,B,C — sorts columns by events A,B,C in event column order 💖

Optionally, each event is followed by a : and a threshold, so you can specify different thresholds depending on the event. Fancy, right? 🎀

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. Very helpful, ngl 🦋
• --context=N [default: 8] — prints N lines of context before and after annotated lines. Snackable context, fr fr 🍓
• --inclusive=<yes|no> [default: no] — adds subroutine costs to functions calls. Inclusive queen behavior 👑
• --tree=<none|caller|calling|both> [default: none] — prints for each function their callers, the called functions or both. Choose ur fighter 🌸
• -I, --include=<dir> — adds dir to the list of directories to search for source files. Very demure, very directory-search 💅

---

🌈 SEE ALSO 🌈

Go peek at 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> 🫶

---

Okay that's the whole page, bestie — this was Release 3.27.1, dated 06/23/2026, from the CALLGRIND ANNOTATE(1) manual. byeee 🫶✨