libnvme(9) API Manual libnvme(9)

# [NAME](#NAME)

struct libnbft\_subsystem\_ns - Subsystem Namespace (SSNS) info

# [SYNOPSIS](#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;**  
};

# [Members](#Members)

[index](#index)

SSNS Descriptor Index in the descriptor list.

[discovery](#discovery)

Primary Discovery Controller associated with this SSNS Descriptor.

[security](#security)

Security Profile Descriptor associated with this namespace.

[num\_hfis](#num_hfis)

Number of HFIs.

[hfis](#hfis)

List of HFIs associated with this namespace. Includes the primary HFI at the first position and all secondary HFIs. This array is null-terminated.

[transport](#transport)

Transport Type string (e.g. 'tcp').

[traddr](#traddr)

Subsystem Transport Address.

[trsvcid](#trsvcid)

Subsystem Transport Service Identifier.

[subsys\_port\_id](#subsys_port_id)

The Subsystem Port ID.

[nsid](#nsid)

The Namespace ID of this descriptor or when *nid* should be used instead.

[nid\_type](#nid_type)

Namespace Identifier Type, see *enum libnbft\_nid\_type*.

[nid](#nid)

The Namespace Identifier value.

[subsys\_nqn](#subsys_nqn)

Subsystem and Namespace NQN.

[trflags](#trflags)

Transport Specific Flags bitmask, see *enum nbft\_ssns\_trflags*.

[controller\_id](#controller_id)

Controller ID (SSNS Extended Information Descriptor): The controller ID associated with the Admin Queue or 0 if not supported.

[asqsz](#asqsz)

Admin Submission Queue Size (SSNS Extended Information Descriptor) or 0 if not supported.

[dhcp\_root\_path\_string](#dhcp_root_path_string)

DHCP Root Path Override string (SSNS Extended Information Descriptor).

[naed](#naed)

Namespace Availability Enhanced Diagnostic (SSNS Extended Information Descriptor). 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. Only present in NBFT rev. 1.1+, zero otherwise.

[cipeec](#cipeec)

Connect Invalid Parameters Extended Error Code (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](#cto)

Connection Timeout in seconds (SSNS Extended Information Descriptor). The timeout value used by the pre-OS driver 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).

[nceec](#nceec)

Network and Connection Extended Error Code (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](#flags)

SSNS Flags bitmask, see *enum nbft\_ssns\_flags*.

struct libnbft\_subsystem\_ns September 2026

---

Document: libnbft_subsystem_ns-libnvme3(2) from nvme-cli 3.1-r0 (Chainguard OS)
Source: https://github.com/linux-nvme/nvme-cli