STRUCT TZ_EPISODE(9)

💖 NAME 💖 — struct tz_episode(9)

okay bestie, this is the manual page for struct tz_episode(9) from the Kernel API Manual — aka struct tz_episode, and the official one-liner is a mitigation episode information. It's giving “kernel-doc but make it fashion,” and we're gonna go through every single bit together. 🎀

🎀 SYNOPSIS 🎀

Here's the whole struct, copied exactly so there's no “wait, did she change a field?” moment:

struct tz_episode {
    ktime_t timestamp;
    ktime_t duration;
    struct list_head node;
    int max_temp;
    struct trip_stats trip_stats[];
};

💅 Members 💅

• timestamp — the first trip point crossed the way up. Like the moment the episode says “hello bestie, we're starting.” ✨
• duration — total duration of the mitigation episode. The full timer moment, no cap. ⏳
• node — a list element to be added to the list of tz events. It's the little link in the chain, main character energy for the list. 🔗
• max_temp — maximum zone temperature during this episode. The peak of the drama, temperature-wise. 🔥
• trip_stats — per trip point statistics, and it's a flexible array. Yes, flexible — she contains multitudes. 🦋

🌸 Description 🌸

The tz_episode structure describes a mitigation episode. A mitigation episode begins when the trip point with the lower temperature is crossed the way up, and it ends when it is crossed the way down. Internally: start low-key, end when we come back down, periodt. 💅

During this episode we can have multiple trip points crossed the way up and down if there are multiple trip described in the firmware after the lowest temperature trip point. That's the whole rule, bestie — no extra lore, no invented plot twists. 🫶

🦋 SEE ALSO 🦋

Kernel file: ./drivers/thermal/thermal_debugfs.c

• struct cdev_debugfs(9)
• struct cdev_record(9)
• struct trip_stats(9)
• struct tz_debugfs(9)
• struct thermal_debugfs(9)
• thermal_debug_cdev_state_update(9)
• thermal_debug_cdev_add(9)
• thermal_debug_cdev_remove(9)

okay that's the whole page, bestie 💖 this cutie signs off from source/version ./drivers/thermal, dated October 2026, and the manual title is still struct tz_episode(9). mwah 🎀