nvme_get_telemetry_log(2)

✨ nvme_get_telemetry_log — the libnvme API manual, section 2, bestie ✨

okay so picture this: you're deep in libnvme, it's giving firmware engineer, and you need the telemetry log. that's literally what this function is for. welcome to nvme_get_telemetry_log(2), no cap 💖

---

🌸 NAME 🌸

nvme_get_telemetry_log — get the specified telemetry log. yes queen, that's the whole job 🎀

---

🦋 SYNOPSIS 🦋

int nvme_get_telemetry_log (int fd , bool create , bool ctrl , bool rae
, size_t max_data_tx , enum nvme_telemetry_da da , struct
nvme_telemetry_log **log , size_t *size );

eight arguments. EIGHT. she's high maintenance but she's worth it 💅

---

✨ ARGUMENTS ✨

• fd — the file descriptor of your nvme device. your main character 🫶
• create — generate a new host initated telemetry capture. yes, the typo is in the original, we don't judge, we just vibe 😭
• ctrl — get the controller initiated log. the classic 💜
• rae — retain asynchronous events. hold onto them bestie, don't let go ✨
• max_data_tx — set the max data transfer size to be used when retrieving telemetry. basically a speed limit but make it chic 🌈
• da — log page data area. valid values: enum nvme_telemetry_da. pick wisely, she's picky 👑
• log — on success, set to the value of the allocated and retrieved log. two-for-one, we love that 🍓
• size — ptr to the telemetry log size, so it can be returned. she's just here to hand you numbers 📏

---

💖 DESCRIPTION 💖

the total size allocated can be calculated as:

(nvme_telemetry_log da size + 1) * NVME_LOG_TELEM_BLOCK_SIZE

that's it. that's the math. do it, iykyk 🧮✨

---

🎀 RETURN 🎀

you get the nvme command status if a response was received (see enum nvme_status_field), or -1 with errno set otherwise. so either she answers you or she ghosts you with an errno. brutal. iconic. 💀

---

reminder bestie: -1 means check errno, always. don't be out here guessing, that's not the vibe 🙈

---

and that's the whole page, we ate, no crumbs left 🌸 thanks for reading the libnvme API manual, nvme_get_telemetry_log(2), dated July 2026 — go forth and capture that telemetry, you absolute legend 💅🦋