daxctl-list(1)

daxctl-list1

Dump the platform device-dax regions, devices, and attributes in json.

Usage

daxctl list [<options>]

daxctl list --devices

Examples

# daxctl list --regions --devices
{
  "id":1,
  "devices":[
    {
      "chardev":"dax1.0",
      "size":3233808384
    }
  ]
}

Options

-r, --region=

A device-dax region is a contiguous range of memory that hosts one or more /dev/daxX.Y devices, where X is the region id and Y is the device instance id. The keyword all can be specified to carry out the operation on every region in the system.

-d, --dev=

Specify a dax device name, <region id>.<instance id> tuple, or keyword all to filter the listing. For example to list the first device instance in region1:

# daxctl list --dev=1.0
{
  "chardev":"dax1.0",
  "size":3233808384
}
-D, --devices

Include device-dax instance info in the listing (default)

-M, --mappings

Include device-dax instance mappings info in the listing

-R, --regions

Include region info in the listing

-i, --idle

Include idle (not enabled / zero-sized) devices in the listing

-u, --human

By default daxctl list will output machine-friendly raw-integer data. Instead, with this flag, numbers representing storage size will be formatted as human readable strings with units, other fields are converted to hexadecimal strings. Example:

# daxctl list
{
  "chardev":"dax1.0",
  "size":32828817408
}
# daxctl list --human
{
  "chardev":"dax1.0",
  "size":"30.57 GiB (32.83 GB)"
}

Releases

5 releases since Debian 10 (Buster); the text changed 4 times.

  1. 10
  2. 11
  3. 12
  4. 13
  5. Arch

--mappings since Debian 11 (Bullseye); -M since Debian 11 (Bullseye).

From ndctl 85-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.