Update documentation requirements

.readthedocs.yaml

@@ -3,12 +3,19 @@
 
 version: 2
 
+build:
+   os: ubuntu-22.04
+   tools:
+      python: "3.10"
+   apt_packages:
+     - "doxygen"
+     - "graphviz" # For dot graphs in doxygen
+
+python:
+   install:
+   - requirements: docs/sphinx/requirements.txt
+
 sphinx:
    configuration: docs/conf.py
 
-formats: [htmlzip, pdf, epub]
-
-python:
-   version: "3.8"
-   install:
-   - requirements: docs/sphinx/requirements.txt
+formats: []

RELEASE.md

@@ -15,69 +15,17 @@ The release notes for the ROCm platform.
 
 -------------------
 
-## ROCm 5.2.3
+## ROCm 5.0.1
 <!-- markdownlint-disable first-line-h1 -->
 <!-- markdownlint-disable no-duplicate-header -->
-### Changes in This Release
+### Deprecations and Warnings
 
-#### Ubuntu 18.04 End of Life Announcement
+#### Refactor of HIPCC/HIPCONFIG
 
-Support for Ubuntu 18.04 ends in this release. Future releases of ROCm will not provide prebuilt packages for Ubuntu 18.04.
-HIP and Other Runtimes
+In prior ROCm releases, by default, the hipcc/hipconfig Perl scripts were used to identify and set target compiler options, target platform, compiler, and runtime appropriately.
 
-#### HIP Runtime
+In ROCm v5.0.1, hipcc.bin and hipconfig.bin have been added as the compiled binary implementations of the hipcc and hipconfig. These new binaries are currently a work-in-progress, considered, and marked as experimental. ROCm plans to fully transition to hipcc.bin and hipconfig.bin in the a future ROCm release. The existing hipcc and hipconfig Perl scripts are renamed to hipcc.pl and hipconfig.pl respectively. New top-level hipcc and hipconfig Perl scripts are created, which can switch between the Perl script or the compiled binary based on the environment variable HIPCC_USE_PERL_SCRIPT.
 
-##### Fixes
+In ROCm 5.0.1, by default, this environment variable is set to use hipcc and hipconfig through the Perl scripts.
 
-- A bug was discovered in the HIP graph capture implementation in the ROCm v5.2.0 release. If the same kernel is called twice (with different argument values) in a graph capture, the implementation only kept the argument values for the second kernel call.
-
-- A bug was introduced in the hiprtc implementation in the ROCm v5.2.0 release. This bug caused the `hiprtcGetLoweredName` call to fail for named expressions with whitespace in it.
-
-Example:
-
-The named expression `my_sqrt<complex<double>>` passed but `my_sqrt<complex<double >>` failed.
-ROCm Libraries
-
-#### RCCL
-
-##### Added
-
-Compatibility with NCCL 2.12.10
-
-- Packages for test and benchmark executables on all supported OSes using CPack
-
-- Added custom signal handler - opt-in with RCCL_ENABLE_SIGNALHANDLER=1
-
-  - Additional details provided if Binary File Descriptor library (BFD) is pre-installed.
-
-- Added experimental support for using multiple ranks per device
-
-  - Requires using a new interface to create communicator (ncclCommInitRankMulti), refer to the interface documentation for details.
-
-  - To avoid potential deadlocks, user might have to set an environment variables increasing    the number of hardware queues. For example,
-
-```sh
-export GPU_MAX_HW_QUEUES=16
-```
-
-- Added support for reusing ports in NET/IB channels
-
-  - Opt-in with NCCL_IB_SOCK_CLIENT_PORT_REUSE=1 and NCCL_IB_SOCK_SERVER_PORT_REUSE=1
-
-  - When "Call to bind failed: Address already in use" error happens in large-scale AlltoAll(for example, >=64 MI200 nodes), users are suggested to opt-in either one or both of the options to resolve the massive port usage issue
-
-  - Avoid using NCCL_IB_SOCK_SERVER_PORT_REUSE when NCCL_NCHANNELS_PER_NET_PEER is tuned >1
-
-##### Removed
-
-- Removed experimental clique-based kernels
-
-#### Development Tools
-
-No notable changes in this release for development tools, including the compiler, profiler, and debugger
-Deployment and Management Tools
-
-No notable changes in this release for deployment and management tools.
-Older ROCm Releases
-
-For release information for older ROCm releases, refer to <https://github.com/RadeonOpenCompute/ROCm/blob/master/CHANGELOG.md>
+Subsequently, Perl scripts will no longer be available in ROCm in a future release.

docs/conf.py

@@ -14,6 +14,13 @@ shutil.copy2('../RELEASE.md','./release.md')
 # Keep capitalization due to similar linking on GitHub's markdown preview.
 shutil.copy2('../CHANGELOG.md','./CHANGELOG.md')
 
+# configurations for PDF output by Read the Docs
+project = "ROCm Documentation"
+author = "Advanced Micro Devices, Inc."
+copyright = "Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved."
+version = "5.0.1"
+release = "5.0.1"
+
 setting_all_article_info = True
 all_article_info_os = ["linux"]
 all_article_info_author = ""
@@ -57,7 +64,7 @@ article_pages = [
 
 external_toc_path = "./sphinx/_toc.yml"
 
-docs_core = ROCmDocs("ROCm Documentation Home")
+docs_core = ROCmDocs("ROCm 5.0.1 Documentation Home")
 docs_core.setup()
 
 external_projects_current_project = "rocm"

docs/deploy/linux/installer/install.md

@@ -18,8 +18,8 @@ following commands based on your distribution.
 
 ```shell
 sudo apt update
-wget https://repo.radeon.com/amdgpu-install/22.20.3/ubuntu/bionic/amdgpu-install_22.20.50203-1_all.deb
-sudo apt install ./amdgpu-install_22.20.50203-1_all.deb
+wget https://repo.radeon.com/amdgpu-install/21.50.1/ubuntu/bionic/amdgpu-install_21.50.1.50001-1_all.deb
+sudo apt install ./amdgpu-install_21.50.1.50001-1_all.deb
 ```
 
 :::
@@ -28,8 +28,8 @@ sudo apt install ./amdgpu-install_22.20.50203-1_all.deb
 
 ```shell
 sudo apt update
-wget https://repo.radeon.com/amdgpu-install/22.20.3/ubuntu/focal/amdgpu-install_22.20.50203-1_all.deb
-sudo apt install ./amdgpu-install_22.20.50203-1_all.deb
+wget https://repo.radeon.com/amdgpu-install/21.50.1/ubuntu/focal/amdgpu-install_21.50.1.50001-1_all.deb
+sudo apt install ./amdgpu-install_21.50.1.50001-1_all.deb
 ```
 
 :::
@@ -44,7 +44,16 @@ sudo apt install ./amdgpu-install_22.20.50203-1_all.deb
 :sync: RHEL-7
 
 ```shell
-sudo yum install https://repo.radeon.com/amdgpu-install/22.20.3/rhel/7.9/amdgpu-install-22.20.50203-1.el7.noarch.rpm
+sudo yum install https://repo.radeon.com/amdgpu-install/21.50.1/rhel/7.9/amdgpu-install-21.50.1.50001-1.el7.noarch.rpm
+```
+
+:::
+:::{tab-item} RHEL 8.4
+:sync: RHEL-8.4
+:sync: RHEL-8
+
+```shell
+sudo yum install https://repo.radeon.com/amdgpu-install/21.50.1/rhel/8.4/amdgpu-install-21.50.1.50001-1.el7.noarch.rpm
 ```
 
 :::
@@ -53,16 +62,7 @@ sudo yum install https://repo.radeon.com/amdgpu-install/22.20.3/rhel/7.9/amdgpu-
 :sync: RHEL-8
 
 ```shell
-sudo yum install https://repo.radeon.com/amdgpu-install/22.20.3/rhel/8.5/amdgpu-install-22.20.50203-1.el8.noarch.rpm
-```
-
-:::
-:::{tab-item} RHEL 8.6
-:sync: RHEL-8.6
-:sync: RHEL-8
-
-```shell
-sudo yum install https://repo.radeon.com/amdgpu-install/22.20.3/rhel/8.6/amdgpu-install-22.20.50203-1.el8.noarch.rpm
+sudo yum install https://repo.radeon.com/amdgpu-install/21.50.1/rhel/8.5/amdgpu-install-21.50.1.50001-1.el7.noarch.rpm
 ```
 
 :::
@@ -72,19 +72,11 @@ sudo yum install https://repo.radeon.com/amdgpu-install/22.20.3/rhel/8.6/amdgpu-
 :sync: SLES15
 
 ::::{tab-set}
-:::{tab-item} Service Pack 4
-:sync: SLES15-SP4
-
-```shell
-sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/22.20.3/sle/15.4/amdgpu-install-22.20.50203-1.noarch.rpm
-```
-
-:::
 :::{tab-item} Service Pack 3
 :sync: SLES15-SP3
 
 ```shell
-sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/22.20.3/sle/15.3/amdgpu-install-22.20.50203-1.noarch.rpm
+sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/21.50.1/sle/15/amdgpu-install-21.50.1.50001-1.noarch.rpm
 ```
 
 :::
@@ -163,9 +155,9 @@ the installer script will install packages in the single-version layout.
 For the multi-version ROCm installation you must use the installer script from
 the latest release of ROCm that you wish to install.
 
-**Example:** If you want to install ROCm releases 5.1.3 and 5.2.3
+**Example:** If you want to install ROCm releases 5.0.0 and 5.0.1
 simultaneously, you are required to download the installer from the latest ROCm
-release v5.2.3.
+release v5.0.1.
 
 ### Add Required Repositories
 
@@ -184,10 +176,12 @@ Run the following commands based on your distribution to add the repositories:
 :sync: ubuntu-18.04
 
 ```shell
-for ver in 5.1.3 5.2.2; do
-echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/rocm-keyring.gpg] https://repo.radeon.com/rocm/apt/$ver bionic main" | sudo tee /etc/apt/sources.list.d/rocm.list
+for ver in 5.0; do
+echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/rocm-keyring.gpg] https://repo.radeon.com/rocm/apt/$ver bionic main" \
+  | sudo tee /etc/apt/sources.list.d/rocm.list
 done
-echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' | sudo tee /etc/apt/preferences.d/rocm-pin-600
+echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \
+  | sudo tee /etc/apt/preferences.d/rocm-pin-600
 sudo apt update
 ```
 
@@ -196,10 +190,12 @@ sudo apt update
 :sync: ubuntu-20.04
 
 ```shell
-for ver in 5.1.3 5.2.2; do
-echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/rocm-keyring.gpg] https://repo.radeon.com/rocm/apt/$ver focal main" | sudo tee /etc/apt/sources.list.d/rocm.list
+for ver in 5.0; do
+echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/rocm-keyring.gpg] https://repo.radeon.com/rocm/apt/$ver focal main" \
+  | sudo tee /etc/apt/sources.list.d/rocm.list
 done
-echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' | sudo tee /etc/apt/preferences.d/rocm-pin-600
+echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \
+  | sudo tee /etc/apt/preferences.d/rocm-pin-600
 sudo apt update
 ```
 
@@ -214,7 +210,7 @@ sudo apt update
 :sync: RHEL-7
 
 ```shell
-for ver in 5.1.3 5.2.2; do
+for ver in 5.0; do
 sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -233,7 +229,7 @@ sudo yum clean all
 :sync: RHEL-8
 
 ```shell
-for ver in 5.1.3 5.2.2; do
+for ver in 5.0;
 sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -258,27 +254,10 @@ sudo yum clean all
 :sync: SLES15-SP3
 
 ```shell
-for ver in 5.1.3 5.2.2; do
+for ver in 5.0; do
 sudo tee --append /etc/zypp/repos.d/rocm.repo <<EOF
 name=rocm
-baseurl=https://repo.radeon.com/rocm/$ver/sle/15.3/main/x86_64
-enabled=1
-gpgcheck=1
-gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
-EOF
-done
-sudo zypper ref
-```
-
-:::
-:::{tab-item} Service Pack 4
-:sync: SLES15-SP4
-
-```shell
-for ver in 5.1.3 5.2.2; do
-sudo tee --append /etc/zypp/repos.d/rocm.repo <<EOF
-name=rocm
-baseurl=https://repo.radeon.com/rocm/$ver/sle/15.4/main/x86_64
+baseurl=https://repo.radeon.com/rocm/$ver/sle/15/main/x86_64
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
@@ -308,8 +287,8 @@ driver, associated with the ROCm release v5.3, will be installed as its latest
 release in the list.
 
 ```none
-sudo amdgpu-install --usecase=rocm --rocmrelease=5.1.3
-sudo amdgpu-install --usecase=rocm --rocmrelease=5.2.3
+sudo amdgpu-install --usecase=rocm --rocmrelease=5.0.0
+sudo amdgpu-install --usecase=rocm --rocmrelease=5.0.1
 ```
 
 ## Additional options

docs/deploy/linux/os-native/install.md

@@ -48,23 +48,23 @@ section.
 To add the AMDGPU repository, follow these steps:
 
 ::::{tab-set}
-:::{tab-item} Ubuntu 20.04
-:sync: ubuntu-20.04
+:::{tab-item} Ubuntu 18.04
+:sync: ubuntu-18.04
 
 ```shell
-# amdgpu repository for focal
-echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/22.20.3/ubuntu focal main' \
+# amdgpu repository for bionic
+echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/21.50.1/ubuntu bionic main' \
     | sudo tee /etc/apt/sources.list.d/amdgpu.list
 sudo apt update
 ```
 
 :::
-:::{tab-item} Ubuntu 22.04
-:sync: ubuntu-22.04
+:::{tab-item} Ubuntu 20.04
+:sync: ubuntu-20.04
 
 ```shell
-# amdgpu repository for jammy
-echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/22.20.3/ubuntu jammy main' \
+# amdgpu repository for focal
+echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/21.50.1/ubuntu focal main' \
     | sudo tee /etc/apt/sources.list.d/amdgpu.list
 sudo apt update
 ```
@@ -91,7 +91,7 @@ To add the ROCm repository, use the following steps:
 
 ```shell
 # ROCm repositories for bionic
-for ver in 5.1.3 5.2.3; do
+for ver in 5.0 5.0.1; do
 echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/$ver bionic main" \
     | sudo tee --append /etc/apt/sources.list.d/rocm.list
 done
@@ -106,7 +106,7 @@ sudo apt update
 
 ```shell
 # ROCm repositories for focal
-for ver in 5.1.3 5.2.3; do
+for ver in 5.0 5.0.1; do
 echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/$ver focal main" \
     | sudo tee --append /etc/apt/sources.list.d/rocm.list
 done
@@ -136,7 +136,7 @@ For a comprehensive list of meta-packages, refer to
 - Sample Multi-version installation
 
    ```shell
-   sudo apt install rocm-hip-sdk5.2.3 rocm-hip-sdk5.1.3
+   sudo apt install rocm-hip-sdk5.0.1
    ```
 
 :::::
@@ -160,7 +160,26 @@ section.
 sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/rhel/7.9/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/21.50.1/rhel/7.9/main/x86_64/
+enabled=1
+priority=50
+gpgcheck=1
+gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
+EOF
+sudo yum clean all
+```
+
+:::
+
+:::{tab-item} RHEL 8.4
+:sync: RHEL-8.4
+:sync: RHEL-8
+
+```shell
+sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
+[amdgpu]
+name=amdgpu
+baseurl=https://repo.radeon.com/amdgpu/21.50.1/rhel/8.4/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -179,7 +198,7 @@ sudo yum clean all
 sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/rhel/8.5/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/21.50.1/rhel/8.5/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -189,26 +208,6 @@ sudo yum clean all
 ```
 
 :::
-
-:::{tab-item} RHEL 8.6
-:sync: RHEL-8.6
-:sync: RHEL-8
-
-```shell
-sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
-[amdgpu]
-name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/rhel/8.6/main/x86_64/
-enabled=1
-priority=50
-gpgcheck=1
-gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
-EOF
-sudo yum clean all
-```
-
-:::
-
 ::::
 
 Install the kernel mode driver and reboot the system using the following
@@ -229,7 +228,7 @@ To add the ROCm repository, use the following steps, based on your distribution:
 :sync: RHEL-7
 
 ```shell
-for ver in 5.2.1 5.2.3; do
+for ver in 5.0 5.0.1; do
 sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -248,7 +247,7 @@ sudo yum clean all
 :sync: RHEL-8
 
 ```shell
-for ver in 5.1.3 5.2.3; do
+for ver in 5.0 5.0.1; do
 sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -283,7 +282,7 @@ For a comprehensive list of meta-packages, refer to
 - Sample Multi-version installation
 
    ```shell
-   sudo yum install rocm-hip-sdk5.2.3 rocm-hip-sdk5.1.3
+   sudo yum install rocm-hip-sdk5.0.1
    ```
 
 :::::
@@ -306,23 +305,7 @@ section.
 sudo tee /etc/zypp/repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/sle/15.3/main/x86_64
-enabled=1
-gpgcheck=1
-gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
-EOF
-sudo zypper ref
-```
-
-:::
-:::{tab-item} Service Pack 4
-:sync: SLES15-SP4
-
-```shell
-sudo tee /etc/zypp/repos.d/amdgpu.repo <<EOF
-[amdgpu]
-name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/sle/15.4/main/x86_64
+baseurl=https://repo.radeon.com/amdgpu/21.50.1/sle/15.3/main/x86_64
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
@@ -347,7 +330,7 @@ sudo reboot
 To add the ROCm repository, use the following steps:
 
 ```shell
-for ver in 5.1.3 5.2.3; do
+for ver in 5.0 5.0.1; do
 sudo tee --append /etc/zypp/repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -379,7 +362,7 @@ For a comprehensive list of meta-packages, refer to
 - Sample Multi-version installation
 
    ```shell
-   sudo zypper --gpg-auto-import-keys install rocm-hip-sdk5.2.3 rocm-hip-sdk5.1.3
+   sudo zypper --gpg-auto-import-keys install rocm-hip-sdk5.0.1
    ```
 
 :::::
@@ -416,7 +399,7 @@ but are generally useful. Verification of the install is advised.
 2. Add binary paths to the `PATH` environment variable.
 
    ```shell
-   export PATH=$PATH:/opt/rocm-5.2.3/bin:/opt/rocm-5.2.3/opencl/bin
+   export PATH=$PATH:/opt/rocm-5.0.1/bin:/opt/rocm-5.0.1/opencl/bin
    ```
 
    ```{attention}

docs/deploy/linux/os-native/upgrade.md

@@ -26,7 +26,7 @@ repository to the new release.
 
 ```shell
 # amdgpu repository for bionic
-echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/22.20.3/ubuntu bionic main' \
+echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/21.50.1/ubuntu bionic main' \
     | sudo tee /etc/apt/sources.list.d/amdgpu.list
 sudo apt update
 ```
@@ -37,12 +37,11 @@ sudo apt update
 
 ```shell
 # amdgpu repository for focal
-echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/22.20.3/ubuntu focal main' \
+echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/21.50.1/ubuntu focal main' \
     | sudo tee /etc/apt/sources.list.d/amdgpu.list
 sudo apt update
 ```
 
-:::
 ::::
 :::::
 :::::{tab-item} Red Hat Enterprise Linux
@@ -57,7 +56,25 @@ sudo apt update
 sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/rhel/7.9/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/21.50.1/rhel/7.9/main/x86_64/
+enabled=1
+priority=50
+gpgcheck=1
+gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
+EOF
+sudo yum clean all
+```
+
+:::
+:::{tab-item} RHEL 8.4
+:sync: RHEL-8.4
+:sync: RHEL-8
+
+```shell
+sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
+[amdgpu]
+name=amdgpu
+baseurl=https://repo.radeon.com/amdgpu/21.50.1/rhel/8.4/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -75,25 +92,7 @@ sudo yum clean all
 sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/rhel/8.5/main/x86_64/
-enabled=1
-priority=50
-gpgcheck=1
-gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
-EOF
-sudo yum clean all
-```
-
-:::
-:::{tab-item} RHEL 8.6
-:sync: RHEL-8.6
-:sync: RHEL-8
-
-```shell
-sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
-[amdgpu]
-name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/rhel/8.6/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/21.50.1/rhel/8.5/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -104,6 +103,7 @@ sudo yum clean all
 
 :::
 ::::
+
 :::::
 :::::{tab-item} SUSE Linux Enterprise Server 15
 :sync: SLES15
@@ -116,23 +116,7 @@ sudo yum clean all
 sudo tee /etc/zypp/repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/sle/15.3/main/x86_64
-enabled=1
-gpgcheck=1
-gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
-EOF
-sudo zypper ref
-```
-
-:::
-:::{tab-item} Service Pack 4
-:sync: SLES15-SP4
-
-```shell
-sudo tee /etc/zypp/repos.d/amdgpu.repo <<EOF
-[amdgpu]
-name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/22.20.3/sle/15.4/main/x86_64
+baseurl=https://repo.radeon.com/amdgpu/21.50.1/sle/15.3/main/x86_64
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
@@ -195,7 +179,7 @@ repository to the new release.
 :sync: ubuntu-18.04
 
 ```shell
-echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.2.3 bionic main" \
+echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.0.1 bionic main" \
     | sudo tee /etc/apt/sources.list.d/rocm.list
 echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \
     | sudo tee /etc/apt/preferences.d/rocm-pin-600
@@ -207,7 +191,7 @@ sudo apt update
 :sync: ubuntu-20.04
 
 ```shell
-echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.2.3 focal main" \
+echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.0.1 focal main" \
     | sudo tee /etc/apt/sources.list.d/rocm.list
 echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \
     | sudo tee /etc/apt/preferences.d/rocm-pin-600
@@ -226,9 +210,9 @@ sudo apt update
 
 ```shell
 sudo tee /etc/yum.repos.d/rocm.repo <<EOF
-[ROCm-5.2.3]
-name=ROCm5.2.3
-baseurl=https://repo.radeon.com/rocm/yum/5.2.3/main
+[ROCm-5.0.1]
+name=ROCm5.0.1
+baseurl=https://repo.radeon.com/rocm/yum/5.0.1/main
 enabled=1
 priority=50
 gpgcheck=1
@@ -243,9 +227,9 @@ sudo yum clean all
 
 ```shell
 sudo tee /etc/yum.repos.d/rocm.repo <<EOF
-[ROCm-5.2.3]
-name=ROCm5.2.3
-baseurl=https://repo.radeon.com/rocm/rhel8/5.2.3/main
+[ROCm-5.0.1]
+name=ROCm5.0.1
+baseurl=https://repo.radeon.com/rocm/rhel8/5.0.1/main
 enabled=1
 priority=50
 gpgcheck=1
@@ -262,10 +246,10 @@ sudo yum clean all
 
 ```shell
 sudo tee /etc/zypp/repos.d/rocm.repo <<EOF
-[ROCm-5.2.3]
-name=ROCm5.2.3
+[ROCm-5.0.1]
+name=ROCm5.0.1
 name=rocm
-baseurl=https://repo.radeon.com/rocm/zyp/5.2.3/main
+baseurl=https://repo.radeon.com/rocm/zyp/5.0.1/main
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key

docs/examples/all.md

@@ -18,7 +18,6 @@ Detailed walkthroughs of specific use-cases driven by frameworks using ROCm
 acceleration.
 
 - [Implementing Inception V3 on ROCm with PyTorch](machine_learning/pytorch_inception.md)
-- [Optimizing Inference with MIGraphX](machine_learning/migraphx_optimization.md)
 
 :::
 

docs/examples/machine_learning/all.md

@@ -10,11 +10,4 @@ A collection of detailed and guided examples for working with Inception V3 with
 
 :::
 
-:::{grid-item-card} Optimizing Inference with MIGraphX
-:link: migraphx_optimization
-:link-type: doc
-Walkthroughs of optimizing inference using MIGraphX.
-
-:::
-
 :::::

docs/how_to/magma_install/magma_install.md

@@ -83,10 +83,6 @@ TensorFlow, \[Online image\]. [https://www.tensorflow.org/extras/tensorflow_bran
 
 MAGMA, \[Online image\]. [https://bitbucket.org/icl/magma/src/master/docs/](https://bitbucket.org/icl/magma/src/master/docs/)
 
-Advanced Micro Devices, Inc., \[Online\]. Available: [https://rocmsoftwareplatform.github.io/AMDMIGraphX/doc/html/](https://rocmsoftwareplatform.github.io/AMDMIGraphX/doc/html/)
-
-Advanced Micro Devices, Inc., \[Online\]. Available: [https://github.com/ROCmSoftwarePlatform/AMDMIGraphX/wiki](https://github.com/ROCmSoftwarePlatform/AMDMIGraphX/wiki)
-
 Docker, \[Online\]. [https://docs.docker.com/get-started/overview/](https://docs.docker.com/get-started/overview/)
 
 Torchvision, \[Online\]. Available [https://pytorch.org/vision/master/index.html?highlight=torchvision#module-torchvision](https://pytorch.org/vision/master/index.html?highlight=torchvision#module-torchvision)

docs/how_to/pytorch_install/pytorch_install.md

@@ -425,10 +425,6 @@ TensorFlow, \[Online image\]. [https://www.tensorflow.org/extras/tensorflow_bran
 
 MAGMA, \[Online image\]. [https://bitbucket.org/icl/magma/src/master/docs/](https://bitbucket.org/icl/magma/src/master/docs/)
 
-Advanced Micro Devices, Inc., \[Online\]. Available: [https://rocmsoftwareplatform.github.io/AMDMIGraphX/doc/html/](https://rocmsoftwareplatform.github.io/AMDMIGraphX/doc/html/)
-
-Advanced Micro Devices, Inc., \[Online\]. Available: [https://github.com/ROCmSoftwarePlatform/AMDMIGraphX/wiki](https://github.com/ROCmSoftwarePlatform/AMDMIGraphX/wiki)
-
 Docker, \[Online\]. [https://docs.docker.com/get-started/overview/](https://docs.docker.com/get-started/overview/)
 
 Torchvision, \[Online\]. Available [https://pytorch.org/vision/master/index.html?highlight=torchvision#module-torchvision](https://pytorch.org/vision/master/index.html?highlight=torchvision#module-torchvision)

docs/how_to/tensorflow_install/tensorflow_install.md

@@ -197,10 +197,6 @@ TensorFlow, \[Online image\]. [https://www.tensorflow.org/extras/tensorflow_bran
 
 MAGMA, \[Online image\]. [https://bitbucket.org/icl/magma/src/master/docs/](https://bitbucket.org/icl/magma/src/master/docs/)
 
-Advanced Micro Devices, Inc., \[Online\]. Available: [https://rocmsoftwareplatform.github.io/AMDMIGraphX/doc/html/](https://rocmsoftwareplatform.github.io/AMDMIGraphX/doc/html/)
-
-Advanced Micro Devices, Inc., \[Online\]. Available: [https://github.com/ROCmSoftwarePlatform/AMDMIGraphX/wiki](https://github.com/ROCmSoftwarePlatform/AMDMIGraphX/wiki)
-
 Docker, \[Online\]. [https://docs.docker.com/get-started/overview/](https://docs.docker.com/get-started/overview/)
 
 Torchvision, \[Online\]. Available [https://pytorch.org/vision/master/index.html?highlight=torchvision#module-torchvision](https://pytorch.org/vision/master/index.html?highlight=torchvision#module-torchvision)

docs/index.md

@@ -93,7 +93,6 @@ agile, flexible, rapid and secure manner. [more...](rocm)
 - [Examples](https://github.com/amd/rocm-examples)
 - [ML, DL, and AI](examples/machine_learning/all)
   - [](examples/machine_learning/pytorch_inception)
-  - [](examples/machine_learning/migraphx_optimization)
 
 :::
 ::::

docs/reference/ai_tools.md

@@ -10,17 +10,10 @@ AMD's library for high performance machine learning primitives.
 
 :::
 
-:::{grid-item-card} {doc}`Composable Kernel <composable-kernel:index>`
+:::{grid-item-card} {doc}`Composable Kernel <composable_kernel:index>`
 Composable Kernel: Performance Portable Programming Model for Machine Learning Tensor Operators
 
-- {doc}`Documentation <composable-kernel:index>`
-
-:::
-
-:::{grid-item-card} {doc}`MIGraphX <migraphx:index>`
-AMD MIGraphX is AMD's graph inference engine that accelerates machine learning model inference.
-
-- {doc}`Documentation <migraphx:index>`
+- {doc}`Documentation <composable_kernel:index>`
 
 :::
 

docs/reference/all.md

@@ -42,8 +42,7 @@ Inter and intra-node communication is supported by the following projects:
 Libraries related to AI.
 
 - {doc}`MIOpen <miopen:index>`
-- {doc}`Composable Kernel <composable-kernel:index>`
-- {doc}`MIGraphX <migraphx:index>`
+- {doc}`Composable Kernel <composable_kernel:index>`
 
 :::
 
@@ -80,7 +79,7 @@ Computer vision related projects.
 
 :::{grid-item-card} [Validation Tools](validation_tools)
 
-- {doc}`ROCm Validation Suite <rocm-validation-suite:index>`
+- {doc}`ROCm Validation Suite <rocmvalidationsuite:index>`
 - {doc}`TransferBench <transferbench:index>`
 
 :::

docs/reference/validation_tools.md

@@ -3,10 +3,10 @@
 :::::{grid} 1 1 2 2
 :gutter: 1
 
-:::{grid-item-card} {doc}`RVS <rocm-validation-suite:index>`
+:::{grid-item-card} {doc}`RVS <rocmvalidationsuite:index>`
 The ROCm Validation Suite is a system administrator’s and cluster manager's tool for detecting and troubleshooting common problems affecting AMD GPU(s) running in a high-performance computing environment, enabled using the ROCm software stack on a compatible platform.
 
-- {doc}`Documentation <rocm-validation-suite:index>`
+- {doc}`Documentation <rocmvalidationsuite:index>`
 
 :::
 

docs/release/gpu_os_support.md

@@ -8,13 +8,12 @@ AMD ROCm™ Platform supports the following Linux distributions.
 
 | Distribution       |Processor Architectures| Validated Kernel   |
 |--------------------|-----------------------|--------------------|
+| CentOS 8.3         | x86-64                | 4.18               |
 | CentOS 7.9         | x86-64                | 3.10               |
-| RHEL 8.6 to 8.5    | x86-64                | 4.18               |
+| RHEL 8.5, 8.4      | x86-64                | 4.18               |
 | RHEL 7.9           | x86-64                | 3.10               |
-| SLES 15 SP4        | x86-64                | 5.14.21            |
 | SLES 15 SP3        | x86-64                | 5.3.18             |
-| Ubuntu 20.04.4 LTS | x86-64                | 5.13               |
-| Ubuntu 20.04.3 LTS | x86-64                | 5.11               |
+| Ubuntu 20.04.3 LTS | x86-64                | 5.8                |
 | Ubuntu 18.04.5 LTS | x86-64                | 5.4.0              |
 
 ## Virtualization Support

docs/release/licensing.md

@@ -58,7 +58,6 @@ The table is ordered to follow ROCm's manifest file.
 | [rocPRIM](https://github.com/ROCmSoftwarePlatform/rocPRIM/)                                      | [MIT](https://github.com/ROCmSoftwarePlatform/rocPRIM/blob/develop/LICENSE.txt)                                            |
 | [rocWMMA](https://github.com/ROCmSoftwarePlatform/rocWMMA/)                                      | [MIT](https://github.com/ROCmSoftwarePlatform/rocWMMA/blob/develop/LICENSE.md)                                             |
 | [hipfort](https://github.com/ROCmSoftwarePlatform/hipfort/)                                      | [MIT](https://github.com/ROCmSoftwarePlatform/hipfort/blob/master/LICENSE)                                                 |
-| [AMDMIGraphX](https://github.com/ROCmSoftwarePlatform/AMDMIGraphX/)                              | [MIT](https://github.com/ROCmSoftwarePlatform/AMDMIGraphX/blob/develop/LICENSE)                                            |
 | [ROCmValidationSuite](https://github.com/ROCm-Developer-Tools/ROCmValidationSuite/)              | [MIT](https://github.com/ROCm-Developer-Tools/ROCmValidationSuite/blob/master/LICENSE)                                     |
 | [aomp](https://github.com/ROCm-Developer-Tools/aomp/)                                            | [Apache 2.0](https://github.com/ROCm-Developer-Tools/aomp/blob/aomp-dev/LICENSE)                                           |
 | [aomp-extras](https://github.com/ROCm-Developer-Tools/aomp-extras/)                              | [MIT](https://github.com/ROCm-Developer-Tools/aomp-extras/blob/aomp-dev/LICENSE)                                           |
@@ -121,4 +120,4 @@ following location: `/opt/rocm/share/doc/<component-name>/`
 For example, you can fetch the licensing information of the `_amd_comgr_`
 component (Code Object Manager) from the `amd_comgr` folder. A file named
 `LICENSE.txt` contains the license details at:
-`/opt/rocm-5.2.3/share/doc/amd_comgr/LICENSE.txt`
+`/opt/rocm-5.0.1/share/doc/amd_comgr/LICENSE.txt`

docs/sphinx/_toc.yml.in

@@ -146,9 +146,7 @@ subtrees:
           - title: MIOpen - Machine Intelligence
             url: ${project:miopen}
           - title: Composable Kernel
-            url: ${project:composable-kernel}
-          - title: MIGraphX - Graph Optimization
-            url: ${project:migraphx}
+            url: ${project:composable_kernel}
     - file: reference/computer_vision
       subtrees:
         - entries:
@@ -171,7 +169,7 @@ subtrees:
       title: Validation Tools
       subtrees:
         - entries:
-          - url: ${project:rocm-validation-suite}
+          - url: ${project:rocmvalidationsuite}
             title: RVS
           - url: ${project:transferbench}
             title: TransferBench
@@ -223,7 +221,6 @@ subtrees:
       subtrees:
         - entries: 
           - file: examples/machine_learning/pytorch_inception
-          - file: examples/machine_learning/migraphx_optimization
 
 - caption: About 
   entries:

docs/sphinx/requirements.in

@@ -1 +1,2 @@
-rocm-docs-core==0.16.0
+rocm-docs-core==1.8.0
+sphinx-reredirects

docs/sphinx/requirements.txt

@@ -1,114 +1,106 @@
 #
-# This file is autogenerated by pip-compile with Python 3.11
+# This file is autogenerated by pip-compile with Python 3.10
 # by the following command:
 #
-#    pip-compile docs/sphinx/requirements.in
+#    pip-compile requirements.in
 #
-accessible-pygments==0.0.3
+accessible-pygments==0.0.5
     # via pydata-sphinx-theme
-alabaster==0.7.13
+alabaster==1.0.0
     # via sphinx
-babel==2.11.0
+babel==2.16.0
     # via
     #   pydata-sphinx-theme
     #   sphinx
-beautifulsoup4==4.11.2
+beautifulsoup4==4.12.3
     # via pydata-sphinx-theme
-breathe==4.34.0
+breathe==4.35.0
     # via rocm-docs-core
-certifi==2022.12.7
+certifi==2024.8.30
     # via requests
-cffi==1.15.1
+cffi==1.17.1
     # via
     #   cryptography
     #   pynacl
-charset-normalizer==2.1.1
+charset-normalizer==3.3.2
     # via requests
-click==8.1.3
+click==8.1.7
     # via sphinx-external-toc
-colorama==0.4.6
-    # via
-    #   click
-    #   sphinx
-cryptography==40.0.2
+cryptography==43.0.1
     # via pyjwt
-deprecated==1.2.13
+deprecated==1.2.14
     # via pygithub
-docutils==0.19
+docutils==0.21.2
     # via
     #   breathe
     #   myst-parser
     #   pydata-sphinx-theme
     #   sphinx
-fastjsonschema==2.16.3
+fastjsonschema==2.20.0
     # via rocm-docs-core
-gitdb==4.0.10
+gitdb==4.0.11
     # via gitpython
-gitpython==3.1.30
+gitpython==3.1.43
     # via rocm-docs-core
-idna==3.4
+idna==3.10
     # via requests
 imagesize==1.4.1
     # via sphinx
-jinja2==3.1.2
+jinja2==3.1.4
     # via
     #   myst-parser
     #   sphinx
-linkify-it-py==1.0.3
-    # via myst-parser
-markdown-it-py==2.2.0
+markdown-it-py==3.0.0
     # via
     #   mdit-py-plugins
     #   myst-parser
-markupsafe==2.1.2
+markupsafe==2.1.5
     # via jinja2
-mdit-py-plugins==0.3.4
+mdit-py-plugins==0.4.2
     # via myst-parser
 mdurl==0.1.2
     # via markdown-it-py
-myst-parser[linkify]==1.0.0
+myst-parser==4.0.0
     # via rocm-docs-core
-packaging==23.0
+packaging==24.1
     # via
     #   pydata-sphinx-theme
     #   sphinx
-pycparser==2.21
+pycparser==2.22
     # via cffi
-pydata-sphinx-theme==0.13.3
+pydata-sphinx-theme==0.15.4
     # via
     #   rocm-docs-core
     #   sphinx-book-theme
-pygithub==1.58.1
+pygithub==2.4.0
     # via rocm-docs-core
-pygments==2.14.0
+pygments==2.18.0
     # via
     #   accessible-pygments
     #   pydata-sphinx-theme
     #   sphinx
-pyjwt[crypto]==2.6.0
+pyjwt[crypto]==2.9.0
     # via pygithub
 pynacl==1.5.0
     # via pygithub
-pytz==2022.7.1
-    # via babel
-pyyaml==6.0
+pyyaml==6.0.2
     # via
     #   myst-parser
     #   rocm-docs-core
     #   sphinx-external-toc
-requests==2.28.1
+requests==2.32.3
     # via
     #   pygithub
     #   sphinx
-rocm-docs-core==0.16.0
-    # via -r docs/sphinx/requirements.in
-smmap==5.0.0
+rocm-docs-core==1.8.0
+    # via -r requirements.in
+smmap==5.0.1
     # via gitdb
 snowballstemmer==2.2.0
     # via sphinx
-soupsieve==2.4
+soupsieve==2.6
     # via beautifulsoup4
-sphinx==5.3.0
+sphinx==8.0.2
     # via
     #   breathe
     #   myst-parser
@@ -119,33 +111,40 @@ sphinx==5.3.0
     #   sphinx-design
     #   sphinx-external-toc
     #   sphinx-notfound-page
-sphinx-book-theme==1.0.1
+    #   sphinx-reredirects
+sphinx-book-theme==1.1.3
     # via rocm-docs-core
-sphinx-copybutton==0.5.1
+sphinx-copybutton==0.5.2
     # via rocm-docs-core
-sphinx-design==0.4.1
+sphinx-design==0.6.1
     # via rocm-docs-core
-sphinx-external-toc==0.3.1
+sphinx-external-toc==1.0.1
     # via rocm-docs-core
-sphinx-notfound-page==0.8.3
+sphinx-notfound-page==1.0.4
     # via rocm-docs-core
-sphinxcontrib-applehelp==1.0.4
+sphinx-reredirects==0.1.5
+    # via -r requirements.in
+sphinxcontrib-applehelp==2.0.0
     # via sphinx
-sphinxcontrib-devhelp==1.0.2
+sphinxcontrib-devhelp==2.0.0
     # via sphinx
-sphinxcontrib-htmlhelp==2.0.1
+sphinxcontrib-htmlhelp==2.1.0
     # via sphinx
 sphinxcontrib-jsmath==1.0.1
     # via sphinx
-sphinxcontrib-qthelp==1.0.3
+sphinxcontrib-qthelp==2.0.0
     # via sphinx
-sphinxcontrib-serializinghtml==1.1.5
+sphinxcontrib-serializinghtml==2.0.0
     # via sphinx
-typing-extensions==4.5.0
-    # via pydata-sphinx-theme
-uc-micro-py==1.0.1
-    # via linkify-it-py
-urllib3==1.26.13
-    # via requests
-wrapt==1.14.1
+tomli==2.0.1
+    # via sphinx
+typing-extensions==4.12.2
+    # via
+    #   pydata-sphinx-theme
+    #   pygithub
+urllib3==2.2.3
+    # via
+    #   pygithub
+    #   requests
+wrapt==1.16.0
     # via deprecated

docs/understand/cmake_packages.rst

@@ -224,10 +224,6 @@ ROCm CMake Packages
 +-----------+----------+--------------------------------------------------------+
 | MIOpen    | miopen   | ``MIOpen``                                             |
 +-----------+----------+--------------------------------------------------------+
-| MIGraphX  | migraphx | ``migraphx::migraphx``, ``migraphx::migraphx_c``,      |
-|           |          | ``migraphx::migraphx_cpu``, ``migraphx::migraphx_gpu``,|
-|           |          | ``migraphx::migraphx_onnx``, ``migraphx::migraphx_tf`` |
-+-----------+----------+--------------------------------------------------------+
 
 Using CMake Presets
 ===================