nvme_get_log_smart(2)

💖 nvme_get_log_smart — bestie edition 💖

okay so this is a page from the libnvme API manual, and it's about nvme_get_log_smart(2), aka the lil function that goes and grabs the SMART log off your NVMe device. pull up a chair, we're doing this ✨

---

🌸 NAME 🌸

nvme_get_log_smart — retrieve nvme smart log 🩺✨ like, it's literally the health check but for your drive, no cap.

---

🎀 SYNOPSIS 🎀

int nvme_get_log_smart (int fd , __u32 nsid , bool rae , struct
nvme_smart_log *smart_log );

she takes four things and gives you back an int. that's the whole vibe.

---

🦋 ARGUMENTS 🦋

• fd — the file descriptor of the nvme device 💅 this is your main character, your entry point, the one who knocks.
• nsid — optional namespace identifier 🫶 optional!! she's not mandatory, she's a choice.
• rae — retain asynchronous events 👑 you're telling it whether to hold onto those async events or not.
• smart_log — user address to store the smart log 📝 this is where the tea gets poured. hand it a place to put the results and it will fill it.

---

🌈 DESCRIPTION 🌈

so this log page is giving SMART and general health information 🩺💖 the info it hands you is over the life of the controller and — important — it's retained across power cycles. so even if you yeet the power, that history stays. iconic behavior honestly.

to request the controller log page, the namespace identifier you specify is FFFFFFFFh ⭐ that's the magic one, the "give me the whole controller" move, iykyk.

the controller may also support requesting the log page on a per namespace basis — whether it does is indicated by bit 0 of the LPA field in the Identify Controller data structure 🔍 so like. check that bit before you assume, bestie.

---

💀 RETURN 💀

what you get back is the nvme command status if a response was received (see enum nvme_status_field) 🫶

or, and this is the not-fun one, -1 with errno set otherwise 😭 so if you see -1, go check errno, that's where the actual drama is.

---

lowkey a whole vibe: this function is just "hey controller, how are you feeling" and the controller replies in a struct. we love a healthy drive. we do NOT love a -1. periodt.

---

and that's the page, babe 💜 brought to you by libnvme API manual, nvme_get_log_smart, dated July 2026 🌙 stay healthy, keep your FFFFFFFFh close, and always close your file descriptors 🎀✨