CXL-DISABLE-PORT(1)

💅 CXL-DISABLE-PORT(1) 💅

okay so bestie, you're reading a page from the cxl manual — yes, that cxl — and this is the ✨glow-up✨ edition of the cxl-disable-port page. buckle up 🎀

---

🌸 NAME 🌸

cxl-disable-port — disable / hot-remove a given CXL port and its whole lil descendant family 🌈

---

🦋 SYNOPSIS 🦋

cxl disable-port <port0> [<port1>..<portN>] [<options>]

✨ what this is actually for (iykyk) ✨

For test and debug scenarios, bb 🧪 — you disable a CXL port plus any memory devices that depend on that port being active for CXL.mem operation. like, the port has to be up for them to work, so it goes down, they go down. bye 👋

also, important vibes check on all these enable/disable commands generally: if your operation ends up being a no-op because the target's already in the state you asked for (already enabled, already disabled — been there, done that 💀), it's still considered successful when executed, even if literally nothing happened. the target can be a bus, decoder, memdev, or region. it succeeds, and it reports the number of bus/decoder/memdev/region operated on, even when the operation is a no-op. no cap 🫶

---

🎀 OPTIONS 🎀

• -e, --endpoint — toggle from treating the port arguments as Switch Port identifiers over to Endpoint Port identifiers. like flipping which flavor of port you're talking about 💫
• -f, --force — ⚠️ DANGEROUS ⚠️ this overrides the safety measure that blocks attempts to disable a port when the tool determines a descendant memdev is in active usage. recall that CXL memory ranges might have been established by platform firmware, and disabling an active device is basically force-removing memory from a running system 😭 do not come for me if you yeet your RAM, I warned you.
• --debug — turn on additional debug messages, including library debug. maximum yapping mode 🗣️✨

bestie fr fr: --force is not a cute lil shortcut, it's a "yes I really do mean it, remove memory from a live system" button. handle with care 💀

---

👑 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-disable-port(1) — yes, it links to itself. iconic, honestly. self-love 💅

---

and that's the whole thing babes 🍓 this page came from cxl, dated 2026-06-30, and the big fancy header name up top is literally just CXL-DISABLE-PORT(1) again — slay ✨💖🧚