libnvme_get_telemetry_log(9)

💅 libnvme_get_telemetry_log — the libnvme API manual, bestie edition

okay so this is a page from the libnvme API manual and it's all about libnvme_get_telemetry_log(9) — literally the function that goes and gets you a telemetry log. yes, THE telemetry log. the one you asked for. 🎀

---

✨ NAME ✨

libnvme_get_telemetry_log — get the specified telemetry log. that's it. that's the whole vibe. grabbing logs, no cap. 🦋

---

🌸 SYNOPSIS 🌸

int libnvme_get_telemetry_log (struct libnvme_transport_handle *hdl ,
bool create , bool ctrl , bool rae , size_t max_data_tx , enum
nvme_telemetry_da da , struct nvme_telemetry_log **log , size_t *size );

look at all those parameters. she's got range. 🔥

---

💖 ARGUMENTS 💖

• hdl — the transport handle. your ✨connection✨ to everything, basically.
• create — generate a brand new host-initiated telemetry capture. fresh out of the oven, chef's kiss. 🍓
• ctrl — get the controller-initiated log instead. different log, different energy.
• rae — retain asynchronous events. yes ma'am, keep them. 💅
• max_data_tx — set the max data transfer size used when retrieving the telemetry. the ceiling. the limit. the "don't get too comfy" of it all.
• da — log page data area. valid values: enum nvme_telemetry_da. that's the whole list, i don't make the rules.
• log — on success, gets set to the value of the allocated and retrieved log. allocated AND retrieved. she does both. 👑
• size — ptr to the telemetry log size, so it can be returned to you. so thoughtful tbh. 🫶

---

🧚 DESCRIPTION 🧚

the total size allocated can be calculated as:

(nvme_telemetry_log da size + 1) * NVME_LOG_TELEM_BLOCK_SIZE

that's the math, bestie. literally just plug it in. ✨📐

---

🌈 RETURN 🌈

• 0 — success! we ate. 💅
• the nvme command status if a response was received — see enum nvme_status_field for the deets.
• a negative error otherwise. 😭 not the negative error.

---

fr fr, if you're getting a negative error, that's not a vibe check you passed. check your hdl and try again. 🫶

---

and that's the page!! brought to you by the libnvme API manual, dated October 2026, version libnvme_get_telemetry_log(9) — okay the footer got a little scrambled in the original, but you get it. mwah. 💜🎀 bye bestie, go fetch some telemetry logs!