GUC SCHEDULING POLICIES KLVS(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… GuC SCHEDULING POLICIES KLVs πŸ’…

okay bestie so this is a page straight out of the Kernel API Manual (section 9, we're fancy like that ✨) and it's all about the scheduling policy KLVs for the GuC. tiny page, but honestly? iconic. let's get into it 🫢


🌸 NAME 🌸

GuC Scheduling Policies KLVs β€” literally what it says on the tin, bestie πŸ’–


✨ DESCRIPTION ✨

these are the GuC KLV_ keys you can use with UPDATE_SCHEDULING_POLICIES_KLV. that's it. that's the whole vibe. but wait, there's one key and it's kind of a big deal πŸ‘‘


πŸŽ€ THE KLV KEYS πŸŽ€

  • GUC_KLV_SCHEDULING_POLICIES_RENDER_COMPUTE_YIELD : 0x1001 β€” okay so here's the tea 🍡: some platforms will not let RCS and CCS workloads from different address spaces run at the same time. and by default, the GuC is out here prioritizing RCS submissions over CCS ones, which means CCS workloads can get significantly (or, like, completely 😭) starved of execution time. not cute.

so this KLV lets the driver hand over a quantum (in ms) and a ratio (a percentage value between 0 and 100), and the GuC will prioritize the CCS for that percentage of each quantum.

lowkey obsessed with the example: if you specify 100ms and 30%, the GuC prioritizes the CCS for 30ms of every 100ms. slay 🌈

⚠️ but ngl, don't get it twisted β€” this does not necessarily mean the RCS and CCS engines will only be active for their percentage of the quantum. the restriction only kicks in if both classes are fully busy with non-compatible address spaces. iykyk. like, if one engine is idle or running the same address space, a pending job on the other engine will still be submitted to the HW no matter what the ratio is. periodt πŸ’…

πŸ‘€ SEE ALSO πŸ‘€

  • Kernel file ./drivers/gpu/drm/xe/abi/guc_klvs_abi.h
  • GuC KLV(9)
  • GuC Global Config KLVs(9)
  • GuC Self Config KLVs(9)
  • GuC Opt In Feature KLVs(9)
  • GuC VGT Policy KLVs(9)
  • GuC VF Configuration KLVs(9)
  • GuC Reserved KLVs(9)

and that's the whole page, bestie πŸ¦‹ shoutout to ./drivers/gpu/drm/xe/abi for holding it down, and mark your calendars for October 2026 because that's the version date πŸ’œ mwah, go read the other KLV pages, ily, bye πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from