xe_gt_sriov_...set_fair_dbs(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_gt_sriov_pf_config_set_fair_dbs

okay bestie, so this is a page straight out of the Kernel API Manual (yes, the kernel has lore too) and it's about one very specific lil function. sit down, hydrate, let's go 🫶

✨ NAME ✨

xe_gt_sriov_pf_config_set_fair_dbs — Provision many VFs with fair GuC doorbell IDs.

like… it's handing out doorbells 🛎️ (GuC ones, not your ring camera) to a whole squad of VFs, and it's doing it fairly, which is the whole vibe.

🌸 SYNOPSIS 🌸

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

that's it. that's the signature. she's an int returning icon 💅

🎀 ARGUMENTS 🎀

  • gt — the xe_gt. literally just… the gt. the graphics tile in question, the main character of this whole operation 🦋
  • vfid — starting VF identifier. ⚠️ can't be 0 — like, do not even try it, that's not a valid starting point
  • num_vfs — number of VFs to provision. ⚠️ can't be 0 either — you can't provision zero VFs, that's giving nothing, that's an empty group chat 💀

🔥 DESCRIPTION 🔥

This function can only be called on PF.

that's it. that's the whole description. one (1) sentence. she said what she said and she left 👑 (PF = physical function, if you were wondering, but the manpage didn't say that so I'm just saying it in a whisper, iykyk)

🚨 lowkey important: only on PF. not VF. not "maybe". PF. don't test her.

⭐ RETURN ⭐

  • 0 on success — slay, we love a clean zero 🙌
  • a negative error code on failure — the classic kernel "nope" 😭 it's negative, so you know something went sideways

🌈 SEE ALSO 🌈

okay this is the part where she lists her entire friend group. buckle up, there are SO many. every single one is here, no cap, nobody left behind 💖

like I said. the whole friend group. they all ate 💅✨

sign-off bestie 🧚: this page lives in ./drivers/gpu/drm/xe and it's dated October 2026, filed under xe_gt_sriov_...set_fair_dbs(9) — yes the title got abbreviated with ... and yes she still slayed. bye ily, go provision some doorbells fairly 💜🦋
📦 where this page comes from