STRUCT AUXTRACE_HEAP(9)

💖 NAME 💖

okay so bestie, welcome to struct auxtrace_heap(9) — this is a heap that's literally built for sorting AUX area tracing queues ✨ that's the whole vibe, that's the assignment, no cap.

(it lives in the Kernel API Manual, in case you were wondering where this queen hangs out 👑)

✨ SYNOPSIS ✨

struct auxtrace_heap {
    struct auxtrace_heap_item       *heap_array;
    unsigned int            heap_cnt;
    unsigned int            heap_sz;
 };

like, that's the whole struct. three little fields. main character energy fr fr 🎀

🫶 Members 🫶

• heap_array — the heap itself 💅 like, the actual array of stuff. this is where everything lives.
• heap_cnt — the number of elements in the heap 🔥 lowkey the headcount of who's currently in the heap.
• heap_sz — maximum number of elements, and bestie it grows as needed 🦋 so don't stress about it being a hard ceiling, it's giving flexible icon behavior.

🌈 SEE ALSO 🌈

bestie go read the Kernel file ./tools/perf/util/auxtrace.h and then go sprint through this whole friend group 🫶:

• 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_item(9)
• struct auxtrace_mmap(9)
• struct auxtrace_mmap_params(9)
• struct auxtrace_record(9)
• struct addr_filter(9)
• struct addr_filters(9)

like, the whole auxtrace extended universe 🌸 iykyk 💜

okay that's the page!! this one's brought to you by ./tools/perf/util, dated October 2026 — mwah, slay, periodt 💅💖🎀