cxl-free-dpa(1)

cxl-free-dpa1

Release device-physical address space

Usage

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

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

Rather an 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.

-v

Turn on verbose debug messages in the library (if libcxl was built with logging and debug enabled).

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

From ndctl 85-1 in Arch Linux 2026-11-07. Parsed by carta from the page's man source.