mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2025-08-17 03:50:30 +00:00

There exists shipping platforms that bend, break, or otherwise lean on ambiguities in the CXL specification. Without driver changes to accommodate these deviations, end users are left without CXL subsystem RAS features. Specifically, provisioning, error translation, and other flows require the CXL subsystem to understand the platforms CXL topology beyond undecorated memory address ranges. Those isolated compatibility problems risk growing into deeper upstream maintenance burden if different platform vendors arrive at diverging solutions. For example, there are multiple options for resolving low-memory-mmio intersecting large-interleave-ways CXL windows. Linux should only entertain one solution to that problem. Now, with the ACPI Specification Working Group, situations like this would be resolved with the "Code First ECN" process to codify Linux expectations in a specification. In the absence of such a process for the CXL specification, create a file in Linux documentation to detail the motivations, assumptions, tradeoffs, and proposals for amending specification language. The goal is to capture the issues such that platform vendors arrive at compatible solutions for these problems and serve as a repository for potential specification updates. The expectation is to update conventions.rst along with CXL subsystem code changes to accommodate the platform topology. [ dj: Rebased against v6.16-rc1 ] Signed-off-by: Dan Williams <dan.j.williams@intel.com> Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> Reviewed-by: Dave Jiang <dave.jiang@intel.com> Reviewed-by: Robert Richter <rrichter@amd.com> Link: https://patch.msgid.link/20250603185254.3730099-1-dan.j.williams@intel.com Signed-off-by: Dave Jiang <dave.jiang@intel.com>
48 lines
1.1 KiB
ReStructuredText
48 lines
1.1 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
.. include:: <isonum.txt>
|
|
|
|
=======================================
|
|
Compute Express Link: Linux Conventions
|
|
=======================================
|
|
|
|
There exists shipping platforms that bend or break CXL specification
|
|
expectations. Record the details and the rationale for those deviations.
|
|
Borrow the ACPI Code First template format to capture the assumptions
|
|
and tradeoffs such that multiple platform implementations can follow the
|
|
same convention.
|
|
|
|
<(template) Title>
|
|
==================
|
|
|
|
Document
|
|
--------
|
|
CXL Revision <rev>, Version <ver>
|
|
|
|
License
|
|
-------
|
|
SPDX-License Identifier: CC-BY-4.0
|
|
|
|
Creator/Contributors
|
|
--------------------
|
|
|
|
Summary of the Change
|
|
---------------------
|
|
|
|
<Detail the conflict with the specification and where available the
|
|
assumptions and tradeoffs taken by the hardware platform.>
|
|
|
|
|
|
Benefits of the Change
|
|
----------------------
|
|
|
|
<Detail what happens if platforms and Linux do not adopt this
|
|
convention.>
|
|
|
|
References
|
|
----------
|
|
|
|
Detailed Description of the Change
|
|
----------------------------------
|
|
|
|
<Propose spec language that corrects the conflict.>
|