xe_gt_sriov_..._prepare_flr(9)

💅 xe_gt_sriov_..._prepare_flr(9) — from the Kernel API Manual, bestie

okay so picture this: it's a whole Kernel API Manual page, the title is xe_gt_sriov_..._prepare_flr(9) (yes the abbreviation with the dots is literally part of the name, we don't question it), and it's all about one little function that does one very specific thing. let's get into it ✨

---

🎀 NAME 🎀

xe_gt_sriov_pf_control_prepare_flr — the function that tells the PF "hey girl, a VF FLR request just got issued" 👀

---

✨ SYNOPSIS ✨

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

like, that's the whole signature. short and iconic. 💅

---

🌸 ARGUMENTS 🌸

• gt — the xe_gt. that's it, that's the description. the graphics tile in question 🫶
• vfid — the VF identifier. which virtual function we're talking about, bestie 🔢

---

💖 DESCRIPTION 💖

so this is an optional early notification path, and its whole job is to mark a pending FLR before the GuC notifies the PF with a FLR event. think of it as the little heads-up text before the actual heads-up 😭

heads up! this function is for PF only. PF gang only. not VF. don't come in here if you're a VF 🙈

---

🔥 RETURN 🔥

• 0 on success 🎉
• a negative error code on failure 💀

that's it. that's the whole return contract. no cap.

---

🦋 SEE ALSO 🦋

okay this list is long, so buckle up bestie, we're going on a tour of every related state machine and function. no skipping, every single one makes the list 👑

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

like I said. a lot. but we read them all, and honestly? kind of obsessed with how thorough this is 🌈

---

and that's the page, bestie! 💜 this little gem lives under ./drivers/gpu/drm/xe in the Kernel API Manual, stamped October 2026 — go read the whole FLR state machine, it ate. periodt. 🎀✨