1CXL-FREE-DPA(1)                                                CXL-FREE-DPA(1)
2
3
4

NAME

6       cxl-free-dpa - release device-physical address space
7

SYNOPSIS

9       cxl free-dpa <mem0> [<mem1>..<memN>] [<options>]
10
11       The CXL region provisioning process proceeds in multiple steps. One of
12       the steps is identifying and reserving the DPA span that each member of
13       the interleave-set (region) contributes in advance of attaching that
14       allocation to a region. For development, test, and debug purposes this
15       command is a helper to find the last allocated decoder on a device and
16       zero-out / free its DPA allocation.
17

OPTIONS

19       <memory device(s)>
20           A memX device name, or a memdev id number. Restrict the operation
21           to the specified memdev(s). The keyword all can be specified to
22           indicate the lack of any restriction.
23
24       -S, --serial
25           Rather an a memdev id number, interpret the <memdev> argument(s) as
26           a list of serial numbers.
27
28       -b, --bus=
29           Restrict the operation to the specified bus.
30
31       -d, --decoder
32           Specify the decoder to free. The CXL specification mandates that
33           DPA must be released in the reverse order it was allocated. See
34           linkcxl:cxl-reserve-dpa[1]
35
36       -t, --type
37           Constrain the search for "last allocated decoder" to decoders
38           targeting the given partition.
39
40       -f, --force
41           The kernel enforces CXL DPA ordering constraints on deallocation
42           events, and the tool anticipates those and fails operations that
43           are expected to fail without sending them to the kernel. For test
44           purposes, continue to attempt "expected to fail" operations to
45           exercise the driver.
46
47       -v
48           Turn on verbose debug messages in the library (if libcxl was built
49           with logging and debug enabled).
50

52       Copyright © 2016 - 2022, Intel Corporation. License GPLv2: GNU GPL
53       version 2 http://gnu.org/licenses/gpl.html. This is free software: you
54       are free to change and redistribute it. There is NO WARRANTY, to the
55       extent permitted by law.
56

SEE ALSO

58       linkcxl:cxl-reserve-dpa[1]
59
60
61
62                                  08/03/2023                   CXL-FREE-DPA(1)
Impressum