xe_migrate_copy(9)

🌸 NAME 🌸

okay so bestie, welcome to xe_migrate_copy(9) from the Kernel API Manual — it’s literally the function for copying content of TTM resources. that’s the whole assignment, and it ate. 💅

✨ SYNOPSIS ✨

struct dma_fence * xe_migrate_copy (struct xe_migrate *m , struct xe_bo *src_bo , struct xe_bo *dst_bo , struct ttm_resource *src , struct ttm_resource *dst , bool copy_only_ccs );

🎀 ARGUMENTS 🎀

• m — the migration context. main character energy for this whole operation, ngl.
• src_bo — the buffer object src is currently bound to. yes bestie, that one.
• dst_bo — if you’re copying between resources created for the same bo, set this to the same value as src_bo. if you’re copying between buffer objects, set it to the buffer object dst is currently bound to. periodt.
• src — the source TTM resource. the origin story.
• dst — the dst TTM resource. the destination era.
• copy_only_ccs — if true, copy only CCS metadata. that’s the vibe check right there.

🦋 DESCRIPTION 🦋

so it copies the contents of src to dst: on flat CCS devices, the CCS metadata is copied as well if needed, or — if it’s not present — the CCS metadata of dst is cleared for security reasons. not me being dramatic, that’s just security doing security things. 🔥

💫 RETURN 💫

pointer to a dma_fence representing the last copy batch, or an error pointer on failure. and if there is a failure, any copy operation started by the function call has been synced. so like, it cleans up its own situation. iconic. 🫶

👑 SEE ALSO 👑

• Kernel file ./drivers/gpu/drm/xe/xe_migrate.c and struct xe_migrate(9)
• xe_migrate_alloc(9)
• xe_migrate_init(9)
• xe_migrate_resolve(9)
• xe_migrate_lrc(9)
• xe_migrate_ccs_rw_copy(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)

that’s the whole page, bestie 🫶 — source/version ./drivers/gpu/drm/xe, dated October 2026, page xe_migrate_copy(9). slay and bye 💅