NDCTL-LIST(1)                    ndctl Manual                    NDCTL-LIST(1)

<?><?><?> (NAME)
       ndctl-list - <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> nvdimm
       <?><?><?><?><?><?> <?><?> <?><?><?><?> json

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ndctl list [<options>]

       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> nvdimm
       <?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>.

       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?>: buses<?> dimms<?> regions <?> namespaces.
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> ndctl list
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?>:

       ndctl list --namespaces --bus=all --region=all

<?><?><?><?><?><?><?> (EXAMPLES)
           # ndctl list --buses --namespaces

           {
             "provider":"nfit_test.1",
             "dev":"ndbus2",
             "namespaces":[
               {
                 "dev":"namespace9.0",
                 "mode":"raw",
                 "size":33554432,
                 "blockdev":"pmem9"
               }
             ]
           }
           {
             "provider":"nfit_test.0",
             "dev":"ndbus1"
           }
           {
             "provider":"e820",
             "dev":"ndbus0",
             "namespaces":[
               {
                 "dev":"namespace0.0",
                 "mode":"fsdax",
                 "size":8589934592,
                 "blockdev":"pmem0"
               }
             ]
           }

<?><?><?><?><?><?><?><?> (OPTIONS)
       -r, --region=
           <?><?> <?><?><?> <?><?><?><?><?><?> regionX <?><?> <?><?><?><?><?>
           <?><?><?><?><?> region. <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?>(<?><?>)<?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> all
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           --region <?><?><?>.

       -b, --bus=
           <?><?> <?><?><?><?><?> <?><?><?><?><?> bus <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?>
           "ACPI.NFIT"). <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?>(<?><?>)<?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> all
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           --bus <?><?><?>.

       -d, --dimm=
           <?><?> <?><?><?> <?><?><?><?><?><?> nmemX <?><?> <?><?><?><?><?>
           <?><?><?><?><?> dimm. <?><?><?><?><?> <?><?><?><?><?> dimm <?><?>
           <?><?><?><?><?> X <?><?> nmemX <?><?><?>. <?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
           dimm <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> namespace<?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?> nmem0 <?><?><?><?><?>:

           # ndctl list --dimm=nmem0 --namespaces

       -n, --namespace=
           <?><?> <?><?><?> <?><?><?><?><?><?> namespaceX.Y<?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?> X.Y. <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> namespace <?><?> <?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.

       -m, --mode=
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> (raw<?> fsdax<?> sector <?><?> devdax) <?><?><?><?><?>
           <?><?> namespace(<?><?>).

       -U, --numa-node=
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?> numa.

       -B, --buses
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           (bus) <?><?> <?><?><?><?><?> <?><?><?><?><?>.

       -D, --dimms
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> dimm <?><?>
           <?><?><?><?><?> <?><?><?><?><?>.

       {
         "dev":"nmem0",
         "id":"cdab-0a-07e0-ffffffff",
         "handle":0,
         "phys_id":0,
         "security:":"disabled"
       }

       -H, --health
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> dimm
           <?><?> <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?>:

       {
         "dev":"nmem0",
         "health":{
           "health_state":"non-critical",
           "temperature_celsius":23,
           "spares_percentage":75,
           "alarm_temperature":true,
           "alarm_spares":true,
           "temperature_threshold":40,
           "spares_threshold":5,
           "life_used_percentage":5,
           "shutdown_state":"clean"
         }
       }

       -F, --firmware
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>:

           # ndctl list -BDF
           [
             {
               "provider":"nfit_test.0",
               "dev":"ndbus2",
               "scrub_state":"idle",
               "firmware":{
                 "activate_method":"suspend",
                 "activate_state":"idle"
               },
               "dimms":[
                 {
                   "dev":"nmem1",
                   "id":"cdab-0a-07e0-ffffffff",
                   "handle":0,
                   "phys_id":0,
                   "security":"disabled",
                   "firmware":{
                     "current_version":0,
                     "can_update":true
                   }
                 },
           ...
           ]

       -X, --device-dax
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> device-dax ("daxregion")
           <?><?><?><?><?><?> <?><?> <?><?> namespace <?><?> <?><?><?><?>
           "devdax" <?><?><?>.

       {
         "dev":"namespace0.0",
         "mode":"devdax",
         "size":4225761280,
         "uuid":"18ae1bbb-bb62-4efc-86df-4a5caacb5dcc",
         "daxregion":{
           "id":0,
           "size":4225761280,
           "align":2097152,
           "devices":[
             {
               "chardev":"dax0.0",
               "size":4225761280
             }
           ]
         }
       }

       -R, --regions
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           (region) <?><?> <?><?><?><?><?> <?><?><?><?><?>.

       -N, --namespaces
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           (namespace) <?><?> <?><?><?><?><?> <?><?><?><?><?>. <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           namespace <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>.

       -i, --idle
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> (<?><?><?><?><?><?><?><?><?>) <?><?>
           <?><?><?><?><?> <?><?><?><?><?>.

       -c, --configured
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> (namespace<?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?>) <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?> namespace<?><?>
           <?><?><?><?><?> <<<?><?><?><?><?><?><?><?><?><?><?><?>>> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       -C, --capabilities
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> namespace <?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?> (sector) <?>
           <?><?><?><?><?><?><?><?><?><?><?>.

       -M, --media-errors
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           (badblocks) <?><?> <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
           badblock_count <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.
           <?><?><?><?><?><?><?> <?><?><?> namespace <?><?> <?><?><?><?>
           sector <?><?><?><?><?> <?><?><?><?><?> badblocks
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?>
           badblock_count <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?> <?><?> <?><?> <?><?><?><?><?><?><?> (metadata) <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> namespace
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?>
           <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> badblocks<?> <?><?> namespace
           <?><?> <?><?><?> sector <?><?> <?><?> <?><?><?><?> raw
           <?><?><?><?><?> <?><?><?><?>.

       {
         "dev":"namespace7.0",
         "mode":"raw",
         "size":33554432,
         "blockdev":"pmem7",
         "badblock_count":17,
         "badblocks":[
           {
             "offset":4,
             "length":1
           },
           {
             "offset":32768,
             "length":8
           },
           {
             "offset":65528,
             "length":8
           }
         ]
       }

       -v, --verbose
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?> <?><?><?>.

           o   -v <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
               namespace<?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
               numa_node<?> raw_uuid <?> <?><?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?><?><?>.

           o   -vv <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?><?> -v<?>
               <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?> --dimms<?> --buses <?> --regions.

           o   -vvv <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?><?> -vv<?>
               <?><?><?><?><?><?><?><?> --health<?> --capabilities<?> --idle
               <?> --firmware.  :: <?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
               <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.
               <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?> region<?><?> <?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?>
               <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

           # ndctl list -Ru -vvv -r 0
           {
             "dev":"region0",
             "size":"4.00 GiB (4.29 GB)",
             "available_size":0,
             "max_available_extent":0,
             "type":"pmem",
             "numa_node":0,
             "target_node":2,
             "capabilities":[
               {
                 "mode":"sector",
                 "sector_sizes":[
                   512,
                   520,
                   528,
                   4096,
                   4104,
                   4160,
                   4224
                 ]
               },
               {
                 "mode":"fsdax",
                 "alignments":[
                   4096,
                   2097152,
                   1073741824
                 ]
               },
               {
                 "mode":"devdax",
                 "alignments":[
                   4096,
                   2097152,
                   1073741824
                 ]
               }
             ],
             "persistence_domain":"unknown"
           }

       -u, --human
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

           # ndctl list --region=7
           {
             "dev":"region7",
             "size":67108864,
             "available_size":67108864,
             "type":"pmem",
             "iset_id":-6382611090938810793,
             "badblock_count":8
           }

           # ndctl list --human --region=7
           {
             "dev":"region7",
             "size":"64.00 MiB (67.11 MB)",
             "available_size":"64.00 MiB (67.11 MB)",
             "type":"pmem",
             "iset_id":"0xa76c6907811fae57",
             "badblock_count":8
           }

           NDCTL_LIST_LINT
               <?><?> <?><?><?> <?><?> <?><?><?><?><?> <<ndctl list>>
               <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
               <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
               <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
               <?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?><?>. <?><?><?><?><?> NDCTL_LIST_LINT
               <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?> (regression) <?><?><?><?>. <?><?><?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
               <?><?> <?><?><?><?><?> <?><?><?><?><?><?>:

               o   <?><?><?><?><?> <<ndctl list -Rv>>
                   <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
                   <?><?><?><?><?> region <?><?> <?><?><?><?> <?><?><?> <?>
                   <?><?><?><?> <?><?><?><?><?> namespace <?><?><?><?>.  ::

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYRIGHT)
       <?><?> <?><?><?> (C) 2016 - 2022<?> <?><?><?><?> Intel. <?><?><?><?>
       GPLv2: <?><?><?> GPL <?><?><?><?> <?>
       <http://gnu.org/licenses/gpl.html>.  <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>: <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?>. <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       ndctl-create-namespace(1)

ndctl                             2026-06-30                     NDCTL-LIST(1)