1DAXCTL-LIST(1)                   daxctl Manual                  DAXCTL-LIST(1)
2
3
4

NAME

6       daxctl-list - dump the platform Device-DAX regions, devices, and
7       attributes in json.
8

SYNOPSIS

10       daxctl list [<options>]
11
12       Walk all the device-dax-regions in the system and list all device
13       instances along with some of their major attributes.
14
15       Options can be specified to limit the output to objects of a certain
16       class. Where the classes are regions or devices. By default, daxctl
17       list with no options is equivalent to:
18
19       daxctl list --devices
20

EXAMPLE

22           # daxctl list --regions --devices
23
24           {
25             "id":1,
26             "devices":[
27               {
28                 "chardev":"dax1.0",
29                 "size":3233808384
30               }
31             ]
32           }
33

OPTIONS

35       -r, --region=
36           A device-dax region is a contiguous range of memory that hosts one
37           or more /dev/daxX.Y devices, where X is the region id and Y is the
38           device instance id. The keyword all can be specified to carry out
39           the operation on every region in the system.
40
41       -d, --dev=
42           Specify a dax device name, <region id>.<instance id> tuple, or
43           keyword all to filter the listing. For example to list the first
44           device instance in region1:
45
46           # daxctl list --dev=1.0
47
48           {
49             "chardev":"dax1.0",
50             "size":3233808384
51           }
52
53       -D, --devices
54           Include device-dax instance info in the listing (default)
55
56       -R, --regions
57           Include region info in the listing
58
59       -i, --idle
60           Include idle (not enabled / zero-sized) devices in the listing
61
62       -u, --human
63           By default daxctl list will output machine-friendly raw-integer
64           data. Instead, with this flag, numbers representing storage size
65           will be formatted as human readable strings with units, other
66           fields are converted to hexadecimal strings. Example:
67
68           # daxctl list
69           {
70             "chardev":"dax1.0",
71             "size":32828817408
72           }
73
74           # daxctl list --human
75           {
76             "chardev":"dax1.0",
77             "size":"30.57 GiB (32.83 GB)"
78           }
79
81       Copyright (c) 2016 - 2019, Intel Corporation. License GPLv2: GNU GPL
82       version 2 <http://gnu.org/licenses/gpl.html>. This  is  free  software:
83       you  are  free  to change and redistribute it. There is NO WARRANTY, to
84       the extent permitted by law.
85
86
87
88daxctl                            2019-05-10                    DAXCTL-LIST(1)
Impressum