libnvme_get_host_telemetry(9)

💖 libnvme_get_host_telemetry — get host telemetry log 💖

okay so bestie, this one's from the libnvme API manual and it's genuinely so useful — it's how you pull the host telemetry log. let's get into it 🫶

---

✨ SYNOPSIS ✨

int libnvme_get_host_telemetry (struct libnvme_transport_handle *hdl ,
struct nvme_telemetry_log **log , enum nvme_telemetry_da da , size_t
*size );

---

🎀 ARGUMENTS 🎀

• hdl — your transport handle, aka the little passport that lets you talk to the device 🛂
• log — on success, this gets set to the value of the allocated and retrieved log. so like, you hand it a pointer-to-pointer and it fills in the goods ✨
• da — the log page data area. valid values: enum nvme_telemetry_da 📋
• size — a ptr to the telemetry log size, so it can be returned back to you. very giving of it 💅

---

🌸 DESCRIPTION 🌸

so the total size that gets allocated can be calculated as:

(nvme_telemetry_log da size + 1) * NVME_LOG_TELEM_BLOCK_SIZE

that's literally the whole formula, no cap. 🧮

---

⭐ RETURN ⭐

• 0 on success 🎉
• the nvme command status if a response was received (see enum nvme_status_field)
• or a negative error otherwise 😭

ngl bestie, always check that return value — a 0 is your slay moment, anything else means go read the status field.

---

and that's the whole page, periodt 💅

🌈 cute little sign-off: this page is from the libnvme API manual, dated October 2026. go forth and telemetry, queen 👑🦋