STRUCT AUXTRACE_QUEUE(9)

💖 struct auxtrace_queue(9) 💖

okay bestie, welcome to the Kernel API Manual ✨ — today's main character is struct auxtrace_queue(9), and it is literally what it sounds like: a queue of AUX area tracing data buffers. no cap. 🎀

---

🌸 NAME 🌸

struct auxtrace_queue — a queue of AUX area tracing data buffers 💅

---

✨ SYNOPSIS ✨

struct auxtrace_queue {
    struct list_head        head;
    pid_t tid;
    int cpu;
    bool set;
    void *priv;
 };

---

🦋 Members 🦋

so here's the squad, member by member, iykyk 👑

• head — the head of the buffer list. that's the whole vibe, it's where the list starts 💫
• tid — in per-thread mode, the tid this queue is associated with 🧵
• cpu — in per-cpu mode, the cpu this queue is associated with 🖥️
• set — true once this queue has been dedicated to a specific thread or cpu. like, it's taken. committed. locked in 🔒
• priv — implementation-specific data. mysterious. keeps its secrets. we respect it 🙈

---

🫶 SEE ALSO 🫶

Kernel file ./tools/perf/util/auxtrace.h, plus the 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_queues(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)

---

🌈 that's the whole page, bestie — go forth and queue your AUX data with main character energy 👑

sign-off szn: this lil gem lives in ./tools/perf/util and it's dated October 2026 ⭐ struct auxtrace_queue(9) out 💜