STRUCT AUXTRACE_HEAP_ITEM(9)

✨ struct auxtrace_heap_item(9) ✨

okay so bestie, welcome to the Kernel API Manual entry for struct auxtrace_heap_item(9) — yes that's a mouthful, but it's lowkey just one lil element of a heap and we're gonna slay this 💅

---

🌸 NAME 🌸

struct auxtrace_heap_item — literally just one element of struct auxtrace_heap. that's it. that's the whole vibe. 🎀

---

🦋 SYNOPSIS 🦋

struct auxtrace_heap_item {
    unsigned int            queue_nr;
    u64 ordinal;
 };

look at her. two fields. no cap, she's iconic in her simplicity ✨

---

💖 Members 💖

• queue_nr — the queue number 🎯 like, which queue this item belongs to, yk?
• ordinal — the value used for sorting, and btw the lowest ordinal ends up at the top of the heap 👑 it's expected to be a timestamp babe, so it's giving timeline energy 🕰️

---

🌈 SEE ALSO 🌈

everything below lives in the kernel file ./tools/perf/util/auxtrace.h — go read the whole fam, they're all linked and they all ate:

• struct itrace_synth_opts(9)
• struct auxtrace_index_entry(9)
• struct auxtrace_index(9)
• struct auxtrace(9)
• struct auxtrace_buffer(9)
• struct auxtrace_queue(9)
• struct auxtrace_queues(9)
• struct auxtrace_heap(9)
• struct auxtrace_mmap(9)
• struct auxtrace_mmap_params(9)
• struct auxtrace_record(9)
• struct addr_filter(9)
• struct addr_filters(9)

---

fr fr bestie, that's the whole page — no hidden lore, no jump scares, just a tidy lil struct 🫶

mwah 💋 that's a wrap! this one lives in ./tools/perf/util, dated October 2026, and it's filed under struct auxtrace_heap_item(9) if u ever need to find her again 🦋💜