xe_sriov_pf_...ion_set_mode(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_sriov_pf_provision_set_mode — from the Kernel API Manual 🎀

okay bestie, buckle up, we're diving into xe_sriov_pf_provision_set_mode and honestly? she's giving "small function, big consequences" energy. This is the kernel API manual page, and yes we are reading it for fun. 🦋

✨ NAME ✨

xe_sriov_pf_provision_set_mode — literally just "change the VFs provision mode." That's the whole gig. Changing. Modes. Slay. 💅

🌸 SYNOPSIS 🌸

int xe_sriov_pf_provision_set_mode (struct xe_device *xe , enum
       xe_sriov_provisioning_mode mode );

look at her. two arguments, one int return. main character signature honestly. 👑

🎀 ARGUMENTS 🎀

  • xe — the PF xe_device. like, THE device. the parent of the whole virtual-function situation. no cap. 🫶
  • mode — the new VFs provisioning mode. this is the vibe you're switching her into. choose wisely bestie. ✨

💖 DESCRIPTION 💖

okay so here's the tea, and there is a LOT of tea. ☕

Switching from AUTO to CUSTOM mode: any VFs resources that are already allocated? they stay allocated. they do not get released when VFs get disabled. she's keeping them. that's the whole point. lowkey iconic. 🔥

Switching back to AUTO mode: two scenarios, pay attention bestie, there will be a quiz:

  • if VFs are not enabled — the already-allocated VFs resources get released immediately. poof. gone. instantly. 💀
  • if VFs are still enabled — the mode change gets rejected. straight up no. not happening. 🙈
⚠️ and this is the big one: this function can only be called on PF. periodt. do not try this anywhere else, it's not gonna end well for you. 💅

⭐ RETURN ⭐

  • 0 on success 🎉 (we love a zero)
  • a negative error code on failure 😭 (we do not love that, but it's real)

🌈 SEE ALSO 🌈

the friend group 💜 — first, the source file itself:

  • Kernel file ./drivers/gpu/drm/xe/xe_sriov_pf_provision.c 📁

and then her entire entourage, alphabetically-ish, all present and accounted for, no one left behind:

like, the whole bulk-apply / apply-vf / query-vf trio for eq, pt, priority and vram?? she's got range. she's got a squad. 🧚✨

aaaaand that's the page! 🍓 this lil beauty lives in ./drivers/gpu/drm/xe, dropped October 2026, filed under xe_sriov_pf_...ion_set_mode(9) — mwah, go read it again, iykyk 💖🦋🌸

📦 where this page comes from