xe_gt_sriov_...gger_save_vf(9)

💖 NAME 💖

okay so this is xe_gt_sriov_pf_control_trigger_save_vf — it starts an SR-IOV VF migration data save sequence. like it kicks off the whole "save this VF's stuff" arc. main character energy, fr fr 🎬

This one lives in the Kernel API Manual (yes, the kernel has lore and this is part of it 💅).

---

✨ SYNOPSIS ✨

int xe_gt_sriov_pf_control_trigger_save_vf(struct xe_gt *gt, unsigned int vfid);

---

🎀 ARGUMENTS 🎀

• gt — the xe_gt 🚗 (the graphics tile we're working with, bestie)
• vfid — the VF identifier 🔢 (which virtual function we're talking about, iykyk)

---

🌸 DESCRIPTION 🌸

This function is for PF only. no cap — PF as in Physical Function, don't come at it as a VF, it's just not that girl for this call 🫶

---

⭐ RETURN ⭐

0 on success, or a negative error code on failure 😭 (so like, check the return value, please, I'm begging)

---

🔥 SEE ALSO 🔥

the whole friend group, honestly — go read these too:

• Kernel file ./drivers/gpu/drm/xe/xe_gt_sriov_pf_control.c
• The VF state machine(9)
• The VF PAUSE state machine(9)
• xe_gt_sriov_pf_control_pause_vf(9)
• The VF RESUME state machine(9)
• xe_gt_sriov_pf_control_resume_vf(9)
• The VF SAVE state machine(9)
• xe_gt_sriov_pf_control_check_save_data_done(9)
• xe_gt_sriov_pf_control_check_save_failed(9)
• xe_gt_sriov_pf_control_process_save_data(9)
• xe_gt_sriov_pf_control_finish_save_vf(9)
• The VF RESTORE state machine(9)
• xe_gt_sriov_pf_control_check_restore_failed(9)
• xe_gt_sriov_pf_control_restore_data_done(9)
• xe_gt_sriov_pf_control_process_restore_data(9)
• xe_gt_sriov_pf_control_trigger_restore_vf(9)
• xe_gt_sriov_pf_control_finish_restore_vf(9)
• The VF STOP state machine(9)
• xe_gt_sriov_pf_control_stop_vf(9)
• The VF FLR state machine(9)
• xe_gt_sriov_pf_control_prepare_flr(9)
• xe_gt_sriov_pf_control_trigger_flr(9)
• xe_gt_sriov_pf_control_sync_flr(9)
• xe_gt_sriov_pf_control_wait_flr(9)
• The VF FLR Flow with GuC(9)
• xe_gt_sriov_pf_control_process_guc2pf(9)
• xe_gt_sriov_pf_control_init(9)
• xe_gt_sriov_pf_control_restart(9)

---

ok that's the whole page!! go forth and trigger that save sequence responsibly, bestie 🦋

anyway, this fine piece of documentation comes straight out of ./drivers/gpu/drm/xe, dated October 2026 — slay, drop the date in the group chat, periodt 👑💖