xe_gt_sriov_...bulk_set_dbs(9)

📦 version 7.3.1, in nixpkgs unstable

🎀 xe_gt_sriov_...bulk_set_dbs (9) — Kernel API Manual 🎀

okay so bestie, welcome to the Kernel API Manual page for xe_gt_sriov_...bulk_set_dbs(9). yes the title is a whole mouthful, yes it abbreviates the middle, and yes you're gonna understand it. sit down, hydrate, let's go 💅

✨ NAME ✨

xe_gt_sriov_pf_config_bulk_set_dbs — provision many VFs with GuC context IDs. not one, not two, many. like a bulk order. iconic behavior fr fr 👑

🦋 SYNOPSIS 🦋

int xe_gt_sriov_pf_config_bulk_set_dbs (struct xe_gt *gt , unsigned int
vfid , unsigned int num_vfs , u32 num_dbs );

yes it returns an int, yes there are four args, no you cannot skip any of them. 🫶

🌸 ARGUMENTS 🌸

  • gt — the xe_gt. that's it, that's the arg. the graphics tile herself 💖
  • vfid — starting VF identifier. and listen: it can't be 0. like, do not pass 0. that's the one rule 🚫
  • num_vfs — how many VFs you wanna provision. the "bulk" in bulk_set. 📦
  • num_dbs — the requested number of GuC doorbell IDs. and heads up, 0 means release — so passing zero isn't "do nothing", it's "give 'em back" 🙈

💜 DESCRIPTION 💜

This function can only be called on PF. that's a hard requirement, not a suggestion. PF only, no cap 🔥

⚠️ lowkey important: calling it on anything that isn't the PF is just not a thing this function does. PF. only. periodt.

⭐ RETURN ⭐

0 on success, or a negative error code on failure. two moods and you will know which one you got 💀

🌈 SEE ALSO 🌈

okay this list is long and we are keeping every single one of them because I'm not out here disrespecting the whole config source file. here we go, deep breath 🧚

all 55 of them, accounted for, nobody left behind 🫶✨

and that's the whole page bestie!! this one lives over in ./drivers/gpu/drm/xe and it's stamped October 2026 — so yeah, future-dated lore, we love that for us 💖 go provision those doorbells responsibly, and remember: PF only, vfid ≠ 0, and num_dbs = 0 means release, not ignore. mwah 🎀🌟

📦 where this page comes from