nvme_get_ana_log_atomic(2)

✨ nvme_get_ana_log_atomic ✨

okay bestie, tiny vibe check first: this is a page from the libnvme API manual, section 2, and it's all about grabbing the Asymmetric Namespace Access log page atomically. literally that's the whole personality. let's get into it 💅

---

🌸 NAME 🌸

nvme_get_ana_log_atomic — retrieve the Asymmetric Namespace Access log page, but do it atomically. no half-baked log pages in this house ✨

---

🦋 SYNOPSIS 🦋

int nvme_get_ana_log_atomic (int fd , bool rgo , bool rae , unsigned int
retries , struct nvme_ana_log *log , __u32 *len );

---

💖 ARGUMENTS 💖

• fd — the file descriptor of your nvme device. your portal, your connection, your girl 🫶
• rgo — a bool that says whether to retrieve ANA groups only (like, no NSIDs, just the groups, keep it simple)
• rae — a bool that says whether to retain asynchronous events
• retries — the maximum number of times to retry when the log page keeps changing on you 😭 (yes, this one matters a LOT, see RETURN)
• log — pointer to a buffer that receives the ANA log page
• len — this one is doing double duty, iconic honestly: on the way in it's the length of the log page buffer, and on the way out it's the actual length of the ANA log page 🌈

---

🎀 DESCRIPTION 🎀

See struct nvme_ana_log for the definition of the returned structure. that's the tea, go look at the struct 💜

---

👑 RETURN 👑

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

If it does NOT slay: returns the nvme command status if a response was received (see enum nvme_status_field), or -1 with errno set otherwise.

And now the errno lore, because she's specific:

- Sets errno = EINVAL if retries == 0. bestie. you can't retry zero times, that's not a thing 😭 - Sets errno = EAGAIN if it's unable to read the log page atomically because chgcnt changed during each of the retries attempts. she tried, she really did, and it kept changing 💀 - Sets errno = ENOSPC if the full log page does not fit in the provided buffer. your buffer said no room at the inn 🙈

---

that's the whole page, no cap 🧚 this one came from the libnvme API manual, dated July 2026 — so when you see nvme_get_ana_log_atomic(2) floating around your terminal, that's her, that's the girl 💖 mwah, go read your ANA logs atomically 🎀