1NVME-LIST-CTRL(1)                 NVMe Manual                NVME-LIST-CTRL(1)
2
3
4

NAME

6       nvme-list-ctrl - Send NVMe Identify List Controllers, return result and
7       structure
8

SYNOPSIS

10       nvme list-ctrl <device> [--cntid=<cntid> | -c <cntid>]
11                               [--namespace-id=<nsid> | -n <nsid>] [-o <fmt> | --output-format=<fmt>]
12       DESCRIPTION
13
14       For the NVMe device given, sends an identify command for controller list
15       and provides the result and returned structure. This uses either mode
16       12h or 13h depending on the requested namespace identifier.
17
18       The <device> parameter is mandatory and may be either the NVMe character
19       device (ex: /dev/nvme0), or a namespace block device (ex: /dev/nvme0n1).
20       The starting controller in the list always begins with 0 unless the
21       `'--cntid'` option is given to override.
22
23       On success, the controller array is printed for each index and controller
24       identifier.
25
26       OPTIONS
27
28       -c <cntid>, --cntid=<cntid>
29           Retrieve the identify list structure starting with the given
30           controller id.
31
32       -n <nsid>, --namespace-id=<nsid>
33           If provided, will request the controllers attached to the specified
34           namespace. If no namespace is given, or set to 0, the command
35           requests the controller list for the entire subsystem, whether or
36           not they are attached to namespace(s).
37
38       -o <format>, --output-format=<format>
39           Set the reporting format to normal or json. Only one output format
40           can be used at a time.
41

EXAMPLES

43       No examples yet.
44

NVME

46       Part of the nvme-user suite
47
48
49
50NVMe                              11/04/2022                 NVME-LIST-CTRL(1)