.TH "libnvme_get_host" 2 "libnvme_get_host" "October 2026" "libnvme API manual" LINUX
.SH NAME
libnvme_get_host \- Returns a host object
.SH SYNOPSIS
.B "int" libnvme_get_host
.BI "(struct libnvme_global_ctx *ctx "  ","
.BI "const char *hostnqn "  ","
.BI "const char *hostid "  ","
.BI "struct libnvme_host **h "  ");"
.SH ARGUMENTS
.IP "ctx" 12
struct libnvme_global_ctx object
.IP "hostnqn" 12
Host NQN (optional)
.IP "hostid" 12
Host ID (optional)
.IP "h" 12
\fIstruct libnvme_host\fP object to return
.SH "DESCRIPTION"
Returns a host object based on the hostnqn/hostid values or the default if
hostnqn/hostid are NULL.
.SH "RETURN"
0 on success, negative error code otherwise.