STRUCT _THERMAL_STATE(9)

💅 struct _thermal_state(9)

okay bestie, so this is a page from the Kernel API Manual — yep, the kernel has its own manual and she's serving struct realness ✨

---

🎀 NAME 🎀

struct _thermal_state — the whole vibe of "what's my CPU's thermal situation rn" in one struct, literally the current thermal event state 👑

---

✨ SYNOPSIS ✨

struct _thermal_state {
    u64 next_check;
    u64 last_interrupt_time;
    struct delayed_work     therm_work;
    unsigned long           count;
    unsigned long           last_count;
    unsigned long           max_time_ms;
    unsigned long           total_time_ms;
    bool rate_control_active;
    bool new_event;
    u8 level;
    u8 sample_index;
    u8 sample_count;
    u8 average;
    u8 baseline_temp;
    u8 temp_samples[3];
 };

no cap, that's the whole thing. sixteen fields of pure thermal lore 🫶

---

💖 Members 💖

okay so let's go through her field by field, iykyk:

• next_check — holds the next timestamp, which is when it's actually allowed to log the next warning message. like a "girl, not yet" timer ⏰
• last_interrupt_time — holds the timestamp for the last threshold high event. the receipts of when things got spicy 🔥
• therm_work — the delayed workqueue structure. that's it, that's her job 🧚
• count — holds the current running count for thermal or power threshold interrupts 📊
• last_count — holds the previous running count for thermal or power threshold interrupts. the before picture 🎬
• max_time_ms — shows the maximum amount of time the CPU was in a throttled state for a single thermal threshold high-to-low state. the worst single glow-down 😮‍💨
• total_time_ms — the cumulative time during which the CPU was in the throttled state. all the throttling, added up, together, as a family 💀
• rate_control_active — set when a throttling message is logged. this exists for the purpose of rate-control. she's the "bestie we already said that" flag 🙈
• new_event — stores the last high/low status of THERM_STATUS_PROCHOT or THERM_STATUS_POWER_LIMIT. status check, bestie ✅
• level — stores whether this _thermal_state instance is for a CORE level or for PACKAGE level. main character energy vs. group chat energy, essentially 👑
• sample_index — the index for storing the next sample in the buffer temp_samples[]. where the next lil temp reading goes 🎀
• sample_count — total number of samples collected in the buffer temp_samples[]. how many we got so far, fr fr 🔢
• average — the last moving average of temperature samples. the smoothed-out vibe check 🌡️
• baseline_temp — the temperature at which the thermal threshold high interrupt was generated. the origin story of the drama ⭐
• temp_samples — storage for temperature samples used to calculate the moving average. a whole lil array comin' through 🌈

---

🦋 Description 🦋

so this structure is used to represent data related to thermal state for a CPU. and like — here's the cute part — there's a separate storage for core level and package level for each CPU. so every CPU gets both a core-flavored one and a package-flavored one. slots for days 💅

bestie note: this is just a description of what the struct holds — the manpage isn't making promises about behaviour beyond that, so don't come for me if you assumed extra 👀

---

🌸 SEE ALSO 🌸

• Kernel file ./drivers/thermal/intel/therm_throt.c — go read the source, she ate 💖

---

and that's the page, bestie! this one's from ./drivers/thermal/intel, dated October 2026 — so like, future slay 🦋✨ periodt.