libnvme(9)

💖 libnvme(9) 💖

okay bestie, so this is a page straight out of the API Manual for libnvme, and today's main character is a struct. buckle up 🫶

✨ NAME ✨

struct libnbft_subsystem_ns — the Subsystem Namespace (SSNS) info struct, and yes she's giving very detailed, very "I have 21 fields and I'm gonna use all of them" energy 💅

🦋 SYNOPSIS 🦋

struct libnbft_subsystem_ns {
    int index;
    struct libnbft_discovery *discovery;
    struct libnbft_security *security;
    int num_hfis;
    struct libnbft_hfi **hfis;
    char transport[8];
    char traddr[40];
    char *trsvcid;
    __u16 subsys_port_id;
    __u32 nsid;
    enum libnbft_nid_type nid_type;
    __u8 *nid;
    char *subsys_nqn;
    __u16 trflags;
    int controller_id;
    int asqsz;
    char *dhcp_root_path_string;
    __u8 naed;
    __u8 cipeec;
    __u16 cto;
    __u8 nceec;
    __u16 flags;
 };

like, copy it exactly, no cap — every field, every type, every array size. 💯

🎀 Members 🎀

okay so here's the full cast, in order, no skipping, we're doing all of them:

• index — the SSNS Descriptor Index, aka where she sits in the descriptor list. her little seat number 🪑
• discovery — the Primary Discovery Controller that's associated with this SSNS Descriptor. her plus-one 💫
• security — the Security Profile Descriptor associated with this namespace. the bodyguard, lowkey 🔐
• num_hfis — Number of HFIs. just a count, bestie.
• hfis — the List of HFIs associated with this namespace. it includes the primary HFI at the first position and all secondary HFIs, and this array is null-terminated (important!! she has an ending, respect it ✋).
• transport — the Transport Type string, like 'tcp' for example 🚀
• traddr — the Subsystem Transport Address.
• trsvcid — the Subsystem Transport Service Identifier.
• subsys_port_id — The Subsystem Port ID. iconic.
• nsid — The Namespace ID of this descriptor, or when nid should be used instead. choose your fighter 🥊
• nid_type — Namespace Identifier Type, see enum libnbft_nid_type.
• nid — The Namespace Identifier value.
• subsys_nqn — Subsystem and Namespace NQN. say it with me: N-Q-N 💜
• trflags — Transport Specific Flags bitmask, see enum nbft_ssns_trflags.
• controller_id — Controller ID, from the SSNS Extended Information Descriptor: the controller ID associated with the Admin Queue, or 0 if not supported. zero means "no thoughts, head empty" 🙈
• asqsz — Admin Submission Queue Size, from the SSNS Extended Information Descriptor, or 0 if not supported.
• dhcp_root_path_string — DHCP Root Path Override string, from the SSNS Extended Information Descriptor.
• naed — Namespace Availability Enhanced Diagnostic, from the SSNS Extended Information Descriptor. it provides additional status codes from the pre-OS driver when the namespace is unavailable — see enum nbft_ssns_ext_info_naed for values. zero indicates no additional information. it's only present in NBFT rev. 1.1+, and zero otherwise. so if you're on 1.0, she's just not there, periodt 💀
• cipeec — Connect Invalid Parameters Extended Error Code, from the SSNS Extended Information Descriptor. provides additional error detail when the pre-OS driver received a Connect Invalid Parameters status — see enum nbft_ssns_ext_info_cipeec for values. zero indicates no extended error. only present in NBFT rev. 1.1+, zero otherwise. 🚨
• cto — Connection Timeout in seconds, from the SSNS Extended Information Descriptor. this is the timeout value the pre-OS driver used for connecting to the object specified with this SSNS descriptor. a value of 0xFFFF indicates that no timeout was specified. zero indicates either a timeout of zero seconds or that the field is not present (NBFT rev. 1.0) — yes, ambiguous, we don't love that for us but that's the spec 😭
• nceec — Network and Connection Extended Error Code, from the SSNS Extended Information Descriptor. provides error codes specific to network and connection errors encountered by the pre-OS driver — see enum nbft_ssns_ext_info_nceec for values. zero indicates no extended error. only present in NBFT rev. 1.1+, zero otherwise. 🌐
• flags — SSNS Flags bitmask, see enum nbft_ssns_flags. the vibe check of the whole struct ⭐

fr fr: every field is listed, nothing got left on read. 💖

and that's the whole page, bestie — this one came from the libnvme API Manual, dated October 2026, starring struct libnbft_subsystem_ns in the libnvme(9) slot. slay, go read the enums next 🌸✨🎀