CXL-DISABLE-PORT(1) cxl Manual CXL-DISABLE-PORT(1)

# [NAME](#NAME)

cxl-disable-port - disable / hot-remove a given CXL port and descendants

# [SYNOPSIS](#SYNOPSIS)

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

For test and debug scenarios, disable a CXL port and any memory devices dependent on this port being active for CXL.mem operation.

Given 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 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.

# [OPTIONS](#OPTIONS)

-e, --endpoint

Toggle from treating the port arguments as Switch Port identifiers to Endpoint Port identifiers.

-f, --force

DANGEROUS: Override the safety measure that blocks attempts to disable a port if the tool determines a descendent memdev is in active usage. 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.

--debug

Turn on additional debug messages including library debug.

# [COPYRIGHT](#COPYRIGHT)

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

# [SEE ALSO](#SEE_ALSO)

[cxl-disable-port(1)](/man/os/ndctl/cxl-disable-port.1)

2026-10-30 cxl

---

Document: cxl-disable-port(1) from ndctl 85-r4 (Chainguard OS)
Source: https://github.com/pmem/ndctl
