xe_gt_sriov...et_fair_ggtt(9)

💅 xe_gt_sriov...et_fair_ggtt(9) — like, the whole Kernel API Manual situation ✨

okay so bestie, buckle up 🎀 this one lives in the Kernel API Manual and it's genuinely so useful once it clicks, i promise. it's giving "divide the GGTT up fairly across a whole bunch of VFs at once" and honestly? iconic. no cap.

---

✨ NAME ✨

xe_gt_sriov_pf_config_set_fair_ggtt — provision many VFs with fair GGTT. that's it, that's the whole vibe. 🦋

---

🌸 SYNOPSIS 🌸

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

like, keep it exactly like that, don't retype it from memory bestie 😭

---

🫶 ARGUMENTS 🫶

• gt — the xe_gt you're working with. important: it can't be media. nope. not allowed. 🙈
• vfid — the starting VF identifier. also important: it can't be 0. periodt. 💅
• num_vfs — how many VFs you want to provision. that's the count, that's it, that's the assignment. 🌈

---

👑 DESCRIPTION 👑

This function can only be called on PF. that's the whole rule, no exceptions, don't try it on anything else or it's gonna be a bad time 💀

---

⭐ RETURN ⭐

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

like… that's the whole contract. slay.

---

🧚 SEE ALSO 🧚

Kernel file ./drivers/gpu/drm/xe/xe_gt_sriov_pf_config.c — that's where the actual lore lives, go read it 🍓

and the whole friend group of sibling functions, all of them, no skipping:

• 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_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_fair(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, that's the entire group chat, all 55 of them, go say hi 👋💖

---

and that's the page bestie!! 🫶 cute little sign-off: this one ships from ./drivers/gpu/drm/xe and it's dated October 2026 — so yeah, future vibes only ⭐💜