NAME¶

cxl-enable-port - activate / hot-add a given CXL port

SYNOPSIS¶

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

A port typically autoenables at initial device discovery. However, if it was manually disabled this command can trigger the kernel to activate it again. This involves detecting the state of the HDM (Host Managed Device Memory) Decoders and validating that CXL.mem is enabled for each port in the device’s hierarchy.

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¶

-e, --endpoint

-m, --enable-memdevs

Note: The '-m' option requires release v83 or newer when used with
kernel v6.18 or later. Older releases (before v83) will not work
because kernel v6.18 changed how CXL ports and downstream ports are
enumerated. In these newer kernels, the CXL port hierarchy is only
established once the memdev is probed. v83 and later remain fully
compatible with both older and newer kernels.

--debug

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)