[<prev] [next>] [thread-next>] [day] [month] [year] [list]
Message-ID: <20250430001224.1028656-1-gourry@gourry.net>
Date: Tue, 29 Apr 2025 20:12:07 -0400
From: Gregory Price <gourry@...rry.net>
To: linux-cxl@...r.kernel.org
Cc: linux-doc@...r.kernel.org,
linux-kernel@...r.kernel.org,
kernel-team@...a.com,
dave@...olabs.net,
jonathan.cameron@...wei.com,
dave.jiang@...el.com,
alison.schofield@...el.com,
vishal.l.verma@...el.com,
ira.weiny@...el.com,
dan.j.williams@...el.com,
corbet@....net,
Joshua Hahn <joshua.hahnjy@...il.com>
Subject: [RFC PATCH 00/17] CXL Boot to Bash Documentation
This series converts CXL Boot to Bash Docs to Linux Kernel Docs.
I tried to break it into separate patches to make it easier for
people with specific expertise to review.
The big open TODOs:
- use-case documentation.
I only have the type-3 perspective, and only one perspective.
It would be good to have that hacked on more generally.
- memory tiering documentation.
I basically left this unfilled for now. Would like some basic
docs on at least TPP and DAMON.
- devices: CDAT explanation
It would be good to have this spelled out at least a little bit.
- platform: ACPI SRAT Generic port / initiator docs
I don't know anything about this and people say it's important.
Thank you to everyone who contributed feedback during LSF/MM
Boot-to-Bash proposal. Hopefully I incorporated most feedback,
but I may have missed some.
Co-developed-by: Joshua Hahn <joshua.hahnjy@...il.com>
Signed-off-by: Joshua Hahn <joshua.hahnjy@...il.com>
Signed-off-by: Gregory Price <gourry@...rry.net>
Gregory Price (17):
cxl: update documentation structure in prep for new docs
cxl: docs/devices - device reference and uefi placeholder
cxl: docs/platform/bios-and-efi documentation
cxl: docs/platform/acpi reference documentation
cxl: docs/platform/example-configs documentation
cxl: docs/linux - overview
cxl: docs/linux - early boot configuration
cxl: docs/linux - add cxl-driver theory of operation
cxl: docs/linux/cxl-driver - add example configurations
cxl: docs/linux/dax-driver documentation
cxl: docs/linux/memory-hotplug
cxl: docs/allocation/dax
cxl: docs/allocation/page-allocator
cxl: docs/allocation/reclaim
cxl: docs/allocation/hugepages
cxl: docs/allocation/tiering
cxl: docs/use-cases
.../driver-api/cxl/allocation/dax.rst | 59 ++
.../driver-api/cxl/allocation/hugepages.rst | 30 +
.../cxl/allocation/page-allocator.rst | 85 +++
.../driver-api/cxl/allocation/reclaim.rst | 50 ++
.../driver-api/cxl/allocation/tiering.rst | 30 +
.../driver-api/cxl/devices/device-types.rst | 169 ++++++
.../theory-of-operation.rst} | 0
Documentation/driver-api/cxl/devices/uefi.rst | 9 +
Documentation/driver-api/cxl/index.rst | 55 +-
.../cxl/{ => linux}/access-coordinates.rst | 0
.../driver-api/cxl/linux/cxl-driver.rst | 531 ++++++++++++++++++
.../driver-api/cxl/linux/dax-driver.rst | 42 ++
.../driver-api/cxl/linux/early-boot.rst | 129 +++++
.../example-configurations/hb-interleave.rst | 314 +++++++++++
.../intra-hb-interleave.rst | 291 ++++++++++
.../multi-interleave.rst | 401 +++++++++++++
.../example-configurations/single-device.rst | 246 ++++++++
.../driver-api/cxl/linux/memory-hotplug.rst | 77 +++
.../driver-api/cxl/linux/overview.rst | 104 ++++
.../driver-api/cxl/platform/acpi.rst | 83 +++
.../driver-api/cxl/platform/acpi/cedt.rst | 52 ++
.../driver-api/cxl/platform/acpi/dsdt.rst | 27 +
.../driver-api/cxl/platform/acpi/hmat.rst | 28 +
.../driver-api/cxl/platform/acpi/slit.rst | 17 +
.../driver-api/cxl/platform/acpi/srat.rst | 37 ++
.../driver-api/cxl/platform/bios-and-efi.rst | 261 +++++++++
.../cxl/platform/example-configs.rst | 13 +
.../example-configurations/flexible.rst | 296 ++++++++++
.../example-configurations/hb-interleave.rst | 107 ++++
.../multi-dev-per-hb.rst | 90 +++
.../example-configurations/one-dev-per-hb.rst | 136 +++++
.../cxl/use-case/dynamic-capacity.rst | 19 +
.../cxl/use-case/memory-expansion.rst | 14 +
.../driver-api/cxl/use-case/shared-memory.rst | 14 +
.../cxl/use-case/virtual-machines.rst | 18 +
35 files changed, 3831 insertions(+), 3 deletions(-)
create mode 100644 Documentation/driver-api/cxl/allocation/dax.rst
create mode 100644 Documentation/driver-api/cxl/allocation/hugepages.rst
create mode 100644 Documentation/driver-api/cxl/allocation/page-allocator.rst
create mode 100644 Documentation/driver-api/cxl/allocation/reclaim.rst
create mode 100644 Documentation/driver-api/cxl/allocation/tiering.rst
create mode 100644 Documentation/driver-api/cxl/devices/device-types.rst
rename Documentation/driver-api/cxl/{memory-devices.rst => devices/theory-of-operation.rst} (100%)
create mode 100644 Documentation/driver-api/cxl/devices/uefi.rst
rename Documentation/driver-api/cxl/{ => linux}/access-coordinates.rst (100%)
create mode 100644 Documentation/driver-api/cxl/linux/cxl-driver.rst
create mode 100644 Documentation/driver-api/cxl/linux/dax-driver.rst
create mode 100644 Documentation/driver-api/cxl/linux/early-boot.rst
create mode 100644 Documentation/driver-api/cxl/linux/example-configurations/hb-interleave.rst
create mode 100644 Documentation/driver-api/cxl/linux/example-configurations/intra-hb-interleave.rst
create mode 100644 Documentation/driver-api/cxl/linux/example-configurations/multi-interleave.rst
create mode 100644 Documentation/driver-api/cxl/linux/example-configurations/single-device.rst
create mode 100644 Documentation/driver-api/cxl/linux/memory-hotplug.rst
create mode 100644 Documentation/driver-api/cxl/linux/overview.rst
create mode 100644 Documentation/driver-api/cxl/platform/acpi.rst
create mode 100644 Documentation/driver-api/cxl/platform/acpi/cedt.rst
create mode 100644 Documentation/driver-api/cxl/platform/acpi/dsdt.rst
create mode 100644 Documentation/driver-api/cxl/platform/acpi/hmat.rst
create mode 100644 Documentation/driver-api/cxl/platform/acpi/slit.rst
create mode 100644 Documentation/driver-api/cxl/platform/acpi/srat.rst
create mode 100644 Documentation/driver-api/cxl/platform/bios-and-efi.rst
create mode 100644 Documentation/driver-api/cxl/platform/example-configs.rst
create mode 100644 Documentation/driver-api/cxl/platform/example-configurations/flexible.rst
create mode 100644 Documentation/driver-api/cxl/platform/example-configurations/hb-interleave.rst
create mode 100644 Documentation/driver-api/cxl/platform/example-configurations/multi-dev-per-hb.rst
create mode 100644 Documentation/driver-api/cxl/platform/example-configurations/one-dev-per-hb.rst
create mode 100644 Documentation/driver-api/cxl/use-case/dynamic-capacity.rst
create mode 100644 Documentation/driver-api/cxl/use-case/memory-expansion.rst
create mode 100644 Documentation/driver-api/cxl/use-case/shared-memory.rst
create mode 100644 Documentation/driver-api/cxl/use-case/virtual-machines.rst
--
2.49.0
Powered by blists - more mailing lists