xe_gt_sriov...save_consume(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_gt_sriov_pf_migration_save_consume 💅

okay so this is a page from the Kernel API Manual, section 9 — and yes bestie, we're getting into the migration ring lore today 🎀

✨ NAME ✨

xe_gt_sriov_pf_migration_save_consume — literally just: grab a VF save data packet off the migration ring 🌀 no cap, that's the whole vibe.

🌸 SYNOPSIS 🌸

struct xe_sriov_packet * xe_gt_sriov_pf_migration_save_consume (struct xe_gt *gt , unsigned int vfid );

like… that's it. two arguments. she's lowkey elegant 💅

🦋 ARGUMENTS 🦋

  • gt — the xe_gt 🚗 (yes THE gt, main character energy fr)
  • vfid — the VF identifier 🔢 (which virtual function we're talking about, iykyk)

👑 DESCRIPTION 👑

So this one gets called by the save migration data consumer — that's userspace, in case you were wondering 🙈 — whenever it's processing migration data.

And what does it do?? It queues the save migration data producer (aka the PF SR-IOV Control worker) 👷‍♀️ which is potentially just sitting there waiting to add more data when the ring is full 😭 like girl same, we've all been blocked waiting for space.

so yeah: consumer consumes → producer gets queued up → the ring keeps flowing 💖 it's giving teamwork, it's giving pipeline, it's giving slay.

⭐ RETURN ⭐

here's the vibe check on what you get back 👇

  • Pointer to xe_sriov_packet on success 🎉 iconic, we love a win
  • NULL if the ring is empty and there's no more data available 💀 it's done, nothing left, go home
  • ERR_PTR(-EAGAIN) if the ring is empty but data is still being produced 👀 so like… empty ≠ done, bestie. come back later, she's still cooking 🍓
ngl that last one is the sneakily important one — don't treat -EAGAIN like a failure, it literally means "more's coming, be patient" 🫶

🌈 SEE ALSO 🌈

the whole friend group 🫂 go say hi:

and that's the whole page, bestie 🧚💜

this little beauty lives over in ./drivers/gpu/drm/xe, dated October 2026, and it's part of the Kernel API Manual — that's the source, the version and the date all in one cute lil sign-off 🎀✨ mwah, go consume some packets 💅

📦 where this page comes from