NVMETCLI(8) NVMETCLI(8) (NAME) nvmetcli - NVMe-over-Fabrics Target. (USAGE) nvmetcli nvmetcli clear nvmetcli restore [filename.json] (DESCRIPTION) nvmetcli NVMe Target NVMe-over-Fabrics . ( NVMe ) NVMe-over-Fabrics http://www.nvmexpress.org . nvmetcli (root) : 1. 2. (BACKGROUND) NQN NVMe Qualified Name NVMe ( ) NVMe . NQN NVMe-over-Fabrics . NVMe Target "Discovery Log Page" NVMe-over-Fabrics . NVMe Target (discovery controller) NVMe Host NVM . nvmetcli ( (OPTIONS) (EXAMPLES) ). NVMe Host /subsystems/[NQN NAME]/allowed_hosts IP NVMe Target . NVMe Host nvme-cli (https://github.com/linux-nvme/nvme-cli) . (OPTIONS) (Interactive Configuration Shell) nvmetcli . nvmetcli configfs NVMe Target /port /subsystem /host . . : +---------------------------+----------------------------------+ |cd | | | | | | | | | | | | | . | +---------------------------+----------------------------------+ |ls | | | | | | | | | | . | +---------------------------+----------------------------------+ |create [NQN name]/[#] | | | | | | | | | | | | | . | | | [NQN name]/[#] | | | | | | | | | | | | | | | . | +---------------------------+----------------------------------+ |delete [NQN name]/[#] | | | | | | | | | | . | +---------------------------+----------------------------------+ |set attr | | |allow_any_host=[0/1] | /subsystems/[NQN name] | | | | | | | | | | | | NVMe Host | | | | | | | | | | | | . | +---------------------------+----------------------------------+ |set device path=[device | | |path] | /subsystems/[NQN | | | name]/namespaces | | | | | | | | | () | | | | | | | | | . | +---------------------------+----------------------------------+ |set device nguid=[string] | | | | /subsystems/[NQN | | | name]/namespaces | | | | | | | | | | | | | | | | | | | | | . | +---------------------------+----------------------------------+ |enable/disable | | | | /subsystems/[NQN | | | name]/namespaces | | | | | | | | | | | | | | | . | +---------------------------+----------------------------------+ |set addr [discovery log | /ports/[#] | |page field]=[string] | | | | | | | | | | | | | | | | . | | | | | | | | | (EXAMPLES) | | | . | +---------------------------+----------------------------------+ |saveconfig [filename.json] | NVMe | | | Target | | | .json | | | | | | . | | | | | | | | | /etc/nvmet/config.json | | | | | | . | | | JSON | | | | | | | | | | | | | | | | | | . | +---------------------------+----------------------------------+ |exit | | | | | | | | | | . | +---------------------------+----------------------------------+ (Command Line Mode) nvmetcli [cmd] . +------------------------+-----------------------------+ |restore [filename.json] | | | | | | | | | | NVMe Target | | | | | | . | | | | | | | | | | | | /etc/nvmet/config.json | | | | | | . | +------------------------+-----------------------------+ |clear | | | | NVMe Target | | | | | | . | +------------------------+-----------------------------+ |ls | | | | NVMe Target | | | | | | (dump | | | ). | +------------------------+-----------------------------+ (EXAMPLES) nvmetcli (root) nvmet configfs /sys/kernel/config : mount -t configfs none /sys/kernel/config . o nvmetcli ( ): # ./nvmetcli ...> o . NQN . : > cd /subsystems ...> create testnqn o NVMe Host NQN : ...> cd /hosts ...> create hostnqn ...> cd /subsystems/testnqn ...> set attr allow_any_host=0 ...> cd /subsystems/testnqn/allowed_hosts/ ...> create hostnqn o Host NQN: ...> cd /subsystems/testnqn/allowed_hosts/ ...> delete hostnqn o Host . : ...> cd /subsystems/testnqn/ ...> set attr allow_any_host=1 o . : ...> cd /subsystems/testnqn/namespaces ...> create 1 ...> cd 1 ...> set device path=/dev/nvme0n1 ...> enable device_nguid NVMe Target ( clear restore device_nguid ). o loopback nvme-loop ... ...> cd /ports/ ...> create 1 ...> cd 1/ ...> set addr trtype=loop ...> cd subsystems/ ...> create testnqn o RDMA ( IB RoCE iWarp) IPv4. 4420 IANA NVMe over Fabrics RDMA : ...> cd /ports/ ...> create 2 ...> cd 2/ ...> set addr trtype=rdma ...> set addr adrfam=ipv4 ...> set addr traddr=192.168.6.68 ...> set addr trsvcid=4420 ...> cd subsystems/ ...> create testnqn o FC. traddr WWNN/WWPN FC . ...> cd /ports/ ...> create 3 ...> cd 3/ ...> set addr trtype=fc ...> set addr adrfam=fc ...> set addr traddr=nn-0x1000000044001123:pn-0x2000000055001123 ...> set addr trsvcid=none ...> cd subsystems/ ...> create testnqn o NVMe Target: ./nvmetcli ...> saveconfig test.json o NVMe Target: ./nvmetcli restore test.json o NVMe Target: ./nvmetcli clear (ADDITIONAL INFORMATION) nvmetcli systemctl .service NVMe Target . nvmetcli nvmet.service NVMe Target /etc/nvmet/config.json . nvmet.service /lib/systemd/system . : systemctl enable nvmet : systemctl disable nvmet systemctl(1) . (AUTHORS) Jay Freyensee[1] . nvmetcli Christoph Hellwig[2] . (REPORTING BUGS & DEVELOPMENT) linux-nvme@lists.infradead.org[3] . (LICENSE) nvmetcli Apache License, Version 2.0 . << >> (AS IS) . (NOTES) 1. Jay Freyensee mailto:james.p.freyensee@intel.com 2. Christoph Hellwig mailto:hch@infradead.org 3. linux-nvme@lists.infradead.org mailto:linux-nvme@lists.infradead.org 08/19/2026 NVMETCLI(8)