libnvme\_get\_host(9) libnvme API manual libnvme\_get\_host(9)

# [NAME](#NAME)

libnvme\_get\_host - Returns a host object

# [SYNOPSIS](#SYNOPSIS)

**int libnvme\_get\_host** **(struct libnvme\_global\_ctx \*ctx ,** **const char \*hostnqn ,** **const char \*hostid ,** **struct libnvme\_host \*\*h );**

# [ARGUMENTS](#ARGUMENTS)

[ctx](#ctx)

struct libnvme\_global\_ctx object

[hostnqn](#hostnqn)

Host NQN (optional)

[hostid](#hostid)

Host ID (optional)

[h](#h)

*struct libnvme\_host* object to return

# [DESCRIPTION](#DESCRIPTION)

Returns a host object based on the hostnqn/hostid values or the default if hostnqn/hostid are NULL.

# [RETURN](#RETURN)

0 on success, negative error code otherwise.

libnvme\_get\_host September 2026

---

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