.TH "libnvmf_config_get_hostnqn" 9 "libnvmf_config_get_hostnqn" "October 2026" "libnvme API manual" LINUX
.SH NAME
libnvmf_config_get_hostnqn \- the top-level [Host] host NQN.
.SH SYNOPSIS
.B "const char *" libnvmf_config_get_hostnqn
.BI "(const struct libnvmf_config *config "  ");"
.SH ARGUMENTS
.IP "config" 12
the resolved configuration
.SH "DESCRIPTION"
The identity of the configuration's default persona, as written in the
top-level file's [Host] section.  A drop-in's persona is deliberately not
reachable here: it belongs to that drop-in's own connections.

Each connection already carries the identity it is made under, but a
configuration may name a persona and configure no connections at all -- a
host that only connects what it discovers.  This is how that identity is
read.
.SH "RETURN"
borrowed string, valid while \fIconfig\fP is alive, or NULL when the
top-level file names no host NQN (the caller falls back to the system
identity in /etc/nvme/hostnqn).