STRUCT ANNOTATED_SOURCE(9)

💖 NAME 💖

struct annotated_source — bestie, when your symbols have hits, this is the little struct that gets attached to them, inside the annotation ✨

🦋 SYNOPSIS 🦋

       struct annotated_source {
           struct list_head        source;
           struct sym_hist         *histograms;
           struct hashmap          *samples;
           int nr_histograms;
           int nr_events;
           int nr_entries;
           int nr_asm_entries;
           int max_jump_sources;
           bool tried_source;
           u64 start;
           struct {
             u8 addr;
             u8 jumps;
             u8 target;
             u8 min_addr;
             u8 max_addr;
             u8 max_ins_name;
             u16 max_line_len;
           } widths;
        };

🎀 Members 🎀

• source — the list head for annotated_line (which is embeded in disasm_line, okurrr) 💅
• histograms — an array of symbol histograms, one per event, holding onto the total number of samples and the period 🌸
• samples — a hash map of sym_hist_entry, keyed by event index plus the offset in the symbol 🗺️
• nr_histograms — lowkey this might not equal evsel->evlist->core.nr_entries if you've got more than a group in a evlist, because then we want to see each group separately — that's literally why symbol__annotate2 sets src->nr_histograms to evsel->nr_members 🧚
• nr_events — number of events in the current output ✨
• nr_entries — number of annotated_line in the source list 🎀
• nr_asm_entries — number of annotated_line that actually have a real asm instruction in the source list 👑
• max_jump_sources — the maximum number of jump instructions all targeting the same instruction, no cap 🏹
• widths — precalculated width of each column in the TUI output, so the table doesn't wobble on you 📐

💀 Description 💀

So here's the vibe: the disasm_lines get allocated, percentages get calculated, and everything gets sorted by percentage right when the annotation is about to be presented. Which means those percentages are for one of the entries in the histogram array — i.e. for the event/counter currently being presented, not some mix of everything. Main character energy only 💅

And then it gets deallocated right after symbol__{tui,tty,etc}_annotate returns. Gone. Poof. 🫶

🔥 SEE ALSO 🔥

Kernel file ./tools/perf/util/annotate.h, plus the whole friend group: struct sym_hist(9), struct cyc_hist(9), struct annotated_branch(9), struct annotated_op_loc(9), struct annotated_insn_loc(9), struct annotated_basic_block(9) ⭐

ngl bestie, go read those other structs too, iykyk 💖

That's the whole page, mwah 🍓 — brought to you from ./tools/perf/util, dated October 2026, slay 🎀✨