nvme_identi...ated_ns_list(2)

💖 nvme_identify_allocated_ns_list — bestie edition ✨

okay so this lil function lives in the libnvme API manual and it's literally called nvme_identify_allocated_ns_list, and yes the man page header tried to abbreviate it as nvme_identi...ated_ns_list(2) bc it's a whole mouthful, but we're gonna say the whole thing, periodt. 🎀

---

✨ NAME ✨

nvme_identify_allocated_ns_list — Retrieves allocated namespace id list 🦋

---

🌸 SYNOPSIS 🌸

int nvme_identify_allocated_ns_list (int fd , __u32 nsid , struct
       nvme_ns_list *list );

like. look at her. three args, one int coming back. iconic.

---

💅 ARGUMENTS 💅

• fd — the file descriptor of your nvme device, bestie. this is your whole ticket in. 🎟️
• nsid — Return namespaces greater than this identifier. yes, greater than. strict vibes only, no equals allowed. 👑
• list — User space destination address to transfer the data. that's where the goodies land. ✨

---

🫶 DESCRIPTION 🫶

A list of 1024 namespace IDs is returned to the host containing NSIDs in increasing order that are greater than the value specified in the Namespace Identifier (nsid) field of the command. so it's sorted, it's ascending, and it's strictly above your nsid. no cap. 🔥

See struct nvme_ns_list for the definition of the returned structure — go look at the struct if you wanna know what shape the tea comes in. 💜

---

🌈 RETURN 🌈

The nvme command status if a response was received (see enum nvme_status_field) or -1 with errno set otherwise. so like: either you get a real status back, or you get a <red>-1</red> and errno is doing the talking. 🫠

lowkey important: <red>-1</red> alone tells you nothing — the actual story is in errno, so check it, bestie. 😭

---

and that's the whole page!! 💖

sign-off time: this lil beauty comes from the libnvme API manual, dated July 2026, and the footer was out here doing the absolute most with nvme_identify_allocated_nsnvme_identi...ated_ns_list(2) (yes it ran the title and the footer together with zero space, we don't judge, we just notice 💀). anyway — go read that namespace list, you absolute main character. 🎀✨🦋