nvme_identify_ns_descs(2)

💖 nvme_identify_ns_descs(2) 💖

okay bestie, so this is a page from the libnvme API manual, and it's all about nvme_identify_ns_descs — literally the function that goes and gets you the namespace descriptor list. yeah. she's giving ✨storage-core realness✨ and we're gonna walk through her together, no cap.

---

🌸 NAME 🌸

nvme_identify_ns_descs — Retrieves namespace descriptor list

---

🎀 SYNOPSIS 🎀

int nvme_identify_ns_descs (int fd , __u32 nsid , struct nvme_ns_id_desc
*descs );

---

🦋 ARGUMENTS 🦋

• fd — File descriptor of nvme device
• nsid — The namespace id to retrieve descriptors
• descs — User space destination address to transfer the data

---

💅 DESCRIPTION 💅

So like, here's the vibe: a whole list of Namespace Identification Descriptor structures gets returned to the host for the namespace you named in the Namespace Identifier (NSID) field — but only if it's an active NSID. not active? not your moment, sorry babe. 🙈

The data that comes back? It's in the form of an array of struct nvme_ns_id_desc. an array. of structs. she contains multitudes. 💜

Go peek at struct nvme_ns_id_desc for the definition of the returned structure — that's where the actual shape of the thing lives, iykyk.

---

⭐ RETURN ⭐

The nvme command status if a response was received (see enum nvme_status_field) or -1 with errno set otherwise.

like, either you got your answer or you got a -1 and an errno to go read. no in-between. periodt. 💀

---

aight that's the whole page, bestie — she's short, she's sweet, she's iconic. 👑

nvme_identify_ns_descs — libnvme API manual — July 2026 🫶✨