diff --git a/.wordlist.txt b/.wordlist.txt index 50f37fd40..f8d55a0d7 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -143,6 +143,7 @@ Gemma GiB GIM GL +Glibc GLXT Gloo GMI diff --git a/CHANGELOG.md b/CHANGELOG.md index 166602a57..8ecd218ac 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -490,6 +490,10 @@ The following lists the backward incompatible changes planned for upcoming major * For a CMake bug workaround, set `CMAKE_NO_BUILTIN_CHRPATH` when `BUILD_OFFLOAD_COMPRESS` is unset. +#### Upcoming changes + +* hipTensor 2.x will enhance performance and usability while unifying the API design across all operations (elementwise, reductions, and tensor contractions), enabling consistent multi-stage execution and plan reuse. As part of this change, the API functions `hiptensorInitTensorDescriptor`, `hiptensorContractionDescriptor_t` , `hiptensorInitContractionDescriptor`, `hiptensorInitContractionFind`, `hiptensorContractionGetWorkspaceSize`, `hiptensorInitContractionPlan`, `hiptensorContraction`, `hiptensorElementwiseBinary`, `hiptensorElementwiseTrinary`, `hiptensorPermutation`, and `hiptensorReduction` will be deprecated in a future ROCm release. + ### **llvm-project** (19.0.0) #### Added diff --git a/RELEASE.md b/RELEASE.md index 0f776eba7..c8054567a 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -72,7 +72,7 @@ VP9 support is added to [rocDecode](https://github.com/ROCm/rocDecode) and [rocP ### Bitstream reader support added to rocDecode -The new bitstream reader feature has been added to [rocDecode](https://github.com/ROCm/rocDecode). It contains built-in stream file parsers, including an elementary stream file parser and an IVF container file parser. It enables decoding without the requirement for FFmpeg demuxer. The reader can parse AVC, HEVC, and AV1 elementary stream files, and AV1 IVF container files. +The new bitstream reader feature has been added to [rocDecode](https://github.com/ROCm/rocDecode). It contains built-in stream file parsers, including an elementary stream file parser and an IVF container file parser. It enables decoding without the requirement for FFmpeg demuxer. The reader can parse AVC, HEVC, and AV1 elementary stream files, and AV1 IVF container files. See [Using the rocDecode bitstream reader APIs](https://rocm.docs.amd.com/projects/rocDecode/en/develop/how-to/using-rocDecode-bitstream.html) for more information. ### DLPack support added to rocAL @@ -118,8 +118,6 @@ hipTensor library has been enhanced with: * Additional RDC modules have been developed, and metrics are included. * Plugins for [ROCprofiler-SDK](https://github.com/ROCm/rocprofiler-sdk) has been upgraded and RVS has been added. - - ### ROCm Offline Installer Creator updates The ROCm Offline Installer Creator 6.4.0 adds support for RHEL 9.6 and Oracle Linux 9, and uninstall support for RHEL, SLES, and Oracle Linux. See [ROCm Offline Installer Creator](https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/rocm-offline-installer.html#post-install-options-menu) for more information. @@ -137,6 +135,39 @@ For more information, see [ROCm Runfile Installer](https://rocm.docs.amd.com/pro ROCm 6.4.0 enables dynamic calculation of key-value (KV) cache scaling factors. +### Logical separation of user space and driver space components + +As of ROCm 6.4.0, AMD is making the software for AMD Instinct GPUs more modular by separating the user space components from the driver space components. Previously, ROCm releases and their associated versioning described both the user space and driver. + +ROCm 6.4.0 documentation is for the driver space only. System management documentation has been moved to [Instinct documentation portal](instinct.docs.amd.com.). + +Information on the variant of the `amdgpu` driver built for Instinct GPUs is available on [Instinct driver website](https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/). See [ROCm/ROCK-Kernel-Driver](https://github.com/ROCm/ROCK-Kernel-Driver) repo for source code, which is planned to be renamed to **instinct-driver**. For ROCM 6.4.0, the versioning scheme for the Instinct driver does not change. It's referred to as the Instinct driver version 6.4.0. In the subsequent ROCm minor release, currently planned as ROCm 6.5.0, the Instinct driver version will be separate from the ROCm versioning. + +The long-term benefits of this logical separation of the major software components are: + +* The independent installation of the Instinct driver with a separate version number will allow you to understand the backward and forward compatibility between driver and multiple ROCm user space releases. + +* Clearly defined options for installation combinations: + + * Instinct driver and multiple supported ROCm user space versions. + + * Instinct driver is only to be used with containers and ISV applications. + + * ROCm user space only for software builds and testing. + + * Using the `amdgpu` driver bundled with Linux distributions and ROCm user space released from AMD. + +* Added flexibility for upgrade options: + + * You can upgrade your Instinct driver independently of ROCm user space, or vice versa. + * Bug fixes in either the Instinct driver or ROCm user space might be released independently versus the prior mono-release. + +```{note} +* The above functionality is available in the current unified ROCm user space and driver release. The goal is to provide clearer nomenclature and ontology for the software packages, so you can easily understand the capabilities. The introduction of the Instinct driver package variant of `amdgpu` is the first step towards this. +* There are no restrictions placed on GPU families enabled by the Instinct driver. +* Features prioritized and tested for Instinct drivers will focus on headless (no video out) GPU accelerators. +``` + ### ROCm documentation updates ROCm documentation continues to be updated to provide clearer and more comprehensive guidance for a wider variety of user needs and use cases. @@ -987,6 +1018,10 @@ The following lists the backward incompatible changes planned for upcoming major * For a CMake bug workaround, set `CMAKE_NO_BUILTIN_CHRPATH` when `BUILD_OFFLOAD_COMPRESS` is unset. +#### Upcoming changes + +* hipTensor will enhance performance and usability while unifying the API design across all operations (elementwise, reductions, and tensor contractions), enabling consistent multi-stage execution and plan reuse. As part of this change, the API functions `hiptensorInitTensorDescriptor`, `hiptensorContractionDescriptor_t` , `hiptensorInitContractionDescriptor`, `hiptensorInitContractionFind`, `hiptensorContractionGetWorkspaceSize`, `hiptensorInitContractionPlan`, `hiptensorContraction`, `hiptensorElementwiseBinary`, `hiptensorElementwiseTrinary`, `hiptensorPermutation`, and `hiptensorReduction` will be deprecated in a future ROCm release. + ### **llvm-project** (19.0.0) #### Added diff --git a/docs/compatibility/compatibility-matrix-historical-6.0.csv b/docs/compatibility/compatibility-matrix-historical-6.0.csv index 47132ce4a..6a57c7d81 100644 --- a/docs/compatibility/compatibility-matrix-historical-6.0.csv +++ b/docs/compatibility/compatibility-matrix-historical-6.0.csv @@ -4,9 +4,9 @@ ROCm Version,6.4.0,6.3.3,6.3.2,6.3.1,6.3.0,6.2.4,6.2.2,6.2.1,6.2.0, 6.1.5, 6.1.2 ,,,,,,,,,,"Ubuntu 20.04.6, 20.04.5","Ubuntu 20.04.6, 20.04.5","Ubuntu 20.04.6, 20.04.5","Ubuntu 20.04.6, 20.04.5","Ubuntu 20.04.6, 20.04.5","Ubuntu 20.04.6, 20.04.5" ,"RHEL 9.6, 9.4","RHEL 9.5, 9.4","RHEL 9.5, 9.4","RHEL 9.5, 9.4","RHEL 9.5, 9.4","RHEL 9.4, 9.3","RHEL 9.4, 9.3","RHEL 9.4, 9.3","RHEL 9.4, 9.3","RHEL 9.4, 9.3, 9.2","RHEL 9.4, 9.3, 9.2","RHEL 9.4, 9.3, 9.2","RHEL 9.4, 9.3, 9.2","RHEL 9.3, 9.2","RHEL 9.3, 9.2" ,RHEL 8.10,RHEL 8.10,RHEL 8.10,RHEL 8.10,RHEL 8.10,"RHEL 8.10, 8.9","RHEL 8.10, 8.9","RHEL 8.10, 8.9","RHEL 8.10, 8.9","RHEL 8.9, 8.8","RHEL 8.9, 8.8","RHEL 8.9, 8.8","RHEL 8.9, 8.8","RHEL 8.9, 8.8","RHEL 8.9, 8.8" - ,"SLES 15 SP7, SP6","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP5, SP4","SLES 15 SP5, SP4","SLES 15 SP5, SP4","SLES 15 SP5, SP4","SLES 15 SP5, SP4","SLES 15 SP5, SP4" + ,SLES 15 SP6,"SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP6, SP5","SLES 15 SP5, SP4","SLES 15 SP5, SP4","SLES 15 SP5, SP4","SLES 15 SP5, SP4","SLES 15 SP5, SP4","SLES 15 SP5, SP4" ,,,,,,,,,,,CentOS 7.9,CentOS 7.9,CentOS 7.9,CentOS 7.9,CentOS 7.9 - ,"Oracle Linux 9.5, 8.10 [#mi300x-past-60]_",Oracle Linux 8.10 [#mi300x-past-60]_,Oracle Linux 8.10 [#mi300x-past-60]_,Oracle Linux 8.10 [#mi300x-past-60]_,Oracle Linux 8.10 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,,, + ,"Oracle Linux 9, 8 [#mi300x-past-60]_",Oracle Linux 8.10 [#mi300x-past-60]_,Oracle Linux 8.10 [#mi300x-past-60]_,Oracle Linux 8.10 [#mi300x-past-60]_,Oracle Linux 8.10 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,Oracle Linux 8.9 [#mi300x-past-60]_,,, ,Debian 12 [#single-node-past-60]_,Debian 12 [#single-node-past-60]_,Debian 12 [#single-node-past-60]_,Debian 12 [#single-node-past-60]_,,,,,,,,,,, ,Azure Linux 3.0 [#mi300x-past-60]_,Azure Linux 3.0 [#mi300x-past-60]_,Azure Linux 3.0 [#mi300x-past-60]_,,,,,,,,,,,, ,.. _architecture-support-compatibility-matrix-past-60:,,,,,,,,,,,,,, @@ -37,7 +37,7 @@ ROCm Version,6.4.0,6.3.3,6.3.2,6.3.1,6.3.0,6.2.4,6.2.2,6.2.1,6.2.0, 6.1.5, 6.1.2 CUB,2.3.2,2.3.2,2.3.2,2.3.2,2.3.2,2.2.0,2.2.0,2.2.0,2.2.0,2.1.0,2.1.0,2.1.0,2.1.0,2.0.1,2.0.1 ,,,,,,,,,,,,,,, KMD & USER SPACE [#kfd_support-past-60]_,.. _kfd-userspace-support-compatibility-matrix-past-60:,,,,,,,,,,,,,, - Tested user space versions,"6.4.x, 6.3.x, 6.2.x, 6.1.x","6.3.x, 6.2.x, 6.1.x","6.3.x, 6.2.x, 6.1.x","6.3.x, 6.2.x, 6.1.x","6.3.x, 6.2.x, 6.1.x","6.3.x, 6.2.x, 6.1.x, 6.0.x","6.3.x, 6.2.x, 6.1.x, 6.0.x","6.3.x, 6.2.x, 6.1.x, 6.0.x","6.3.x, 6.2.x, 6.1.x, 6.0.x","6.3.x, 6.2.x, 6.1.x, 6.0.x, 5.7.x","6.3.x, 6.2.x, 6.1.x, 6.0.x, 5.7.x","6.3.x, 6.2.x, 6.1.x, 6.0.x, 5.7.x","6.3.x, 6.2.x, 6.1.x, 6.0.x, 5.7.x","6.2.x, 6.1.x, 6.0.x, 5.7.x, 5.6.x","6.2.x, 6.1.x, 6.0.x, 5.7.x, 5.6.x" + Tested user space versions,"6.4.x, 6.3.x, 6.2.x, 6.1.x","6.4.x, 6.3.x, 6.2.x, 6.1.x","6.4.x, 6.3.x, 6.2.x, 6.1.x","6.4.x, 6.3.x, 6.2.x, 6.1.x","6.4.x, 6.3.x, 6.2.x, 6.1.x","6.3.x, 6.2.x, 6.1.x, 6.0.x","6.3.x, 6.2.x, 6.1.x, 6.0.x","6.3.x, 6.2.x, 6.1.x, 6.0.x","6.3.x, 6.2.x, 6.1.x, 6.0.x","6.3.x, 6.2.x, 6.1.x, 6.0.x, 5.7.x","6.3.x, 6.2.x, 6.1.x, 6.0.x, 5.7.x","6.3.x, 6.2.x, 6.1.x, 6.0.x, 5.7.x","6.3.x, 6.2.x, 6.1.x, 6.0.x, 5.7.x","6.2.x, 6.1.x, 6.0.x, 5.7.x, 5.6.x","6.2.x, 6.1.x, 6.0.x, 5.7.x, 5.6.x" ,,,,,,,,,,,,,,, ML & COMPUTER VISION,.. _mllibs-support-compatibility-matrix-past-60:,,,,,,,,,,,,,, :doc:`Composable Kernel `,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0,1.1.0 diff --git a/docs/compatibility/compatibility-matrix.rst b/docs/compatibility/compatibility-matrix.rst index 47992ffde..5a9c7ce83 100644 --- a/docs/compatibility/compatibility-matrix.rst +++ b/docs/compatibility/compatibility-matrix.rst @@ -30,8 +30,8 @@ compatibility and system requirements. ,Ubuntu 22.04.5,Ubuntu 22.04.5,"Ubuntu 22.04.5, 22.04.4" ,"RHEL 9.6, 9.4","RHEL 9.5, 9.4","RHEL 9.4, 9.3" ,RHEL 8.10,RHEL 8.10,"RHEL 8.10, 8.9" - ,"SLES 15 SP7, SP6","SLES 15 SP6, SP5","SLES 15 SP6, SP5" - ,"Oracle Linux 9.5, 8.10 [#mi300x]_",Oracle Linux 8.10 [#mi300x]_,Oracle Linux 8.9 [#mi300x]_ + ,"SLES 15 SP6","SLES 15 SP6, SP5","SLES 15 SP6, SP5" + ,"Oracle Linux 9, 8 [#mi300x]_",Oracle Linux 8.10 [#mi300x]_,Oracle Linux 8.9 [#mi300x]_ ,Debian 12 [#single-node]_,Debian 12 [#single-node]_, ,Azure Linux 3.0 [#mi300x]_,Azure Linux 3.0 [#mi300x]_, ,.. _architecture-support-compatibility-matrix:,, @@ -62,7 +62,7 @@ compatibility and system requirements. CUB,2.3.2,2.3.2,2.2.0 ,,, KMD & USER SPACE [#kfd_support]_,.. _kfd-userspace-support-compatibility-matrix:,, - Tested user space versions,"6.4.x, 6.3.x, 6.2.x, 6.1.x","6.3.x, 6.2.x, 6.1.x","6.3.x, 6.2.x, 6.1.x, 6.0.x" + Tested user space versions,"6.4.x, 6.3.x, 6.2.x, 6.1.x","6.4.x, 6.3.x, 6.2.x, 6.1.x","6.3.x, 6.2.x, 6.1.x, 6.0.x" ,,, ML & COMPUTER VISION,.. _mllibs-support-compatibility-matrix:,, :doc:`Composable Kernel `,1.1.0,1.1.0,1.1.0 @@ -155,43 +155,44 @@ compatibility and system requirements. .. _OS-kernel-versions: -Operating systems and kernel versions -************************************* +Operating systems, kernel and Glibc versions +********************************************* Use this lookup table to confirm which operating system and kernel versions are supported with ROCm. .. csv-table:: - :header: "OS", "Version", "Kernel" - :widths: 40, 20, 40 + :header: "OS", "Version", "Kernel", "Glibc" + :widths: 40, 20, 30, 20 :stub-columns: 1 - `Ubuntu `_, 24.04.2, "6.8 GA, 6.11 HWE" - , 24.04, "6.8 GA" + `Ubuntu `_, 24.04.2, "6.8 GA, 6.11 HWE", 2.39 ,, - `Ubuntu `_, 22.04.5, "5.15 GA, 6.8 HWE" - , 22.04.4, "5.15 GA, 6.5 HWE" + `Ubuntu `_, 22.04.5, "5.15 GA, 6.8 HWE", 2.35 ,, - `Red Hat Enterprise Linux (RHEL 9) `_, 9.6, x.x.x - ,9.5, 5.14.0 - ,9.4, 5.14.0 - ,9.3, 5.14.0 + `Red Hat Enterprise Linux (RHEL 9) `_, 9.6, 5.14+, 2.34 + ,9.5, 5.14+, 2.34 + ,9.4, 5.14+, 2.34 + ,9.3, 5.14+, ,, - `Red Hat Enterprise Linux (RHEL 8) `_, 8.10, 4.18.0 + `Red Hat Enterprise Linux (RHEL 8) `_, 8.10, 4.18.0+, 2.38 ,8.9, 4.18.0 ,, - `SUSE Linux Enterprise Server (SLES) `_, 15 SP7, x.x.x - ,15 SP6, 6.4.0 - ,15 SP5, 5.14.21 + `SUSE Linux Enterprise Server (SLES) `_, 15 SP6, "6.5.0+, 6.4.0", 2.38 + ,15 SP5, 5.14.21, ,, - `Oracle Linux `_, 9.5, x.x.x - ,8.10, 5.15.0 - ,8.9, 5.15.0 + `Oracle Linux `_, 9, 5.15.0 (UEK), 2.35 + ,8, 5.15.0 (UEK), + ,8.9, 5.15.0, ,, - `Debian `_,12, 6.1 + `Debian `_,12, 6.1, 2.36 ,, - `Azure Linux `_,3.0, 6.6 + `Azure Linux `_,3.0, 6.6.60, 2.38 ,, +.. note:: + + * See `Red Hat Enterprise Linux Release Dates `_ to learn about the specific kernel versions supported on Red Hat Enterprise Linux (RHEL). + * See `List of SUSE Linux Enterprise Server kernel `_ to learn about the specific kernel version supported on SUSE Linux Enterprise Server (SLES). .. Footnotes and ref anchors in below historical tables should be appended with "-past-60", to differentiate from the footnote references in the above, latest, compatibility matrix. It also allows to easily find & replace. diff --git a/docs/sphinx/_toc.yml.in b/docs/sphinx/_toc.yml.in index 1f8d00508..cfbda7fb6 100644 --- a/docs/sphinx/_toc.yml.in +++ b/docs/sphinx/_toc.yml.in @@ -12,7 +12,7 @@ subtrees: - file: compatibility/compatibility-matrix.rst title: Compatibility matrix entries: - - url: https://rocm.docs.amd.com/projects/install-on-linux/en/${branch}/reference/system-requirements.html + - url: https://rocm.docs.amd.com/projects/install-on-linux-internal/en/latest/reference/system-requirements.html title: Linux system requirements - url: https://rocm.docs.amd.com/projects/install-on-windows/en/${branch}/reference/system-requirements.html title: Windows system requirements