pmt_telem_read(9)

💅 pmt_telem_read — like, the kernel manual, but make it make sense

okay bestie, welcome to pmt_telem_read(9) from the Kernel API Manual, section 9, no cap. this is the one that reads qwords out of counter sram using a sample id, and honestly? it's giving "short function, big responsibilities" 🎀

---

✨ NAME ✨

pmt_telem_read — read qwords from counter sram using the sample id 🧚

---

🌸 SYNOPSIS 🌸

int pmt_telem_read (struct telem_endpoint *ep , u32 id , u64 *data , u32 count );

---

🦋 ARGUMENTS 🦋

• ep — the telemetry endpoint you're reading from, that's the whole vibe of the call 💖
• id — the beginning sample id of the metric(s) you want read, like the starting point of the gossip
• data — an allocated qword buffer, you gotta bring your own container bestie, we just fill it
• count — how many qwords you're asking for, exactly how many, don't be greedy

---

👑 DESCRIPTION 👑

so here's the tea: callers must ensure reads are aligned — that's on you, not us. periodt. 🔥

and when the call returns -ENODEV, that means the device has been removed, and callers should unregister the telemetry endpoint. like, it's gone gone. go clean up your endpoint, bestie 😭

---

⭐ RETURN ⭐

• 0 — Success 💖 slay, the read worked, we ate
• -ENODEV — The device is not present. it left the chat 🙈
• -EINVAL — The offset is out bounds 💀 you asked for a spot that doesn't exist, awkward
• -EPIPE — The device was removed during the read. Data written but should be considered invalid. 🚨 so yes, bytes got written — but do not trust them, they're lowkey cursed, treat them as invalid fr fr

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/platform/x86/intel/pmt/telemetry.h — the source of truth, go read it iykyk
• pmt_telem_get_next_endpoint(9)
• pmt_telem_register_endpoint(9)
• pmt_telem_unregister_endpoint(9)
• pmt_telem_get_endpoint_info(9)
• pmt_telem_find_and_register_endpoint(9)
• pmt_telem_read32(9) — yeah there's a 32-bit one too, we're inclusive 🫶

---

gentle reminder bestie: if you get -EPIPE, the data is written but it's invalid — don't build your whole personality on it, okay? 🙈

---

and that's the whole page! 💜 this gem lives in ./drivers/platform/x86/intel/pmt, it's dated October 2026, and it's the pmt_telem_read(9) page. mwah, thanks for reading, go align your reads 🎀✨🌸