xe_mem_pool_sync(9)

✨ xe_mem_pool_sync ✨

okay so this is the xe_mem_pool_sync(9) page from the Kernel API Manual, and honestly bestie it's a little one but it's important 💅

🌸 NAME 🌸

xe_mem_pool_sync — literally copies the entire contents of the main pool over to the shadow pool. that's it. that's the whole vibe 🫶

🎀 SYNOPSIS 🎀

void xe_mem_pool_sync (struct xe_mem_pool *pool );

🦋 ARGUMENTS 🦋

• pool — the memory pool that's holding both the primary and the shadow BOs. she's the main character here, we just hand her over 💖

🌈 DESCRIPTION 🌈

so what this does is copy the entire contents of the primary pool into the shadow pool. like, all of it. every last bit. no cap ✨

now here's the thing you actually need to know: you must do this after xe_mem_pool_init, and you must pass the XE_MEM_POOL_BO_FLAG_INIT_SHADOW_COPY flag when you do it — that flag is what makes sure the shadow pool ends up with the same initial contents as the primary pool. it's giving "matching outfits on day one" 🎀

and then? after this first big sync is done, clients are free to sync the shadow pool with the primary pool however they like — on a node basis — using xe_mem_pool_sync_shadow_locked, whenever they need it. so this function is the one-time full copy, and after that it's piece by piece, iykyk 💅

⭐ RETURN ⭐

None. nothing. nada. she returns void, she does the thing, she moves on 🧚

🔥 SEE ALSO 🔥

• Kernel file ./drivers/gpu/drm/xe/xe_mem_pool.c
• struct xe_mem_pool(9)
• xe_mem_pool_init(9)
• xe_mem_pool_swap_shadow_locked(9)
• xe_mem_pool_sync_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 bestie, go sync some pools 💜

this lil icon comes to you from ./drivers/gpu/drm/xe and it's dated October 2026 — periodt, slay, bye 👑