STRUCT ADDR_FILTER(9)

💖 struct addr_filter(9) — like, the address filter struct, bestie 💖

okay so this is a page from the Kernel API Manual and it's literally all about struct addr_filter — cute name, big job. it's the address filter, and we're gonna go through every single member together because i refuse to let you skim. 🫶

---

✨ NAME ✨

struct addr_filter — address filter. that's it, that's the whole vibe. short, sweet, main character energy. 💅

---

🌸 SYNOPSIS 🌸

here's the whole struct, copied exactly, no cap:

struct addr_filter {
    struct list_head        list;
    bool range;
    bool start;
    const char              *action;
    const char              *sym_from;
    const char              *sym_to;
    int sym_from_idx;
    int sym_to_idx;
    u64 addr;
    u64 size;
    const char              *filename;
    char *str;
 };

look at her. twelve members. flawless. 🎀

---

🦋 Members 🦋

okay bestie, member-by-member, let's go:

• list — the list node. it's how she links up with her friends. 🧚
• range — true if it's a range filter. yes queen, cover that whole region. 🔥
• start — true if action is 'filter' or 'start'. simple as that. ✨
• action — okay so the original page literally says to 'stop') and that's all it says, so that's exactly what i'm giving you. i am not about to invent lore. 🙈
• sym_from — symbol name for the filter address. the from one. 💜
• sym_to — symbol name that determines the filter size. she sets the size, she's in charge. 👑
• sym_from_idx — selects n'th from symbols with the same name (0 means global and less than 0 means symbol must be unique). so 0 = global, negative = must be unique, got it got it. ⭐
• sym_to_idx — same as sym_from_idx but for sym_to. they're matching. it's giving coordinated outfits. 🌈
• addr — filter address. the address itself. 📍
• size — filter region size (for range filters). only the range girls get this one. 🍓
• filename — DSO file name or NULL for the kernel. NULL = kernel, iykyk. 🌸
• str — allocated string that contains the other string members. she's the group chat that holds all the other messages. 😭

ngl the action line above is exactly as short as the page gives it — to 'stop') — so don't come for me, i kept it character for character. 💀

---

🔍 SEE ALSO 🔍

go read these too, bestie, i'm serious:

Kernel file ./tools/perf/util/auxtrace.h, 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 auxtrace_record(9), struct addr_filters(9)

---

💖 that's the whole page! this one lives over in ./tools/perf/util, dated October 2026 — so yeah, she's fresh. go forth and filter those addresses, bestie. periodt. 🎀✨