xe_migrate_vram_copy_chunk(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_migrate_vram_copy_chunk(9) — like, the whole page

okay so bestie, welcome to the Kernel API Manual ✨ this one's about xe_migrate_vram_copy_chunk(9) and honestly? it's a whole vibe. it copies a chunk of a VRAM buffer object and it does it beautifully. let's get into it 🫶

✨ NAME ✨

xe_migrate_vram_copy_chunk — Copy a chunk of a VRAM buffer object. that's it. that's the girl. 💅

🦋 SYNOPSIS 🦋

struct dma_fence * xe_migrate_vram_copy_chunk (struct xe_bo *vram_bo ,
       u64 vram_offset , struct xe_bo *sysmem_bo , u64 sysmem_offset , u64 size
       , enum xe_migrate_copy_dir dir );

look at her go 😭 six whole parameters, main character energy fr fr

🎀 ARGUMENTS 🎀

  • vram_bo — The VRAM buffer object. the source-of-truth bo, the one living its best life in VRAM 👑
  • vram_offset — The VRAM offset. where in the VRAM bo we're starting, iykyk
  • sysmem_bo — The sysmem buffer object. the system-memory counterpart, the other half of the ship 🥺
  • sysmem_offset — The sysmem offset. where in sysmem we're landing, no cap
  • size — The size of VRAM chunk to copy. literally how much we're moving, be precise bestie ⭐
  • dir — The direction of the copy operation. which way the data is travelling — vibe check on the flow 🌈

🌸 DESCRIPTION 🌸

so what she does is: copies a portion of a buffer object between VRAM and system memory. that's the whole job and she ate 🔥

aaaand one very important detail: on Xe2 platforms that support flat CCS, VRAM data is decompressed when copying to system memory. the way that she just handles decompression for you?? iconic. mentally i'm here 🧚

💖 RETURN 💖

returns a pointer to a dma_fence representing the last copy batch — or an error pointer on failure 😭

and listen, important: if there is a failure, any copy operation started by the function call has been synced. so you're not left hanging with a half-finished copy, she's got you 💅

ngl always check for that error pointer, bestie. the fence isn't gonna check itself 🙈

🦄 SEE ALSO 🦄

the whole friendship group 🫶 — Kernel file ./drivers/gpu/drm/xe/xe_migrate.c, plus:

and that's the page! 🎀 source: ./drivers/gpu/drm/xe, dated October 2026 — mwah, sending you kisses, go copy some chunks bestie 💜✨

📦 where this page comes from