libnvme(2)

✨ libnvme — the enum nbft_host_flags era ✨

okay bestie, sit down, hydrate, because we're diving into libnvme(2) and honestly? it's giving "small enum, big feelings." this is the API manual page for enum nbft_host_flags, the little bundle of flags that lives inside a Host Descriptor and tells your OS some very important lore about who's who in the NBFT world. 💖

---

🌸 NAME 🌸

enum nbft_host_flags — Host Flags. that's it, that's the name, no notes. 💅

---

✨ SYNOPSIS ✨

here's the whole thing, looking all cute and structured:

enum nbft_host_flags {
    NBFT_HOST_VALID ,
    NBFT_HOST_HOSTID_CONFIGURED ,
    NBFT_HOST_HOSTNQN_CONFIGURED ,
    NBFT_HOST_PRIMARY_ADMIN_MASK ,
    NBFT_HOST_PRIMARY_ADMIN_NOT_INDICATED ,
    NBFT_HOST_PRIMARY_ADMIN_UNSELECTED ,
    NBFT_HOST_PRIMARY_ADMIN_SELECTED

};

seven constants. seven little icons. all of them flagging something about your Host Descriptor, no cap. 🦋

---

🎀 Constants 🎀

every single one, in order, with zero skips because we do NOT skip the boring parts in this house:

• NBFT_HOST_VALID — Descriptor Valid: if it's set to 1h, then this descriptor is valid, congratulations, it ate. if it's cleared to 0h, then this descriptor is reserved. so basically: 1h = main character, 0h = do not perceive. 👑
• NBFT_HOST_HOSTID_CONFIGURED — HostID Configured: if it's set to 1h, then the Host ID field contains an administratively-configured value. if it's cleared to 0h, then the Host ID field contains a driver default value. someone typed it in vs. the driver just showed up with whatever it had in its bag. 🤷♀️
• NBFT_HOST_HOSTNQN_CONFIGURED — Host NQN Configured: if it's set to 1h, then the Host NQN indicated by the Host NQN Heap Object Reference field (struct nbft_host.host_nqn) contains an administratively-configured value. if it's cleared to 0h, then the Host NQN indicated by the Host NQN Offset field contains a driver default value. nqn found either way, just depend on which vibe it's running. ✨
• NBFT_HOST_PRIMARY_ADMIN_MASK — Mask to get Primary Administrative Host Descriptor: this one indicates whether the Host Descriptor in this NBFT was selected as the primary NBFT for administrative purposes of platform identity as a hint to the OS. lowkey important, highkey a hint and not a decree. if multiple NBFT tables are present, only one NBFT should be administratively selected. there is no enforcement mechanism for this to be coordinated between multiple NBFT tables — the tables aren't talking to each other, bestie, there's no group chat — but this field should be set to Selected (#NBFT_HOST_PRIMARY_ADMIN_SELECTED) if more than one NBFT is present. 🫶
• NBFT_HOST_PRIMARY_ADMIN_NOT_INDICATED — Not Indicated by Driver: the driver that created this NBFT provided no administrative priority hint for this NBFT. it said nothing. silence. 🙈
• NBFT_HOST_PRIMARY_ADMIN_UNSELECTED — Unselected: the driver that created this NBFT explicitly indicated that this NBFT should not be prioritized over any other NBFT. explicit, not implied. it said "not me." 💀
• NBFT_HOST_PRIMARY_ADMIN_SELECTED — Selected: the driver that created this NBFT explicitly indicated that this NBFT should be prioritized over any other NBFT. pick me energy, but legally documented. 🔥

---

okay gentle reminder bestie: when they say a field is a "hint to the OS," that's literally what it is — there's no enforcement mechanism announced anywhere on this page, so don't go building castles on it. 🌈

---

and that's the whole manual, fr fr. this little icon of a page is dated July 2026, it's the manual for enum nbft_host_flags, and it ships under libnvme(2). mwah, stan, periodt. 💜🎀💖