libnvmf\_exclusion\_add\_subsysnqn(9) libnvme API manual libnvmf\_exclusion\_add\_subsysnqn(9)

# [NAME](#NAME)

libnvmf\_exclusion\_add\_subsysnqn - append a subsystem-NQN-only entry.

# [SYNOPSIS](#SYNOPSIS)

**int libnvmf\_exclusion\_add\_subsysnqn** **(struct libnvme\_global\_ctx \*ctx ,** **const char \*name ,** **const char \*subsysnqn );**

# [ARGUMENTS](#ARGUMENTS)

[ctx](#ctx)

libnvme global context; must not be NULL

[name](#name)

list name

[subsysnqn](#subsysnqn)

subsystem NQN to exclude; must not be NULL or empty

# [DESCRIPTION](#DESCRIPTION)

Builds an exclusion entry matching every controller of a subsystem (the entry constrains only the NQN) inside libnvme -- the caller needs no knowledge of the on-disk entry format -- then appends it via **libnvmf\_exclusion\_add**. Creates the list if it does not exist.

# [RETURN](#RETURN)

0 on success, -EINVAL if *ctx* or *subsysnqn* is NULL/empty, negative errno otherwise.

libnvmf\_exclusion\_add\_subsysnqn October 2026

---

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