STRUCT AUXTRACE_MMAP(9)

Okay bestie, welcome to the Kernel API Manual page for struct auxtrace_mmap(9) — yes, that's the manual name, and this struct is the main character today. 💅

✨ NAME ✨

struct auxtrace_mmap — records an mmap of the auxtrace buffer. That's the whole name-vibe, no cap. 🦋

🧚 SYNOPSIS 🧚

Here's the struct, copied exactly, no edits, no cap:

       struct auxtrace_mmap {
           void *base;
           void *userpg;
           size_t mask;
           size_t len;
           u64 prev;
           int idx;
           pid_t tid;
           int cpu;
        };

💖 Members 💖

Let's go through the members like we're doing a group-chat roll call:

• base — address of mapped area.
• userpg — pointer to the buffer's perf_event_mmap_page.
• mask — 0 if len is not a power of two, otherwise (len - 1).
• len — size of mapped area.
• prev — previous aux_head.
• idx — index of this mmap.
• tid — tid for a per-thread mmap (also set if there is only 1 tid on a per-cpu mmap) otherwise 0.
• cpu — cpu number for a per-cpu mmap otherwise -1.

🌈 SEE ALSO 🌈

Kernel file ./tools/perf/util/auxtrace.h — and the whole squad: 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_heap(9), struct auxtrace_mmap_params(9), struct auxtrace_record(9), struct addr_filter(9), struct addr_filters(9).

so yeah — source/version: ./tools/perf/util, date: October 2026, page: struct auxtrace_mmap(9) 🫶✨