Users Guide
Broadcom NVMe-FC-120UG-100
30
Emulex NVMe over Fibre Channel User Guide
4.2.2.7 The nvme-list-ns Command
The nvme-list-ns command lists the namespaces for a specified NVMe target. This command retrieves two types of
namespaces:
Active namespaces, which are attached to the processor that controls the command
Allocated namespaces, which have been added to the NVMe subsystem but are not yet connected to a controller
Syntax
hbacmd nvme-list-ns <WWPN> <Target WWPN> <NQN> [CtrlID=<ctrlid>] [Option]
Parameters
Support Requirements
Mandatory for nvme-list-ns WWPN TWWPN NQN CtrlID 0 (list active namespaces)
Optional for nvme-list-ns WWPN TWWPN NQN CtrlID 1 (list allocated namespaces)
Examples
This example shows option not specified:
hbacmd nvme-list-ns 10:00:00:90:fa:5d:05:a9 50:06:01:60:90:20:5C:38 nqn.2014-
08.com.example:nvme.host.sys.xyz
Information similar to the following is displayed:
Active Namespaces (attached to controller 0x0001):
Namespace ID : 0x00000001
Namepsece ID : 0x00000002
Allocated Namespaces:
Namespace ID : 0x00000003
Namepsece ID : 0x00000004
This example shows active namespace identifiers selected:
hbacmd nvme-list-ns 10:00:00:90:fa:5d:05:a9 50:06:01:60:90:20:5C:38 nqn.2014-
08.com.example:nvme.host.sys.xyz 0
Information similar to the following is displayed:
Active Namespaces (attached to controller 0x0001):
Namespace ID : 0x00000001
Namepsece ID : 0x00000002
WWPN The WWPN of the FC initiator port.
Target WWPN The WWPN of an FC port on an NVMe-capable device.
NQN The qualified name of the NVMe subsystem.
ctrlid The controller that processes the request (optional), in hexadecimal.
Option The namespace type (optional); if not used, both active and allocated namespaces are returned:
0 = Get active namespace identifiers
1 = Get allocated namespace identifiers