nvme_zns_report_zones(2)

✨ nvme_zns_report_zones — like, the zone gossip page 💖

okay bestie, welcome to the libnvme API manual 🌸 this one's called nvme_zns_report_zones(2) and it does exactly one iconic thing: it hands you back the whole list of zones. that's it. that's the serve. 👑

---

🦋 NAME

nvme_zns_report_zones — Return the list of zones 💅

---

🌈 SYNOPSIS

int nvme_zns_report_zones (int fd , __u32 nsid , __u64 slba , enum
       nvme_zns_report_options opts , bool extended , bool partial , __u32
       data_len , void *data , __u32 timeout , __u32 *result );

like look at that signature. ten whole parameters. she's got range, fr fr. 💜

---

🎀 ARGUMENTS

here's the rundown, no cap, every single one explained:

• fd — File descriptor of nvme device. this is your lil hall pass into the device, you gotta have it ✨
• nsid — Namespace ID. which namespace we're talking to, bestie 🦋
• slba — Starting LBA. where you wanna start the zone roll call from 🌸
• opts — Reporting options. all the little knobs and dials, it's giving enum nvme_zns_report_options energy 💅
• extended — Extended report. want the extra extended version? say yes here 👑
• partial — Partial report requested. just a lil taste of the report, not the whole thing 🙈
• data_len — Length of the data buffer. how much room you're giving her to write into 🎀
• data — Userspace address of the report zones data. this is where the actual zone list lands, the main character buffer ⭐
• timeout — timeout in ms. how long we're willing to wait before we're like... ok girl wrap it up 💀
• result — The command completion result from CQE dword0. the receipt, basically 🧚

---

🔥 RETURN

so here's what you get back:

• the nvme command status if a response was received (peep enum nvme_status_field for the deets, iykyk) 💖
• -1 with errno set otherwise. yeah. she said "no" and left a note 😭

literally always check your errno when you get the -1, bestie. it's not gonna tell you why otherwise. 🙈

---

and that's the whole page!! no extra sections hiding anywhere, i checked twice 🌸 this was the nvme_zns_report_zones page from the libnvme API manual, dated July 2026 — that's the source, that's the version, that's the whole vibe 💜🦋✨ periodt.