xe_gt_sriov_..._save_failed(9)
π
xe_gt_sriov_..._save_failed(9) β a Kernel API Manual moment, brought to you by the letter "S" for "save"
Okay bestie, sit down, grab a strawberry π β we're reading a real page out of the Kernel API Manual, and it's literally called xe_gt_sriov_..._save_failed(9). Yes, the title itself has an ellipsis in it, and yes, that's iconic. It's giving "the kernel was too busy to type the whole name."
β¨ NAME β¨
xe_gt_sriov_pf_control_check_save_failed β the function that checks whether save processing has failed. That's it. That's the whole job. It's the vibe check for saves. π«Ά
πΈ SYNOPSIS πΈ
bool xe_gt_sriov_pf_control_check_save_failed(struct xe_gt *gt, unsigned int vfid);
Two arguments, one bool coming back at you. Clean. Minimal. Slay. π
π ARGUMENTS π
gtβ thexe_gt. Your graphics tile main character. πvfidβ the VF identifier. Which virtual function we're β¨inquiring aboutβ¨.
π¦ DESCRIPTION π¦
So here's the tea: this function is for PF only. PF, not VF. Do not come in here as a VF, bestie, this is not your function, this is not your era. π«
No cap, that's the entire description. Sometimes the manpage is short because the function knows exactly what it is.
π₯ RETURN π₯
trueβ save processing failed. π It's giving bad news.falseβ otherwise. π
Literally a bool. No error codes, no -EINVAL drama, just a straight yes-or-no answer, fr fr.
β SEE ALSO β
The kernel file lives at ./drivers/gpu/drm/xe/xe_gt_sriov_pf_control.c β go look, iykyk. π And now, the whole friend group, in the order the page shouts them out:
- 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_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_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)
Like, that's a lot of cross-references and every single one of them ate. π Not one skipped.
Heads up bestie: every one of those SEE ALSO entries is a real manual page reference β if you're chasing the save/restore/FLR pipeline, that list is your whole lore drop. Don't skip the state machine ones, they're the plot. π§
Mwah π β this page is served up from ./drivers/gpu/drm/xe, dated October 2026, and it goes out to you as xe_gt_sriov_..._save_failed(9), a certified Kernel API Manual baddie. Periodt. πβ¨
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms