CXL-DISABLE-BUS(1)

💅 CXL-DISABLE-BUS(1) — the cxl manual, bestie edition 🎀

okay so you found the page for cxl-disable-bus, part of the cxl manual family. sit down, grab a strawberry drink 🍓, and let me tell you about shutting down a whole tree.

---

✨ NAME ✨

cxl-disable-bus — Shutdown an entire tree of CXL devices 🦋

like, the whole tree. not just one leaf. we're talking main character energy for the entire hierarchy.

---

🌸 SYNOPSIS 🌸

cxl disable-bus <root0> [<root1>..<rootN>] [<options>]

For test and debug scenarios, disable a CXL bus and any associated memory devices from CXL.mem operations. 🧚

Also real talk, this applies to any enable or disable command: if the operation is a no-op due to the current state of a target (i.e. already enabled or already disabled), it is still considered successful when executed even if no actual operation is performed. The target can be a bus, decoder, memdev, or region. The operation will still succeed, and report the number of bus/decoder/memdev/region operated on, even if the operation is a no-op. 🙈

bestie that's literally the nicest behavior ever — no failed exit status just because she was already doing the thing. she's already slaying, ok?

---

👑 OPTIONS 👑

• -f, --force — DANGEROUS ⚠️ this one overrides the safety measure that blocks attempts to disable a bus if the tool determines a descendent memdev is in active usage. And like, recall that CXL memory ranges might have been established by platform firmware, and disabling an active device is akin to force removing memory from a running system. so... yeah. that's the vibe. you've been warned fr fr 😭
• --debug — If the cxl tool was built with debug disabled, turn on debug messages. turning the lights on so you can actually see what's happening ✨

---

💀 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. 🫶

like yes the lawyers made us say it but it is free software and that's iconic.

---

🌈 SEE ALSO 🌈

• cxl-disable-port(1) — the sibling page, go read her too 💜

---

and that's the whole page babes, no gatekeeping 🦋 cxl · 2026-06-30 · xoxo, go disable some buses responsibly, mwah 💅💖