NVME_IDENTIFY_ACTIVE_NS_LIST_CSI(2)

✨ NAME ✨

nvme_identify_active_ns_list_csi — bestie, this one hands you the list of active namespace IDs that belong to a specific I/O command set 👑

This is page nvme_identify_active_ns_list_csi(2) from the libnvme API manual btw, so you already know it's official.

---

🌸 SYNOPSIS 🌸

int nvme_identify_active_ns_list_csi (int fd , __u32 nsid , enum
       nvme_csi csi , struct nvme_ns_list *ns_list );

okay so like — one function, four things going in, an int coming out. no drama 💅

---

🎀 ARGUMENTS 🎀

• fd — the file descriptor of your nvme device. the lil handle that says "yes, this drive" 🫶
• nsid — return namespaces greater than this identifier. so it's giving "start after this one, please."
• csi — the Command Set Identifier. which I/O command set we're vibing with 🌈
• ns_list — user space destination address where the data gets transferred to. that's where the goodies land ✨

---

💖 DESCRIPTION 💖

So here's the tea, bestie: a list of 1024 namespace IDs gets returned to the host, and it contains the active NSIDs in increasing order that are greater than the value you dropped in the Namespace Identifier (nsid) field of the command 🦋

AND (this part matters) they also have to match the I/O Command Set that you specified in the csi argument. no matching, no entry, periodt.

and if you wanna know exactly what shape the returned structure is — like, the actual receipt — go peek at struct nvme_ns_list for the definition of what comes back 📋

---

⭐ RETURN ⭐

Here's what you get back:

• the nvme command status if a response was actually received (go look at enum nvme_status_field for the full menu of statuses) 💚
• or -1 with errno set, otherwise. yeah. that one. the "something went sideways" special 💀

not me being emotionally attached to a return value but fr fr, check errno when you see that -1.

---

💜 SEE ALSO 💜

hmm, the original page keeps its SEE ALSO energy inside the description — so clock struct nvme_ns_list and enum nvme_status_field as your two referenced icons here 👑 go read those next, iykyk.

---

okay that's the whole page!! go forth and identify those namespaces, you absolute main character 🌟

this was the libnvme API manual — page nvme_identify_active_ns_list_csi(2), dated July 2026 🎀

mwah, love u, bye 💅✨