nvme-list-ctrl - Man Page

nvme list-ctrl <device> [--cntid=<cntid> | -c <cntid>]
                        [--namespace-id=<nsid> | -n <nsid>]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

For the NVMe device given, sends an identify command for controller list and provides the result and returned structure​. This uses either mode 12h or 13h depending on the requested namespace identifier​.

The <device> parameter is mandatory and may be either the NVMe character device (ex: /dev/nvme0), or a namespace block device (ex: /dev/nvme0n1)​. The starting controller in the list always begins with 0 unless the '--cntid' option is given to override​.

On success, the controller array is printed for each index and controller identifier​.

-c <cntid>, --cntid=<cntid>

Retrieve the identify list structure starting with the given controller id​.

-n <nsid>, --namespace-id=<nsid>

If provided, will request the controllers attached to the specified namespace​. If no namespace is given, or set to 0, the command requests the controller list for the entire subsystem, whether or not they are attached to namespace(s)​.

-o <fmt>, --output-format=<fmt>

Set the reporting format to normal, json or binary​. Only one output format can be used at a time​.

-v,  --verbose

Increase the information detail in the output​.

No examples yet​.

Part of the nvme-user suite

nvme(1).