STRUCT XE_GT_SRIOV_VF_MIGRATION(9)

💖 struct xe_gt_sriov_vf_migration(9) 💖

okay so bestie, welcome to the Kernel API Manual, this is the page for struct xe_gt_sriov_vf_migration and it's literally the VF migration data struct. yes that's the whole vibe. it's giving "small struct, big responsibilities" 🫶

---

✨ NAME ✨

struct xe_gt_sriov_vf_migration — VF migration data. that's it, that's the name, no cap 💅

---

🌸 SYNOPSIS 🌸

struct xe_gt_sriov_vf_migration {
    struct work_struct worker;
    spinlock_t lock;
    wait_queue_head_t wq;
    void *scratch;
    atomic_t fixups_complete_count;
    struct {
      u8 resfix_stoppers;
    } debug;
    u8 resfix_marker;
    bool recovery_teardown;
    bool recovery_queued;
    bool recovery_inprogress;
    bool ggtt_need_fixes;
 };

look at her. iconic. every field exactly where it belongs ✨

---

🎀 Members 🎀

• worker — the VF migration recovery worker. she works, she recovers, she migrates. main character energy fr 🔥
• lock — protects recovery_queued and teardown. do not touch those without holding her, i'm serious 🙈
• wq — the wait queue for migration fixes. everybody waiting in line politely 🦋
• scratch — scratch memory for VF recovery. it's the notebook, it's the sticky pad, it's temporary 💀
• fixups_complete_count — counts completed fixups stages. literally a counter doing its little job 👑
• debug — debug hooks for delaying migration. yes, hooks, for delaying, iykyk 🌸
• debug.resfix_stoppers — stop and wait at different stages during post migration recovery. so you can peek, bestie 👀
• resfix_marker — marker sent on start and on end of post-migration steps. hello marker, goodbye marker, no in-between 🎀
• recovery_teardown — VF post migration recovery is being torn down. it's over, it's done, we're packing up 💅
• recovery_queued — VF post migration recovery in queued. (that's the original phrasing btw, "in queued" — she's in the queue, she's waiting ✨)
• recovery_inprogress — VF post migration recovery in progress. right now. happening. actively. 🔥
• ggtt_need_fixes — VF GGTT and references to it need fixes. flagged, noted, gonna need some attention 💜

ngl the recovery flags trio (recovery_teardown, recovery_queued, recovery_inprogress) is a whole mood board of states. remember recovery_queued is what lock is guarding, alongside teardown — that's straight from the page, not me guessing 🌈

---

🦋 SEE ALSO 🦋

• Kernel file ./drivers/gpu/drm/xe/xe_gt_sriov_vf_types.h
• struct xe_gt_sriov_vf_selfconfig(9)
• struct xe_gt_sriov_vf_runtime(9)
• struct xe_gt_sriov_vf(9)

go read those next, bestie, they're all in the same friend group 💖

---

okay and finally the little sign-off 🎀 this page lives in ./drivers/gpu/drm/xe, it's dated October 2026, and the title at the top and bottom of the original is struct xe_g...vf_migration(9) — yes it's truncated like that in the source, i'm not fixing it, that's her name and we respect it 🙈💅 periodt.