NVME_NAMESPACE_DETACH_CTRLS(2)

✨ nvme_namespace_detach_ctrls ✨

okay bestie, so this one lives in the libnvme API manual, section 2 of the man pages (that's the syscalls/API girlies section, iykyk 💅). And literally the whole vibe of this function is in its name: nvme_namespace_detach_ctrls — it detaches a namespace from one or more controllers. She's breaking up with them. Not me writing a function whose entire job is a situationship ending 😭

---

🌸 NAME 🌸

nvme_namespace_detach_ctrls — detach namespace from controller(s) 💔

---

🦋 SYNOPSIS 🦋

int nvme_namespace_detach_ctrls (int fd , __u32 nsid , __u16 num_ctrls ,
       __u16 *ctrlist );

---

🎀 ARGUMENTS 🎀

• fd — the file descriptor of the nvme device. your little portal to the drive, your golden ticket, your main character entry point 👑
• nsid — the Namespace ID you're detaching. this is the one getting the goodbye text fr
• num_ctrls — how many controllers are in ctrlist. you gotta count them yourself, she's not psychic ✨
• ctrlist — the list of controller IDs that are getting the detach action performed on them. a whole roster of breakups 🫶

---

💜 RETURN 💜

It hands back the nvme command status if a response was actually received — peep enum nvme_status_field for the deets on that — or -1 with errno set if it wasn't. so either you get a status, or you get a -1 and errno doing the emotional labor of telling you what went wrong 😭

heads up babes: that -1 + errno combo is the "something went sideways before/without a response" path — check errno before you start spiraling 💀

---

that's the whole page bestie, no cap, every flag and every word of the original is right here 💖

signing off from the libnvme API manual, this was the July 2026 edition, nvme_namespace_detach_ctrls(2) page, section 2 — slay, go detach those controllers, periodt 🌈⭐🦋💅