xe_migrate_ccs_rw_copy(9)

💅 xe_migrate_ccs_rw_copy — like, the Kernel API Manual, section 9, bestie

okay so real talk, this is a function from the Kernel API Manual, manual page xe_migrate_ccs_rw_copy(9), and it's here to copy the content of TTM resources 💖 no cap. it lives in ./drivers/gpu/drm/xe and it's giving "small helper, big job" energy.

---

✨ NAME ✨

xe_migrate_ccs_rw_copy — Copy content of TTM resources. that's it, that's the whole vibe 🎀

---

🌸 SYNOPSIS 🌸

int xe_migrate_ccs_rw_copy (struct xe_tile *tile , struct xe_exec_queue
*q , struct xe_bo *src_bo , struct ttm_resource *new_mem , enum
xe_sriov_vf_ccs_rw_ctxs read_write );

like yes she takes five arguments and she returns an int, we love a predictable icon 👑

---

🦋 ARGUMENTS 🦋

• tile — the Tile whose migration context is gonna be used. literally the whole context source, don't sleep on her.
• q — the Execution to be used along with the migration context. she's coming along for the ride 🫶
• src_bo — the buffer object src is currently bound to. iykyk.
• new_mem — the (not yet committed!!) destination resource src_bo is being moved into. and lowkey important: src_bo->ttm.resource is still the old resource at this point. like it hasn't packed its bags yet 🧳
• read_write — Creates BB commands for CCS read/write. that's the enum, that's what it does, periodt.

---

🌈 DESCRIPTION 🌈

okay so what she actually does: she creates batch buffer instructions to copy CCS metadata from the CCS pool to memory — and vice versa 🔁💫. the way that metadata just... travels.

⚠️ okay this is the serious bit and i'm not gonna sugarcoat it: this function should only be called for IGPU. only. for IGPU. do not be out here calling her on anything else 💀 fr fr.

---

⭐ RETURN ⭐

• 0 if successful — slay, we ate ✨
• negative error code on failure — main character had a moment 😭

---

💜 SEE ALSO 💜

the whole friend group, honestly. she does not travel alone:

• Kernel file ./drivers/gpu/drm/xe/xe_migrate.c
• struct xe_migrate(9)
• xe_migrate_alloc(9)
• xe_migrate_init(9)
• xe_migrate_copy(9)
• xe_migrate_resolve(9)
• xe_migrate_lrc(9)
• xe_migrate_ccs_rw_copy_clear(9)
• xe_migrate_exec_queue(9)
• xe_migrate_vram_copy_chunk(9)
• xe_migrate_clear(9)
• xe_migrate_update_pgtables(9)
• xe_migrate_wait(9)
• xe_migrate_to_vram(9)
• xe_migrate_from_vram(9)
• xe_migrate_access_memory(9)
• xe_migrate_job_lock(9)
• xe_migrate_job_unlock(9)
• xe_migrate_job_lock_assert(9)

---

🎀 ok bye 🎀

that's the page bestie, you're now officially informed 💅✨ this one's from ./drivers/gpu/drm/xe, dated October 2026, out of the Kernel API Manual, and that's section 9 for you 🫶 go forth and copy those TTM resources responsibly 🌸🦋