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           .ft C
23           # daxctl list --regions --devices
24
25           {
26             "id":1,
27             "devices":[
28               {
29                 "chardev":"dax1.0",
30                 "size":3233808384
31               }
32             ]
33           }
34           .ft
35
36

OPTIONS

38       -r, --region=
39           A device-dax region is a contiguous range of memory that hosts one
40           or more /dev/daxX.Y devices, where X is the region id and Y is the
41           device instance id. The keyword all can be specified to carry out
42           the operation on every region in the system.
43
44       -d, --dev=
45           Specify a dax device name, <region id>.<instance id> tuple, or
46           keyword all to filter the listing. For example to list the first
47           device instance in region1:
48
49
50           .ft C
51           # daxctl list --dev=1.0
52
53           {
54             "chardev":"dax1.0",
55             "size":3233808384
56           }
57           .ft
58
59
60       -D, --devices
61           Include device-dax instance info in the listing (default)
62
63       -M, --mappings
64           Include device-dax instance mappings info in the listing
65
66       -R, --regions
67           Include region info in the listing
68
69       -i, --idle
70           Include idle (not enabled / zero-sized) devices in the listing
71
72       -u, --human
73           By default daxctl list will output machine-friendly raw-integer
74           data. Instead, with this flag, numbers representing storage size
75           will be formatted as human readable strings with units, other
76           fields are converted to hexadecimal strings. Example:
77
78
79           .ft C
80           # daxctl list
81           {
82             "chardev":"dax1.0",
83             "size":32828817408
84           }
85
86           # daxctl list --human
87           {
88             "chardev":"dax1.0",
89             "size":"30.57 GiB (32.83 GB)"
90           }
91           .ft
92
93

95       Copyright © 2016 - 2020, Intel Corporation. License GPLv2: GNU GPL
96       version 2 http://gnu.org/licenses/gpl.html. This is free software: you
97       are free to change and redistribute it. There is NO WARRANTY, to the
98       extent permitted by law.
99
100
101
102daxctl 71.1                       07/22/2021                    DAXCTL-LIST(1)
Impressum