STRUCT GTH_DEVICE(9)

💅 struct gth_device(9) — the Kernel API Manual glow-up

okay bestie, welcome to the struct gth_device(9) page from the Kernel API Manual — yes that's the manual name, it's giving "official", it's giving "read me before you touch the GTH" 🎀

---

✨ NAME ✨

struct gth_device — literally the GTH device struct, that's the whole vibe 💜

---

🌸 SYNOPSIS 🌸

struct gth_device {
    struct device           *dev;
    void __iomem            *base;
    struct attribute_group  output_group;
    struct attribute_group  master_group;
    struct gth_output       output[TH_POSSIBLE_OUTPUTS];
    signed char             master[TH_CONFIGURABLE_MASTERS + 1];
    spinlock_t gth_lock;
 };

look at her. iconic. no cap, every one of those members matters, so let's go through them one by one 🫶

---

👑 Members 👑

• dev — the driver core's device 🧚 that's the big one, the main character pointer.
• base — register window base address ⭐ like the address where the register window starts, periodt.
• output_group — attributes describing output ports 🌈 yes, the attributes that describe the output ports.
• master_group — attributes describing master assignments 💫 same energy, but for master assignments.
• output — output ports 🔥 straight up, the output ports.
• master — master/output port assignments 🦋 the assignments between master and output port, iykyk.
• gth_lock — serializes accesses to GTH bits 💅 a spinlock_t that keeps things from stepping on each other. she's the vibe check for GTH bit access, no cap.

---

🔍 SEE ALSO 🔍

bestie you have to check these out, they're all in the kernel file ./drivers/hwtracing/intel_th/gth.c:

• struct gth_output(9)
• intel_th_gth_stop(9)
• intel_th_gth_start(9)
• intel_th_gth_disable(9)
• intel_th_gth_enable(9)
• intel_th_gth_switch(9)
• intel_th_gth_assign(9)
• intel_th_gth_unassign(9)

like, the whole friend group fr fr 💖

---

okay that's the page!! mwah 💋 this little beauty lives in ./drivers/hwtracing/intel_th and the version stamp says October 2026 — so mark your calendar bestie, slay 🌟👑