LIBNVME_GET_NEW_HOST_TELEMETRY-LIBNVME3(2)

📦 version 3.2, in arch rolling

💫 libnvme_get_...st_telemetry(9) — like, the libnvme API manual, bestie 💫

okay so bestie, listen — this is libnvme_get_new_host_telemetry, and it's giving "grab me the fresh host telemetry log" energy. no cap, it's a whole function. the manpage manual name is libnvme API manual (iykyk) and it lives in section 9 of the libnvme API manuals. let's go 🫶

✨ NAME ✨

libnvme_get_new_host_telemetry — Get new host telemetry log

like literally that's it. that's the whole vibe. it gets you the new host telemetry log. 💅

🦋 SYNOPSIS 🦋

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

four args, one int return. iconic. 🎀

🌸 ARGUMENTS 🌸

  • hdl — Transport handle. it's your transport handle, bestie. the whole connection situation. hold it gently. 💖
  • log — On success, set to the value of the allocated and retrieved log. so like, the function allocates it AND retrieves it AND hands it to you through this pointer. main character behavior honestly. ✨
  • da — Log page data area. valid values: enum nvme_telemetry_da. that's the data area you're asking for — pick from that enum, don't freestyle it. 🙈
  • size — Ptr to the telemetry log size, so it can be returned. yes girl, it's a pointer, because the size comes BACK to you. you give it a place to write, it writes the size there. periodt. 💅

🔥 DESCRIPTION 🔥

so the total size allocated can be calculated as:

(nvme_telemetry_log da size + 1) * NVME_LOG_TELEM_BLOCK_SIZE

that's the formula, fr fr. (nvme_telemetry_log da size + 1) * NVME_LOG_TELEM_BLOCK_SIZE. the way that it's just da size plus one, times the block size — ate. 🔥

it allocates, it retrieves, it tells you the size. no notes. ⭐

👑 RETURN 👑

  • 0 on success — slay 💖
  • the nvme command status if a response was received — see enum nvme_status_field
  • a negative error otherwise — 😭

so like: zero is good, positive-ish command status means the command actually came back with something (check that enum), and negative means it did not go well. ngl, keep an eye on it. 💀

🌈 SEE ALSO 🌈

the manpage doesn't list any SEE ALSO refs, bestie — so there's nothing to link here, and I'm not gonna invent one. 🧚

and that's the whole page! 🍓 this lil beauty is from the libnvme API manual, dated October 2026, and the footer thingy goes libnvme_get_...st_telemetry(9) — see you in the group chat, mwah 💜🫶🎀

📦 where this page comes from