xe_mem_pool_...hadow_locked(9)

🌸 NAME 🌸

xe_mem_pool_sync_shadow_locked — ok so this one copies a node from the primary pool over to the shadow pool, bestie 💅 that's literally the whole gig

(this little cutie lives in the Kernel API Manual, section 9 — yes, xe_mem_pool_...hadow_locked(9), she's an icon ✨)

---

🎀 SYNOPSIS 🎀

void xe_mem_pool_sync_shadow_locked (struct xe_mem_pool_node *node );

🫶 ARGUMENTS 🫶

• node — the node that was allocated in the memory pool, that's the one we're working with 💖

🦋 DESCRIPTION 🦋

So what it does: it copies the specified batch buffer from the primary pool over to the shadow pool 🌈 literally a glow-up relocation, no cap.

⚠️ Important caveat, don't skip this one: Swap_guard must be held the whole time — it's what keeps things in sync with any concurrent swap operations happening at the same time. Not optional, fr fr 😭

⭐ RETURN ⭐

None. Nope. Nothing. Zero. She returns void and she's at peace with that 💀

👑 SEE ALSO 👑

Kernel file ./drivers/gpu/drm/xe/xe_mem_pool.c, plus the whole friend group:

• struct xe_mem_pool(9)
• xe_mem_pool_init(9)
• xe_mem_pool_sync(9)
• xe_mem_pool_swap_shadow_locked(9)
• xe_mem_pool_gpu_addr(9)
• xe_mem_pool_cpu_addr(9)
• xe_mem_pool_bo_swap_guard(9)
• xe_mem_pool_bo_flush_write(9)
• xe_mem_pool_bo_sync_read(9)
• xe_mem_pool_alloc_node(9)
• xe_mem_pool_insert_node(9)
• xe_mem_pool_free_node(9)
• xe_mem_pool_node_cpu_addr(9)
• xe_mem_pool_dump(9)

---

okay that's the whole page, ily, go hold that swap_guard 💜

this masterpiece came from the kernel source at ./drivers/gpu/drm/xe, dated October 2026, and yes the footer still says xe_mem_pool_...hadow_locked(9) — she ate and left no crumbs 🍓✨