CXL-FREE-DPA(1)

💅 cxl-free-dpa 💅

okay so this is from the cxl manual, section 1, and it’s literally about releasing device-physical address space. bestie, we’re freeing DPA and it’s giving “cleanup era” ✨.

🌸 NAME 🌸

cxl-free-dpa — release device-physical address space 🫶

✨ SYNOPSIS ✨

cxl free-dpa <mem0> [<mem1>..<memN>] [<options>]

The CXL region provisioning process proceeds in multiple steps. One of the steps is identifying and reserving the DPA span that each member of the interleave-set (region) contributes in advance of attaching that allocation to a region. For development, test, and debug purposes this command is a helper to find the last allocated decoder on a device and zero-out / free its DPA allocation. 🌀

💅 OPTIONS 💅

• <memory device(s)> — a memX device name, or a memdev id number. Restrict the operation to the specified memdev(s). The keyword all can be specified to indicate the lack of any restriction. 💖
• -S, --serial — instead of a memdev id number, interpret the <memdev> argument(s) as a list of serial numbers. 🎀
• -b, --bus= — restrict the operation to the specified bus. 🌈
• -d, --decoder — specify the decoder to free. The CXL specification mandates that DPA must be released in the reverse order it was allocated. See cxl-reserve-dpa(1) 🔥
• -t, --type — constrain the search for "last allocated decoder" to decoders targeting the given partition. 👑
• -f, --force — the kernel enforces CXL DPA ordering constraints on deallocation events, and the tool anticipates those and fails operations that are expected to fail without sending them to the kernel. For test purposes, continue to attempt "expected to fail" operations to exercise the driver. (yes, this is the testing-only little gremlin move 🙈)
• -v — turn on verbose debug messages in the library (if libcxl was built with logging and debug enabled). 🦋

🎀 COPYRIGHT 🎀

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

🦋 SEE ALSO 🦋

cxl-reserve-dpa(1) — like, go read the reserve buddy too, iykyk 💫

---

source/version + date moment: this page is from the cxl manual, dated 2026-06-30, and its page tag is CXL-FREE-DPA(1) — mwah, bye bestie 💋