STRUCT KNAV_REGION(9)

✨ struct knav_region(9) ✨

okay so bestie, welcome to the Kernel API Manual — this one's all about struct knav_region, aka the qmss region info. think of it as the vibe check for a chunk of DMA memory 🎀

quick heads up before we dive in: @dma_start, dma_end are the start and end dma address, and @virt_start, virt_end are the start and end virtual address. that's literally the whole teaser, now let's get into it 💅

🌸 SYNOPSIS 🌸

struct knav_region {
    dma_addr_t dma_start, dma_end;
    void *virt_start, *virt_end;
    unsigned desc_size;
    unsigned used_desc;
    unsigned id;
    unsigned num_desc;
    unsigned link_index;
    const char              *name;
    struct list_head        list;
    struct list_head        pools;
 };

like, copy it exactly, no cap — those fields are the whole personality of this struct 🫶

👑 Members 👑

the main characters, one by one:

• dma_start, dma_end — the start and end dma address. the bookends of the DMA world 💖
• virt_start, virt_end — the start and end virtual address. same energy, virtual flavour ✨
• desc_size — descriptor size, i.e. how big each lil descriptor is 🎀
• used_desc — consumed descriptors. literally the "already ate" counter 🔥
• id — region number, its little ID card 🦋
• num_desc — total descriptors. the full headcount, periodt 🌸
• link_index — index of the first descriptor. where the chain starts, iykyk 💅
• name — region name. every icon needs a name 👑
• list — instance in the device's region list. it's giving "part of the group chat" 🌈
• pools — list of descriptor pools in the region. the whole pool party ⭐

🔥 SEE ALSO 🔥

• Kernel file ./drivers/soc/ti/knav_qmss.h
• struct knav_queue_stats(9)
• struct knav_reg_queue(9)
• struct knav_pool(9)
• struct knav_queue_inst(9)
• struct knav_queue(9)

go read the whole squad, bestie, they're all linked up 💜

ngl this page lives in ./drivers/soc/ti and it's dated October 2026 — so yeah, it's from the future, main character energy fr fr 😭

and that's the whole page, bestie! thanks for reading, mwah 💋 struct knav_region(9) out — see you in the next manpage 🧚‍♀️💖