xe_gt_sriov...ched_if_idle(9)

💖 xe_gt_sriov...ched_if_idle(9) 💖

okay so bestie, welcome to the Kernel API Manual ✨ — this one is a tiny little function with a huge name and honestly? she's giving main character energy. Let's get into it 🫶

---

🌸 NAME 🌸

xe_gt_sriov_pf_policy_set_sched_if_idle — the one that controls the 'sched_if_idle' policy. that's it. that's the whole vibe 💅

---

✨ SYNOPSIS ✨

int xe_gt_sriov_pf_policy_set_sched_if_idle (struct xe_gt *gt , bool enable );

like, literally just hand it a gt and a bool and she does her thing 🎀

---

🦋 ARGUMENTS 🦋

• gt — the xe_gt where you wanna apply the policy. it's the where, yk? 📍
• enable — the actual value of the 'sched_if_idle' policy. so like, on or off, babe. true/false. no in-between 💀

---

💜 DESCRIPTION 💜

okay so here's the important part, bestie, don't skip it 🙈

This function can only be called on PF.

no cap. PF only. if you're not PF, this is not the function for you, and that's on periodt ✋

---

🔥 RETURN 🔥

• 0 on success 🎉 (slay)
• a negative error code on failure 😭 (not slay, but informative)

---

🌈 SEE ALSO 🌈

the kernel file lives here, iconically:

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

and here's the whole friend group 🫶 — the xe_gt_sriov_pf_policy squad, all in one place:

• xe_gt_sriov_pf_policy_set_sched_if_idle_locked(9)
• xe_gt_sriov_pf_policy_get_sched_if_idle_locked(9)
• xe_gt_sriov_pf_policy_get_sched_if_idle(9)
• xe_gt_sriov_pf_policy_set_reset_engine(9)
• xe_gt_sriov_pf_policy_get_reset_engine(9)
• xe_gt_sriov_pf_policy_set_sample_period(9)
• xe_gt_sriov_pf_policy_get_sample_period(9)
• xe_sriov_gt_pf_policy_has_sched_groups_support(9)
• xe_sriov_gt_pf_policy_has_multi_group_modes(9)
• xe_sriov_gt_pf_policy_has_sched_group_mode(9)
• xe_gt_sriov_pf_policy_set_sched_groups_mode(9)
• xe_gt_sriov_pf_policy_sched_groups_enabled(9)
• xe_gt_sriov_pf_policy_sanitize(9)
• xe_gt_sriov_pf_policy_restart(9)
• xe_gt_sriov_pf_policy_init(9)
• xe_gt_sriov_pf_policy_print(9)

ngl that's a lot of siblings but they're all iconic in their own way 👑💖

---

🎀 sign-off 🎀

this absolute gem of a page comes to you from ./drivers/gpu/drm/xe, dated October 2026 — go off, kernel docs, we love to see it 💅✨🍓