STRUCT AUXTRACE_RECORD(9)

💅 struct auxtrace_record(9) — a.k.a. the AUX area recording callback squad

okay bestie, this one's from the Kernel API Manual, and it's lowkey iconic: it's the struct auxtrace_record — literally the bundle of callbacks that make recording AUX area data possible 🎀

---

✨ NAME ✨

struct auxtrace_record — callbacks for recording AUX area data.

---

🦋 SYNOPSIS 🦋

struct auxtrace_record {
    int (*recording_options)(struct auxtrace_record *itr, struct evlist
*evlist, struct record_opts *opts);
    size_t (*info_priv_size)(struct auxtrace_record *itr, struct evlist
*evlist);
    int (*info_fill)(struct auxtrace_record *itr, struct perf_session
*session, struct perf_record_auxtrace_info *auxtrace_info, size_t
priv_size);
    void (*free)(struct auxtrace_record *itr);
    int (*snapshot_start)(struct auxtrace_record *itr);
    int (*snapshot_finish)(struct auxtrace_record *itr);
    int (*find_snapshot)(struct auxtrace_record *itr, int idx, struct
auxtrace_mmap *mm, unsigned char *data, u64 *head, u64 *old);
    int (*parse_snapshot_options)(struct auxtrace_record *itr, struct
record_opts *opts, const char *str);
    u64 (*reference)(struct auxtrace_record *itr);
    int (*read_finish)(struct auxtrace_record *itr, int idx);
    unsigned int alignment;
    unsigned int default_aux_sample_size;
    struct evlist *evlist;
 };

---

👑 Members 👑

• recording_options — validates and processes the recording options, periodt ✨
• info_priv_size — returns the size of the private data in auxtrace_info_event, iykyk
• info_fill — fills in that private data in auxtrace_info_event 💖
• free — frees this auxtrace record structure, bye bestie 🫶
• snapshot_start — starting a snapshot 🌸
• snapshot_finish — finishing a snapshot 🎀
• find_snapshot — finds the data to snapshot within the auxtrace mmap 🔍
• parse_snapshot_options — parses the snapshot options ⭐
• reference — provides a 64-bit reference number for auxtrace_event 💅
• read_finish — called after reading from an auxtrace mmap, like the little cleanup era 😌
• alignment — alignment (if any) for AUX area data 📐
• default_aux_sample_size — the default sample size for the --aux sample option 🌈
• evlist — the selected events list 🔥

---

💜 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_queue(9)
• struct auxtrace_queues(9)
• struct auxtrace_heap_item(9)
• struct auxtrace_heap(9)
• struct auxtrace_mmap(9)
• struct auxtrace_mmap_params(9)
• struct addr_filter(9)
• struct addr_filters(9)

---

ngl the whole squad is here — read the kernel header ./tools/perf/util/auxtrace.h if you wanna go deeper 🧚

that's the whole page, bestie — slay, go record some AUX area data ✨

💖 sign-off time: this absolute banger lives at ./tools/perf/util, dated October 2026, and it's struct auxtrace_record(9) in the section 9 lineup 🎀