CXL-DISABLE-REGION(1)

✨ CXL-DISABLE-REGION πŸ’…

okay bestie, so this one is a page from the cxl manual, and it's literally about turning regions OFF. yes, the whole thing. let's get into it 🫢


🌸 NAME 🌸

cxl-disable-region β€” disable the region(s) you point at. that's it, that's the vibe.


πŸ¦‹ SYNOPSIS πŸ¦‹

cxl disable-region <region> [<options>]

πŸ’– DESCRIPTION πŸ’–

okay so a CXL region is made up of one or more slices of CXL memdevs, and it's got configurable interleave settings β€” both the number of interleave ways and the interleave granularity. fancy, i know πŸ’…

if there are still memory blocks that are online, the operation will try to offline the relevant blocks. and if that offlining fails? then the operation fails β€” unless you're using the -f (force) parameter. no cap 🫢


⭐ EXAMPLE ⭐

# cxl disable-region all
disabled 2 regions

ngl, this part is lowkey iconic: for any enable or disable command, if the operation is a no-op because of the current state of a target (like, it's already enabled or already disabled), it's still considered successful when executed, even if no actual operation happened. the target can be a bus, decoder, memdev, or region. the operation still succeeds and reports the number of bus/decoder/memdev/region operated on β€” even when it's a total no-op. periodt ✨


πŸŽ€ OPTIONS πŸŽ€

  • -b, --bus= β€” restrict the operation to the bus you specify. keep it contained bestie πŸ’œ
  • -f, --force β€” attempt disable-region even though memory can't be offlined successfully. heads up though: it will emit a warning that the operation will permanently leak physical address space and that it cannot be recovered until a reboot 😭 like, actually permanent, not just for the plot.
  • -d, --decoder= β€” the root decoder to limit the operation to. only regions that are children of the specified decoder will be acted upon. main character decoder only πŸ‘‘
  • --debug β€” turn on additional debug messages, including library debug. for the girlies who need to see everything πŸ”₯
fr fr, read the -f warning again. leaking physical address space with no recovery until reboot is not a cute look unless you mean it πŸ™ˆ

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-list(1), cxl-enable-region(1)


okay that's the whole page, bestie β€” this one came from the cxl manual and it's dated 2026-06-30. go forth and disable responsibly πŸ’–πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from
  • arch rolling: ndctl 85-1 Β· LGPL-2.1-only AND GPL-2.0-only AND CC0-1.0 AND MIT
  • πŸ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms