nvme_mi_adm...ility_groups(2)

✨ nvme_mi_adm...ility_groups(2) ✨

okay bestie, come sit with me 💖 this is a page from the libnvme API manual, and yes the title is genuinely truncated like that, nvme_mi_adm...ility_groups(2), because the real function name is a whole mouthful and the man page formatter gave up halfway. iconic behaviour tbh. we're talking about nvme_mi_admin_get_log_reachability_groups here 🦋

---

🌸 NAME 🌸

nvme_mi_admin_get_log_reachability_groups — Retrieve Reachability Groups Log 💅

like, it goes and grabs the log page that tells you about reachability groups. that's the whole serve. periodt.

---

🎀 SYNOPSIS 🎀

int nvme_mi_admin_get_log_reachability_groups (nvme_mi_ctrl_t ctrl ,
bool rgo , bool rae , __u32 len , struct nvme_reachability_groups_log
*log );

she's a int return, she takes five lil friends, and she does not text back. no cap. 🌈

---

🫶 ARGUMENTS 🫶

the five besties she needs before she'll even consider doing anything:

• ctrl — Controller to query. this is the controller you want the tea from, the main character of the operation 👑
• rgo — Return groups only. a bool, so it's just a yes-or-no vibe check: groups only, or… more than groups only 🙈
• rae — Retain asynchronous events. another bool. flip it on if you want those async events kept around instead of cleared ✨
• len — The allocated length of the log page. a __u32, so she wants to know exactly how much room you've given her to write into. give her the real number, don't guess, fr fr 💀
• log — User address to store the log page. a pointer to a struct nvme_reachability_groups_log, i.e. where the log page is gonna land when it comes home 🏡

---

⭐ RETURN ⭐

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

so basically: if the controller answered you, you get back the nvme command status — go look it up in enum nvme_status_field, that's where all the lore lives 📖 — and if it did not answer, you get a big fat -1 and errno gets set so you can find out why. she's not being mysterious, she's just following protocol 😭

---

and that's the whole page bestie! you ate this 💖 no notes, 10/10, the reachability groups are reached ✨

that was nvme_mi_adm...ility_groups(2) from the libnvme API manual, dated July 2026, and in the footer she signs off as nvme_mi_admin_get_log_reachabil... because even the footer ran out of room 😭🫶 slay, goodbye, go query a controller 🎀🦋🌸