libnvme_get_ana_log_atomic(9)

✨ libnvme_get_ana_log_atomic ✨

okay bestie, welcome to the libnvme API manual — this page is all about libnvme_get_ana_log_atomic(9), and no cap, the name literally tells you the whole vibe: grab the Asymmetric Namespace Access log page, and do it atomically. 🦋

---

💅 NAME 💅

libnvme_get_ana_log_atomic — retrieve the Asymmetric Namespace Access log page atomically 🎀

---

🌸 SYNOPSIS 🌸

int libnvme_get_ana_log_atomic (struct libnvme_transport_handle *hdl ,
bool rae , bool rgo , struct nvme_ana_log *log , __u32 *len , unsigned
int retries );

---

✨ ARGUMENTS ✨

• hdl — the transport handle. your main character pointer, your ride-or-die 🫶
• rae — whether to retain asynchronous events 👀
• rgo — whether to retrieve ANA groups only, like, no NSIDs at all 🙈
• log — pointer to a buffer that receives the ANA log page 💖
• len — input: the length of the log page buffer. output: the actual length of the ANA log page. literally a glow-up in both directions ✨
• retries — the maximum number of times to retry on log page changes 🔁

---

💜 DESCRIPTION 💜

See struct nvme_ana_log for the definition of the returned structure. that's the whole section, bestie, it's giving minimal and mysterious 💅

---

🔥 RETURN 🔥

If it slays: returns 0 and sets *len to the actual log page length ✅

If it does not slay: returns the nvme command status if a response was received (see enum nvme_status_field) or a negative error code otherwise 😭

And here's the errno tea, don't skip it:

• Sets errno = EINVAL if retries == 0 🚫
• Sets errno = EAGAIN if it's unable to read the log page atomically because chgcnt changed during each of the retries attempts 💀
• Sets errno = ENOSPC if the full log page does not fit in the provided buffer 📦

fr fr check your buffer size before you call this, ENOSPC is not the moment you want to be having 🌸

---

and that's the page, periodt 🎀 this was the libnvme API manual, from October 2026, covering libnvme_get_ana_log_atomic(9) — go forth and read that log page atomically, icon 👑💖