From 2ad9fc8da8cbe69390c648069bb4999a04580738 Mon Sep 17 00:00:00 2001 From: Istvan Kiss Date: Tue, 18 Jun 2024 23:17:37 +0200 Subject: [PATCH] ROCm versioning content prepare for external use --- docs/conf.py | 4 +- docs/reference/3rd-party-support-matrix.rst | 56 +------------------ ...rithm-libraries-support-matrix-content.rst | 55 ++++++++++++++++++ ...ser-kernel-space-compat-matrix-content.rst | 15 +++++ .../user-kernel-space-compat-matrix.rst | 16 +----- 5 files changed, 75 insertions(+), 71 deletions(-) create mode 100644 docs/reference/algorithm-libraries-support-matrix-content.rst create mode 100644 docs/reference/user-kernel-space-compat-matrix-content.rst diff --git a/docs/conf.py b/docs/conf.py index 721db017..f9886368 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -41,7 +41,9 @@ exclude_patterns = [ 'temp', 'how-to/native-install/install-rocm-template.rst', - 'how-to/native-install/uninstall-rocm-template.rst' + 'how-to/native-install/uninstall-rocm-template.rst', + 'reference/algorithm-libraries-support-matrix-content.rst', + 'reference/user-kernel-space-compat-matrix-content.rst' ] external_toc_path = "./sphinx/_toc.yml" diff --git a/docs/reference/3rd-party-support-matrix.rst b/docs/reference/3rd-party-support-matrix.rst index b6af87fa..2d42a1bc 100644 --- a/docs/reference/3rd-party-support-matrix.rst +++ b/docs/reference/3rd-party-support-matrix.rst @@ -107,58 +107,4 @@ support for ROCm devices. Algorithm libraries ================================================ -ROCm releases provide algorithm libraries with interfaces compatible with contemporary -CUDA/NVIDIA HPC SDK alternatives. - -* Thrust → rocThrust -* CUB → hipCUB - -.. list-table:: - :header-rows: 1 - - * - ROCm - - Thrust / CUB - - HPC SDK - - * - 6.1.x - - 2.1.0 - - 22.9 - - * - 6.0.x - - 2.0.1 - - 22.9 - - * - 5.7.x - - 1.17.2 - - 22.9 - - * - 5.6.x - - 1.17.2 - - 22.9 - - * - 5.5.x - - 1.17 - - 22.9 - - * - 5.4.x - - 1.16 - - 22.9 - - * - 5.3.x - - 1.16 - - 22.7 - - * - 5.2.x - - 1.15 - - 22.2, 22.3 - - * - 5.1.3 - - 1.15 - - 22.1 - - * - 5.0.2 - - 1.14 - - 21.9 - -For the latest documentation of these libraries, refer to the ROCm -:doc:`API libraries `. +.. include:: algorithm-libraries-support-matrix-content.rst \ No newline at end of file diff --git a/docs/reference/algorithm-libraries-support-matrix-content.rst b/docs/reference/algorithm-libraries-support-matrix-content.rst new file mode 100644 index 00000000..a2172a1a --- /dev/null +++ b/docs/reference/algorithm-libraries-support-matrix-content.rst @@ -0,0 +1,55 @@ +ROCm releases provide algorithm libraries with interfaces compatible with contemporary +CUDA/NVIDIA HPC SDK alternatives. + +* Thrust → rocThrust +* CUB → hipCUB + +.. list-table:: + :header-rows: 1 + + * - ROCm + - Thrust / CUB + - HPC SDK + + * - 6.1.x + - 2.1.0 + - 22.9 + + * - 6.0.x + - 2.0.1 + - 22.9 + + * - 5.7.x + - 1.17.2 + - 22.9 + + * - 5.6.x + - 1.17.2 + - 22.9 + + * - 5.5.x + - 1.17 + - 22.9 + + * - 5.4.x + - 1.16 + - 22.9 + + * - 5.3.x + - 1.16 + - 22.7 + + * - 5.2.x + - 1.15 + - 22.2, 22.3 + + * - 5.1.3 + - 1.15 + - 22.1 + + * - 5.0.2 + - 1.14 + - 21.9 + +For the latest documentation of these libraries, refer to the ROCm +:doc:`API libraries `. diff --git a/docs/reference/user-kernel-space-compat-matrix-content.rst b/docs/reference/user-kernel-space-compat-matrix-content.rst new file mode 100644 index 00000000..deffca3e --- /dev/null +++ b/docs/reference/user-kernel-space-compat-matrix-content.rst @@ -0,0 +1,15 @@ +ROCm™ provides forward and backward compatibility between the Kernel Fusion +Driver (KFD) and its user space software for +/- 2 releases. This table shows +the compatibility combinations that are currently supported. + +.. csv-table:: + :widths: 30, 70 + :header: "KFD", "Tested user space versions" + + "6.1.x", "5.7.x, 6.0.x" + "6.0.x", "5.6.x, 5.7.x, 6.1.x" + "5.7.x", "5.5.x, 5.6.x, 6.0.x, 6.1.x" + "5.6.x", "5.4.x, 5.5.x, 5.7.x, 6.0.x" + "5.5.x", "5.3.x, 5.4.x, 5.6.x, 5.7.x" + "5.4.x", "5.2.x, 5.3.x, 5.5.x, 5.6.x" + "5.3.x", "5.1.x, 5.2.x, 5.4.x, 5.5.x" diff --git a/docs/reference/user-kernel-space-compat-matrix.rst b/docs/reference/user-kernel-space-compat-matrix.rst index 8491c3f0..e3d37799 100644 --- a/docs/reference/user-kernel-space-compat-matrix.rst +++ b/docs/reference/user-kernel-space-compat-matrix.rst @@ -8,18 +8,4 @@ User and kernel-space support matrix ***************************************************************************************** -ROCm™ provides forward and backward compatibility between the Kernel Fusion -Driver (KFD) and its user space software for +/- 2 releases. This table shows -the compatibility combinations that are currently supported. - -.. csv-table:: - :widths: 30, 70 - :header: "KFD", "Tested user space versions" - - "6.1.x", "5.7.x, 6.0.x" - "6.0.x", "5.6.x, 5.7.x, 6.1.x" - "5.7.x", "5.5.x, 5.6.x, 6.0.x, 6.1.x" - "5.6.x", "5.4.x, 5.5.x, 5.7.x, 6.0.x" - "5.5.x", "5.3.x, 5.4.x, 5.6.x, 5.7.x" - "5.4.x", "5.2.x, 5.3.x, 5.5.x, 5.6.x" - "5.3.x", "5.1.x, 5.2.x, 5.4.x, 5.5.x" +.. include:: user-kernel-space-compat-matrix-content.rst