XE GT THROTTLE(9)

📦 version 7.3.1, in nixpkgs unstable

✨ Xe GT Throttle 💅 (section 9)

okay bestie, welcome to Xe GT Throttle(9) from the Kernel API Manual — yes that's the manual name, and yes it's giving "graphics driver lore" 🎀

🦋 DESCRIPTION 🦋

so like, the GT frequency can get throttled by hardware/firmware for a whole bunch of reasons, and those reasons get handed to you as attributes living under the freq0/throttle/ directory. Whether each one actually shows up is platform-dependent — some attributes just won't be visible if that particular reason isn't available on your hardware. no cap, it's a vibe check per-platform 💅

the reasons attribute is the one a sysadmin wants to monitor all the possible throttling reasons and report them. it is preferred over monitoring status and then reading the reason from the individual attributes, because doing it that way is racy 😭 (fr fr, don't do the racy thing). and if there's no throttling happening at all, "none" is returned. slay.

🏝️ Crescent Island platform 🏝️

the following attributes are available on the Crescent Island platform:

  • status — overall throttle status (0: no throttling, 1: throttling)
  • reasons — array of reasons causing throttling, separated by space
  • reason_pl1 — package PL1
  • reason_pl2 — package PL2
  • reason_pl4 — package PL4
  • reason_prochot — prochot
  • reason_soc_thermal — SoC thermal
  • reason_mem_thermal — Memory thermal
  • reason_vr_thermal — VR thermal
  • reason_iccmax — ICCMAX
  • reason_pwrbrk — Power brake
  • reason_soc_avg_thermal — SoC average temp
  • reason_fastvmode — VR is hitting FastVMode
  • reason_psys_pl1 — PSYS PL1
  • reason_psys_pl2 — PSYS PL2
  • reason_p0_freq — P0 frequency
  • reason_psys_crit — PSYS critical

🌈 Other platforms 🌈

other platforms support the following reasons, iconic behavior honestly:

  • status — overall throttle status (0: no throttling, 1: throttling)
  • reasons — array of reasons causing throttling, separated by space
  • reason_pl1 — package PL1
  • reason_pl2 — package PL2
  • reason_pl4 — package PL4, Iccmax etc.
  • reason_thermal — thermal
  • reason_prochot — prochot
  • reason_ratl — RATL hermal algorithm
  • reason_vr_thermalert — VR THERMALERT
  • reason_vr_tdc — VR TDC

👀 SEE ALSO 👀

  • Kernel file ./drivers/gpu/drm/xe/xe_gt_throttle.c

and that's the whole page bestie 🫶 this masterpiece came to you from ./drivers/gpu/drm/xe, dated October 2026 — go read the source, it ate 💜⭐

📦 where this page comes from