xe_gt_sriov_...fig_set_fair(9)

💖 xe_gt_sriov_...fig_set_fair (9) — Kernel API Manual, bestie edition 💖

okay so welcome to the Kernel API Manual entry for xe_gt_sriov_...fig_set_fair(9), and honestly? this one's a whole mood. it's a provisioning function. it makes many VFs share resources fairly like the icon it is 🎀

---

✨ NAME ✨

xe_gt_sriov_pf_config_set_fair — Provision many VFs with fair resources. that's it. that's the whole vibe 🫶

---

🌸 SYNOPSIS 🌸

int xe_gt_sriov_pf_config_set_fair (struct xe_gt *gt , unsigned int vfid
, unsigned int num_vfs );

look at her. three little params and she's out here dividing up silicon like a group-chat splitting the bill 💅

---

🦋 ARGUMENTS 🦋

• gt — the xe_gt. yes bestie, the actual graphics tile. your main character.
• vfid — starting VF identifier. can't be 0 🚫 (like, literally, zero is not invited)
• num_vfs — number of VFs to provision. also can't be 0 🙈 zero is giving nothing so please don't

---

🌈 DESCRIPTION 🌈

This function can only be called on PF.

that's it. that's the entire description. no cap, that's all the manpage gives us 💀 so like — PF only. sample it, don't sample it from a VF, it's not for that. periodt.

---

⭐ RETURN ⭐

• 0 on success 🎉 slay
• a negative error code on failure 😭 not slay

---

💜 SEE ALSO 💜

🍓 the source file

Kernel file ./drivers/gpu/drm/xe/xe_gt_sriov_pf_config.c

the whole family lives here iykyk

🧚 the friends

• xe_gt_sriov_pf_config_get_ggtt(9), xe_gt_sriov_pf_config_set_ggtt(9), xe_gt_sriov_pf_config_bulk_set_ggtt(9), xe_gt_sriov_pf_config_set_fair_ggtt(9)
• xe_gt_sriov_pf_config_ggtt_save(9), xe_gt_sriov_pf_config_ggtt_restore(9)
• xe_gt_sriov_pf_config_get_ctxs(9), xe_gt_sriov_pf_config_set_ctxs(9), xe_gt_sriov_pf_config_bulk_set_ctxs(9), xe_gt_sriov_pf_config_set_fair_ctxs(9)
• xe_gt_sriov_pf_config_get_dbs(9), xe_gt_sriov_pf_config_set_dbs(9), xe_gt_sriov_pf_config_bulk_set_dbs(9), xe_gt_sriov_pf_config_set_fair_dbs(9)
• xe_gt_sriov_pf_config_get_lmem(9), xe_gt_sriov_pf_config_set_lmem(9), xe_gt_sriov_pf_config_bulk_set_lmem_locked(9), xe_gt_sriov_pf_config_bulk_set_lmem(9), xe_gt_sriov_pf_config_get_lmem_locked(9), xe_gt_sriov_pf_config_set_lmem_locked(9), xe_gt_sriov_pf_config_get_lmem_obj(9), xe_gt_sriov_pf_config_set_fair_lmem(9)
• xe_gt_sriov_pf_config_set_exec_quantum_locked(9), xe_gt_sriov_pf_config_set_exec_quantum(9), xe_gt_sriov_pf_config_get_exec_quantum_locked(9), xe_gt_sriov_pf_config_get_exec_quantum(9), xe_gt_sriov_pf_config_bulk_set_exec_quantum_locked(9), xe_gt_sriov_pf_config_set_groups_exec_quantums(9), xe_gt_sriov_pf_config_get_groups_exec_quantums(9)
• xe_gt_sriov_pf_config_set_preempt_timeout_locked(9), xe_gt_sriov_pf_config_set_preempt_timeout(9), xe_gt_sriov_pf_config_get_preempt_timeout_locked(9), xe_gt_sriov_pf_config_get_preempt_timeout(9), xe_gt_sriov_pf_config_bulk_set_preempt_timeout_locked(9), xe_gt_sriov_pf_config_set_groups_preempt_timeouts(9), xe_gt_sriov_pf_config_get_groups_preempt_timeouts(9)
• xe_gt_sriov_pf_config_set_sched_priority(9), xe_gt_sriov_pf_config_get_sched_priority(9), xe_gt_sriov_pf_config_force_sched_priority_locked(9), xe_gt_sriov_pf_config_set_fair_sched(9)
• xe_gt_sriov_pf_config_set_threshold(9), xe_gt_sriov_pf_config_get_threshold(9)
• xe_gt_sriov_pf_config_release(9), xe_gt_sriov_pf_config_sanitize(9), xe_gt_sriov_pf_config_push(9), xe_gt_sriov_pf_config_is_empty(9), xe_gt_sriov_pf_config_save(9), xe_gt_sriov_pf_config_restore(9), xe_gt_sriov_pf_config_init(9), xe_gt_sriov_pf_config_restart(9)
• xe_gt_sriov_pf_config_print_ggtt(9), xe_gt_sriov_pf_config_print_ctxs(9), xe_gt_sriov_pf_config_print_dbs(9), xe_gt_sriov_pf_config_print_lmem(9), xe_gt_sriov_pf_config_print_available_ggtt(9)

like, the whole polycule of config functions. go read them, they're all iconic 👑

---

💀 real talk though: calling this anywhere that isn't a PF is not it. the manpage says PF only and we respect the manpage.

---

and that's the page, bestie!! this gem ships out of ./drivers/gpu/drm/xe, dated October 2026, and the header you'll see stamped on it is xe_gt_sriov_...fig_set_fair(9) — it's giving truncated-but-fabulous 💅✨ go provision something fairly, mwah 🫶🎀