STRUCT XE_MIGRATE(9)

💖 NAME 💖

okay so bestie, this page is straight out of the Kernel API Manual and it’s literally called struct xe_migrate — migrate context. That’s the whole vibe: it’s the migrate context struct, and we’re about to meet every single field like it’s a group-chat roster 💅✨

✨ SYNOPSIS ✨

       struct xe_migrate {
           struct xe_exec_queue *q;
           struct xe_tile *tile;
           struct mutex job_mutex;
           struct xe_bo *pt_bo;
           u64 batch_base_ofs;
           u64 usm_batch_base_ofs;
           u64 cleared_mem_ofs;
           u64 large_page_copy_ofs;
           u64 large_page_copy_pdes;
           struct dma_fence *fence;
           struct drm_suballoc_manager vm_update_sa;
           u64 min_chunk_size;
        };

💅 Members 💅

• q — default exec queue used for migration. Yes bestie, this is the main character queue for the migration situation 🎀
• tile — backpointer to the tile this struct xe_migrate belongs to. It knows its home tile, no cap 🏠
• job_mutex — timeline mutex for eng. Lock behavior, iconic 🔒
• pt_bo — page-table buffer object. The pt_bo bestie, keeping page tables cute 📄✨
• batch_base_ofs — VM offset of the migration batch buffer. Offset queen 👑
• usm_batch_base_ofs — VM offset of the usm batch buffer. Another offset, another slay 💫
• cleared_mem_ofs — VM offset of cleared_bo. Literally what it says 🧼
• large_page_copy_ofs — VM offset of 2M pages used for large copies. 2M pages, big-copy energy 🔥
• large_page_copy_pdes — BO offset to writeout 2M pages (PDEs) used for large copies. PDEs getting their own offset moment 🫶
• fence — dma-fence representing the last migration job batch. > Protected by job_mutex. So do not touch without the lock, periodt 🔐
• vm_update_sa — for integrated, used to suballocate page-tables out of the pt_bo. Suballocating page-tables, we love to see it 🧩
• min_chunk_size — for dgfx, Minimum chunk size. Keep it chunky, keep it minimum 🍓

🌈 SEE ALSO 🌈

The kernel file bestie is ./drivers/gpu/drm/xe/xe_migrate.c, and the whole friend group is:

• 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(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)

This iconic page lives at ./drivers/gpu/drm/xe and it’s stamped October 2026 — love that for us, mwah 🎀🫶💜