libnvme(9)

💖 libnvme(9) — API Manual 💖

okay bestie, welcome to the libnvme API manual, section 9, and today's main character is a lil struct that carries all your vibes into the NVMe Identify command. she's not complicated, she's just thorough. let's go 🦋

---

✨ NAME ✨

struct nvme_identify_args — the arguments you hand over for the NVMe Identify command. that's it, that's the whole job, and she does it flawlessly 💅

---

🌸 SYNOPSIS 🌸

struct nvme_identify_args {
    __u32 *result;
    void *data;
    int args_size;
    int fd;
    __u32 timeout;
    enum nvme_identify_cns cns;
    enum nvme_csi csi;
    __u32 nsid;
    __u16 cntid;
    __u16 cns_specific_id;
    __u8 uuidx;
 };

look at her. eleven fields. not one of them extra. no cap 🎀

---

👑 Members 👑

okay so each field gets its own moment, because every single one of them matters:

• result — this is where the command completion result from CQE dword0 lands. your receipts, basically 🧾
• data — the user space destination address where the data gets transferred to. that's where the good stuff goes 💖
• args_size — the size of struct nvme_identify_args. she knows her own measurements, iconic ⭐
• fd — the file descriptor of the nvme device. your little portal to the hardware 🌀
• timeout — timeout in ms (and if you pass 0, you get the default timeout — she'll handle it, don't stress) ⏰
• cns — the Controller or Namespace structure. go check out enum nvme_identify_cns for the deets 👀
• csi — the Command Set Identifier 🎯
• nsid — the Namespace identifier, if applicable 🗂️
• cntid — the Controller Identifier, if applicable 🎮
• cns_specific_id — the identifier that's required for a particular cns value. yes, the name really is that long, she's specific and she owns it 💀
• uuidx — the UUID Index, but only if the controller supports this id selection method. conditional queen 🙈

---

ngl, if you're filling this struct in, double-check which fields actually apply to your cns value before you ship it. nsid, cntid and uuidx are all "if applicable" girlies 🫶

---

and that's the whole page, bestie — no notes, she ate 🔥

this was struct nvme_identify_args, from the libnvme(9) API Manual, dated August 2026 — mwah, go forth and identify some namespaces ✨💜