nvme_ctrl_first_ns(2)

✨ nvme_ctrl_first_ns ✨

okay bestie, welcome to the libnvme API manual — this one lives in section 2, and yes it's the lil function that kicks off your namespace iterator. it's giving "start of the scavenger hunt" energy 🎀

---

🦋 NAME 🦋

nvme_ctrl_first_ns — start namespace iterator 💅

like. that's it. that's the whole job. she starts the iterator. periodt.

---

🌸 SYNOPSIS 🌸

nvme_ns_t nvme_ctrl_first_ns (nvme_ctrl_t c );

so you hand her a controller, she hands you back the very first namespace. no cap, it's a one-liner and she ate. 🔥

---

💖 ARGUMENTS 💖

• c — controller instance. this is your controller, your main character, the thing you're iterating over. you bring the controller, she brings the iterator. 🫶

---

⭐ RETURN ⭐

the first nvme_ns_t object of an c iterator 🌈

lowkey important: she's returning the first one. if you want the rest of them, that's a whole other iterator journey, bestie — this function is literally just the "once upon a time" of your namespace story. 💀

---

🧚 that's a wrap 🧚

this page came straight out of the libnvme API manual, dated July 2026, and it's filed under nvme_ctrl_first_ns in section nvme_ctrl_first_ns(2). go forth and iterate, queen 👑🌸