1CXL-FREE-DPA(1) CXL-FREE-DPA(1)
2
3
4
6 cxl-free-dpa - release device-physical address space
7
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
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 -d, --decoder
29 Specify the decoder to free. The CXL specification mandates that
30 DPA must be released in the reverse order it was allocated. See
31 linkcxl:cxl-reserve-dpa[1]
32
33 -t, --type
34 Constrain the search for "last allocated decoder" to decoders
35 targeting the given partition.
36
37 -f, --force
38 The kernel enforces CXL DPA ordering constraints on deallocation
39 events, and the tool anticipates those and fails operations that
40 are expected to fail without sending them to the kernel. For test
41 purposes, continue to attempt "expected to fail" operations to
42 exercise the driver.
43
44 -v
45 Turn on verbose debug messages in the library (if libcxl was built
46 with logging and debug enabled).
47
49 Copyright © 2016 - 2022, Intel Corporation. License GPLv2: GNU GPL
50 version 2 http://gnu.org/licenses/gpl.html. This is free software: you
51 are free to change and redistribute it. There is NO WARRANTY, to the
52 extent permitted by law.
53
55 linkcxl:cxl-reserve-dpa[1]
56
57
58
59 01/13/2023 CXL-FREE-DPA(1)