nvme_mi_adm...id_ctrl_list(2)

✨ nvme_mi_admin_identify_nsid_ctrl_list ✨

okay so bestie, this one lives in the libnvme API manual (section 2, the syscalls-and-friends girlies) and it is literally the glow-up you need when you want to ask a controller "hey, who's on your list for this namespace?"

---

🎀 NAME 🎀

nvme_mi_admin_identify_nsid_ctrl_list — Perform an Admin identify for a controller list with specific namespace ID 🦋

---

🌸 SYNOPSIS 🌸

int nvme_mi_admin_identify_nsid_ctrl_list (nvme_mi_ctrl_t ctrl , __u32 nsid , __u16 cntid , struct nvme_ctrl_list *list );

---

💅 ARGUMENTS 💅

• ctrl — the Controller you're sending this identify command to. she's the main character here, periodt 👑
• nsid — the Namespace identifier. which namespace are we talking about, bestie? ✨
• cntid — the Controller ID that says where the list should start. like, "begin the roll call at this ID" 🎤
• list — the list data to populate. you hand her an empty lil container and she fills it up 🫶

---

🌈 DESCRIPTION 🌈

Perform an Identify command, for the controller list for nsid, starting with IDs greater than or equal to cntid. no cap, that's the whole vibe — you give her a namespace and a starting controller ID, and she pulls the list from there onward 💖

Will return an error if the length of the response data (from the controller) is not a full NVME_IDENTIFY_DATA_SIZE, so id will be fully populated on success. like, it's all-or-nothing, she does NOT do half-populated data, that's giving unserious 🙈

⚠️ heads up bestie: if the response length isn't exactly NVME_IDENTIFY_DATA_SIZE, it's error o'clock. but on success? fully populated id. slay.

See: struct nvme_ctrl_list

---

⭐ RETURN ⭐

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

so like — real status if the controller actually answered, and if she ghosted you, it's -1 plus errno telling you why 😭

---

and that's the whole page, bestie, we ate and left no crumbs 🔥

July 2026 · libnvme API manual · nvme_mi_admin_identify_nsid_ctrl_list(2) — mwah, love u, go identify some controllers 💜🧚🌸