STRUCT AUXTRACE_QUEUES(9)

✨ struct auxtrace_queues(9) ✨

okay bestie so this is a page from the Kernel API Manual and honestly? it's giving "small struct, big responsibilities" 💅 no cap, it's literally just a container for a whole array of AUX area tracing queues, and we're gonna go through every single field together 🫶

---

🌸 NAME 🌸

struct auxtrace_queues — an array of AUX area tracing queues. that's it, that's the whole vibe 🎀

---

🦋 SYNOPSIS 🦋

struct auxtrace_queues {
    struct auxtrace_queue   *queue_array;
    unsigned int            nr_queues;
    bool new_data;
    bool populated;
    u64 next_buffer_nr;
 };

like… five members, zero drama, absolutely iconic ✨ (note: the original really does have that lil space before the closing brace, so we're keeping it, character for character, periodt 💖)

---

👑 Members 👑

• queue_array — the actual array of queues. this is the main character right here, the whole reason this struct exists 🌈
• nr_queues — how many queues we're working with. the count, the headcount, the "how many of y'all are there" number 🔥
• new_data — gets set whenever new data is queued. it's the lil notification bell of the struct 🔔💀
• populated — tells you the queues have been fully populated using the auxtrace_index. fully. completely. no crumbs left 🍓
• next_buffer_nr — used to number each buffer. it's the ticket dispenser at the deli counter, but make it u64 🎫✨

---

💜 SEE ALSO 💜

Kernel file ./tools/perf/util/auxtrace.h — and then a whole friend group of structs, all of them linked below, iykyk:

• 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_heap_item(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)

bestie go read all of them, they're literally all right there in the same header, no excuses 😤🫶

---

not me actually reading the kernel source for fun… anyway, this page lives under ./tools/perf/util and it's dated October 2026, so mark your calendars 📅💖

that's the whole page, slay, bye 💅✨🎀