STRUCT XE_RES_CURSOR(9)

💅 struct xe_res_cursor — Kernel API Manual ✨

okay so bestie, welcome to struct xe_res_cursor(9) 🎀 this little icon is literally the state holder for walking over dma mapping, vram_mgr, stolen_mgr, and gtt_mgr allocations. she's not doing the walking herself, she's just holding the vibe check while you do 🫶

✨ NAME ✨

struct xe_res_cursor — state for walking over dma mapping, vram_mgr, stolen_mgr, and gtt_mgr allocations 🌸

🌈 SYNOPSIS 🌈

struct xe_res_cursor {
    u64 start;
    u64 size;
    u64 remaining;
    void *node;
    u32 mem_type;
    struct scatterlist *sgl;
    const struct drm_pagemap_addr *dma_addr;
    struct gpu_buddy *mm;
    u64 dma_start;
    u64 dma_seg_size;
 };

like, that's the whole struct, no cap 💜

💖 Members 💖

• start — start of cursor ✨
• size — size of the current segment. the way she's segment-sized, honestly 🦋
• remaining — remaining bytes in cursor. the countdown queen 👑
• node — opaque point current node cursor 🙈 (yes, "point" — that's what the original says, we don't fix it, we respect it)
• mem_type — memory type 💅
• sgl — scatterlist for cursor 🎀
• dma_addr — current element in a struct drm_pagemap_addr array ⭐
• mm — buddy allocator for VRAM cursor 🔥
• dma_start — DMA start address for the current segment. This may be different to dma_addr.addr since elements in the array may be coalesced to a single segment 👀 like, don't assume they match, bestie
• dma_seg_size — size of the current DMA segment 🌈

🔍 SEE ALSO 🔍

• Kernel file ./drivers/gpu/drm/xe/xe_res_cursor.h xe_res_first(9), __xe_res_dma_next(9), xe_res_first_sg(9), xe_res_first_dma(9), xe_res_next(9), xe_res_dma(9), xe_res_is_vram(9) 🫶 go read those next, iykyk

and that's the whole page, periodt 😭💀 this dropped from ./drivers/gpu/drm/xe back in October 2026 — go off, kernel gang, ily 🧚💜