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

NAME

6       nvme-list-subsys - List all NVMe subsystems
7

SYNOPSIS

9       nvme list-subsys [-o <fmt> | --output-format=<fmt>] <device>
10

DESCRIPTION

12       Scan the sysfs tree for NVM Express subsystems and return the
13       controllers for those subsystems as well as some pertinent information
14       about them. If a device is given, print out only the values for the
15       controllers and subsystems leading to the device.
16

OPTIONS

18       -o <format>, --output-format=<format>
19           Set the reporting format to normal or json. Only one output format
20           can be used at a time.
21

EXAMPLES

23           root@host[1]# nvme list-subsys
24           nvme-subsys0 - NQN=nvmf-test
25           \
26            +- nvme0 rdma traddr=1.1.1.3,trsvcid=4420,host_traddr=1.1.1.1
27            +- nvme1 rdma traddr=1.1.1.3,trsvcid=4420,host_traddr=1.1.1.2
28           nvme-subsys1 - NQN=nvmf-test2
29           \
30            +- nvme2 rdma traddr=1.1.1.3,trsvcid=4420,host_traddr=1.1.1.2
31            +- nvme3 rdma traddr=1.1.1.3,trsvcid=4420,host_traddr=1.1.1.1
32
33           root@host[1]# nvme list-subsys -o json
34           {
35             "Subsystems" : [
36               {
37                 "Name" : "nvme-subsys0",
38                 "NQN" : "nvmf-test"
39               },
40               {
41                 "Paths" : [
42                   {
43                     "Name" : "nvme0",
44                     "Transport" : "rdma",
45                     "Address" : "traddr=1.1.1.3,trsvcid=4420,host_traddr=1.1.1.1"
46                   },
47                   {
48                     "Name" : "nvme1",
49                     "Transport" : "rdma",
50                     "Address" : "traddr=1.1.1.3,trsvcid=4420,host_traddr=1.1.1.2"
51                   }
52                 ]
53               },
54               {
55                 "Name" : "nvme-subsys1",
56                 "NQN" : "nvmf-test2"
57               },
58               {
59                 "Paths" : [
60                   {
61                     "Name" : "nvme2",
62                     "Transport" : "rdma",
63                     "Address" : "traddr=1.1.1.3,trsvcid=4420,host_traddr=1.1.1.2"
64                   },
65                   {
66                     "Name" : "nvme3",
67                     "Transport" : "rdma",
68                     "Address" : "traddr=1.1.1.3,trsvcid=4420,host_traddr=1.1.1.1"
69                   }
70                 ]
71               }
72             ]
73           }
74

NVME

76       Part of the nvme-user suite
77

NOTES

79        1. root@host
80           mailto:root@host
81
82
83
84NVMe                              09/29/2023               NVME-LIST-SUBSYS(1)
Impressum