Update documentation requirements

Fix RTD config
2026-01-10 15:18:11 -05:00 · 2024-09-16 10:12:48 -08:00 · 2024-06-06 16:58:41 -06:00 · 2024-05-02 08:55:18 -06:00 · 2024-05-01 16:59:31 -06:00 · 2024-05-01 16:54:02 -06:00
12 changed files with 1240 additions and 136 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -15,97 +15,130 @@ The release notes for the ROCm platform.

 -------------------

-## ROCm 5.4.0
+## ROCm 5.5.0
 <!-- markdownlint-disable first-line-h1 -->
 <!-- markdownlint-disable no-duplicate-header -->
 ### What's New in This Release

 #### HIP Enhancements

-The ROCm v5.4 release consists of the following HIP enhancements:
+The ROCm v5.5 release consists of the following HIP enhancements:

-##### Support for Wall Clock64
+##### Enhanced Stack Size Limit

-A new timer function wall_clock64() is supported, which returns wall clock count at a constant frequency on the device.
+In this release, the stack size limit is increased from 16k to 131056 bytes (or 128K - 16).
+Applications requiring to update the stack size can use hipDeviceSetLimit API.

-```h
-long long int wall_clock64();
-```
+##### `hipcc` Changes

-It returns wall clock count at a constant frequency on the device, which can be queried via HIP API with the hipDeviceAttributeWallClockRate attribute of the device in the HIP application code.
+The following hipcc changes are implemented in this release:

-Example:
+- `hipcc` will not implicitly link to `libpthread` and `librt`, as they are no longer a link time dependence for HIP programs.  Applications that depend on these libraries must explicitly link to them.
+- `-use-staticlib` and `-use-sharedlib` options are deprecated.

-```h
-int wallClkRate = 0; //in kilohertz
-+HIPCHECK(hipDeviceGetAttribute(&wallClkRate, hipDeviceAttributeWallClockRate, deviceId));
-```
+##### Future Changes

-Where hipDeviceAttributeWallClockRate is a device attribute.
+- Separation of `hipcc` binaries (Perl scripts) from HIP to `hipcc` project. Users will access separate `hipcc` package for installing `hipcc` binaries in future ROCm releases.
+- In a future ROCm release, the following samples will be removed from the `hip-tests` project.
+  - `hipBusbandWidth` at <https://github.com/ROCm-Developer-Tools/hip-tests/tree/develop/samples/1_Utils/shipBusBandwidth>
+  - `hipCommander` at <https://github.com/ROCm-Developer-Tools/hip-tests/tree/develop/samples/1_Utils/hipCommander>
+
+  Note that the samples will continue to be available in previous release branches.
+
+##### New HIP APIs in This Release

 > **Note**
 >
-> The wall clock frequency is a per-device attribute.
+> This is a pre-official version (beta) release of the new APIs and may contain unresolved issues.

-##### New Registry Added for GPU_MAX_HW_QUEUES
+###### Memory Management HIP APIs

-The GPU_MAX_HW_QUEUES registry defines the maximum number of independent hardware queues allocated per process per device.
+The new memory management HIP API is as follows:

-The environment variable controls how many independent hardware queues HIP runtime can create per process, per device. If the application allocates more HIP streams than this number, then the HIP runtime reuses the same hardware queues for the new streams in a round-robin manner.
+- Sets information on the specified pointer [BETA].

-> **Note**
->
-> This maximum number does not apply to hardware queues created for CU-masked HIP streams or cooperative queues for HIP Cooperative Groups (there is only one queue per device).
+  ```h
+  hipError_t hipPointerSetAttribute(const void* value, hipPointer_attribute attribute, hipDeviceptr_t ptr);
+  ```

-For more details, refer to the HIP Programming Guide.
+###### Module Management HIP APIs

-#### New HIP APIs in This Release
+The new module management HIP APIs are as follows:

-The following new HIP APIs are available in the ROCm v5.4 release.
+- Launches kernel $f$ with launch parameters and shared memory on stream with arguments passed to `kernelParams`, where thread blocks can cooperate and synchronize as they execute.

-> **Note**
->
-> This is a pre-official version (beta) release of the new APIs.
+  ```h
+  hipError_t hipModuleLaunchCooperativeKernel(hipFunction_t f, unsigned int gridDimX, unsigned int gridDimY, unsigned int gridDimZ, unsigned int blockDimX, unsigned int blockDimY, unsigned int blockDimZ, unsigned int sharedMemBytes, hipStream_t stream, void** kernelParams);
+  ```

-##### Error Handling
+- Launches kernels on multiple devices where thread blocks can cooperate and synchronize as they execute.

-```h
-hipError_t hipDrvGetErrorName(hipError_t hipError, const char** errorString);
-```
+  ```h
+  hipError_t hipModuleLaunchCooperativeKernelMultiDevice(hipFunctionLaunchParams* launchParamsList, unsigned int numDevices, unsigned int flags);
+  ```

-This returns HIP errors in the text string format.
+###### HIP Graph Management APIs

-```h
-hipError_t hipDrvGetErrorString(hipError_t hipError, const char** errorString);
-```
+The new HIP Graph Management APIs are as follows:

-This returns text string messages with more details about the error.
+- Creates a memory allocation node and adds it to a graph [BETA]

-For more information, refer to the HIP API Guide.
+  ```h
+  hipError_t hipGraphAddMemAllocNode(hipGraphNode_t* pGraphNode, hipGraph_t graph, const hipGraphNode_t* pDependencies, size_t numDependencies, hipMemAllocNodeParams* pNodeParams);
+  ```

-##### HIP Tests Source Separation
+- Return parameters for memory allocation node [BETA]

-With ROCm v5.4, a separate GitHub project is created at
+  ```h
+  hipError_t hipGraphMemAllocNodeGetParams(hipGraphNode_t node, hipMemAllocNodeParams* pNodeParams);
+  ```

-<https://github.com/ROCm-Developer-Tools/hip-tests>
+- Creates a memory free node and adds it to a graph [BETA]

-This contains HIP catch2 tests and samples, and new tests will continue to develop.
+  ```h
+  hipError_t hipGraphAddMemFreeNode(hipGraphNode_t* pGraphNode, hipGraph_t graph, const hipGraphNode_t* pDependencies, size_t numDependencies, void* dev_ptr);
+  ```

-In future ROCm releases, catch2 tests and samples will be removed from the HIP project.
+- Returns parameters for memory free node [BETA].

-### OpenMP Enhancements
+  ```h
+  hipError_t hipGraphMemFreeNodeGetParams(hipGraphNode_t node, void* dev_ptr);
+  ```

+- Write a DOT file describing graph structure [BETA].
+
+  ```h
+  hipError_t hipGraphDebugDotPrint(hipGraph_t graph, const char* path, unsigned int flags);
+  ```
+
+- Copies attributes from source node to destination node [BETA].
+
+  ```h
+  hipError_t hipGraphKernelNodeCopyAttributes(hipGraphNode_t hSrc, hipGraphNode_t hDst);
+  ```
+
+- Enables or disables the specified node in the given graphExec [BETA]
+
+  ```h
+  hipError_t hipGraphNodeSetEnabled(hipGraphExec_t hGraphExec, hipGraphNode_t hNode, unsigned int isEnabled);
+  ```
+
+- Query whether a node in the given graphExec is enabled [BETA]
+
+  ```h
+  hipError_t hipGraphNodeGetEnabled(hipGraphExec_t hGraphExec, hipGraphNode_t hNode, unsigned int* isEnabled);
+  ```
+
+##### OpenMP Enhancements
 This release consists of the following OpenMP enhancements:

- Enable new device RTL in libomptarget as default.
- New flag `-fopenmp-target-fast` to imply `-fopenmp-target-ignore-env-vars -fopenmp-assume-no-thread-state -fopenmp-assume-no-nested-parallelism`.
- Support for the collapse clause and non-unit stride in cases where the No-Loop specialized kernel is generated.
- Initial implementation of optimized cross-team sum reduction for float and double type scalars.
- Pool-based optimization in the OpenMP runtime to reduce locking during data transfer.
+- Additional support for OMPT functions `get_device_time` and `get_record_type`.
+- Add support for min/max fast fp atomics on AMD GPUs.
+- Fix the use of the abs function in C device regions.

 ### Deprecations and Warnings

-#### HIP Perl Scripts Deprecation
+#### HIP Deprecation

 The `hipcc` and `hipconfig` Perl scripts are deprecated. In a future release, compiled binaries will be available as `hipcc.bin` and `hipconfig.bin` as replacements for the Perl scripts.

@@ -113,15 +146,13 @@ The `hipcc` and `hipconfig` Perl scripts are deprecated. In a future release, co
 >
 > There will be a transition period where the Perl scripts and compiled binaries are available  before the scripts are removed. There will be no functional difference between the Perl scripts and their compiled binary counterpart. No user action is required. Once these are available, users can optionally switch to `hipcc.bin` and `hipconfig.bin`. The `hipcc`/`hipconfig` soft link will be assimilated to point from `hipcc`/`hipconfig` to the respective compiled binaries as the default option.

-(5_4_0_filesystem_reorg_deprecation_notice)=
-
 ##### Linux Filesystem Hierarchy Standard for ROCm

 ROCm packages have adopted the Linux foundation filesystem hierarchy standard in this release to ensure ROCm components follow open source conventions for Linux-based distributions. While moving to a new filesystem hierarchy, ROCm ensures backward compatibility with its 5.1 version or older filesystem hierarchy. See below for a detailed explanation of the new filesystem hierarchy and backward compatibility.

 ##### New Filesystem Hierarchy

-The following is the new filesystem hierarchy:
+The following is the new filesystem hierarchy:4

 ```text
 /opt/rocm-<ver>
@@ -199,7 +230,8 @@ lrwxrwxrwx 1 root root   24 May 10 23:32 libamdhip64.so -> ../../lib/libamdhip64

 ##### CMake Config files

-All CMake configuration files are available in the `/opt/rocm-xxx/lib/cmake/<component>` folder. For backward compatibility, the old CMake locations (`/opt/rocm-xxx/<component>/lib/cmake`) consist of a soft link to the new CMake config.
+All CMake configuration files are available in the `/opt/rocm-xxx/lib/cmake/<component>` folder.
+For backward compatibility, the old CMake locations (`/opt/rocm-xxx/<component>/lib/cmake`) consist of a soft link to the new CMake config.

 Example:

@@ -209,37 +241,64 @@ total 0
 lrwxrwxrwx 1 root root 42 May 10 23:32 hip-config.cmake -> ../../../../lib/cmake/hip/hip-config.cmake
 ```

-### Fixed Defects
+#### ROCm Support For Code Object V3 Deprecated

-The following defects are fixed in this release.
+Support for Code Object v3 is deprecated and will be removed in a future release.

-These defects were identified and documented as known issues in previous ROCm releases and are fixed in this release.
+#### Comgr V3.0 Changes

-#### Memory Allocated Using hipHostMalloc() with Flags Did Not Exhibit Fine-Grain Behavior
+The following APIs and macros have been marked as deprecated. These are expected to be removed in a future ROCm release and coincides with the release of Comgr v3.0.

-##### Issue
+##### API Changes

-The test was incorrectly using the `hipDeviceAttributePageableMemoryAccess` device attribute to determine coherent support.
+- `amd_comgr_action_info_set_options()`
+- `amd_comgr_action_info_get_options()`

-##### Fix
+##### Actions and Data Types

-`hipHostMalloc()` allocates memory with fine-grained access by default when the environment variable `HIP_HOST_COHERENT=1` is used.
+- `AMD_COMGR_ACTION_ADD_DEVICE_LIBRARIES`
+- `AMD_COMGR_ACTION_COMPILE_SOURCE_TO_FATBIN`

-For more information, refer to {doc}`hip:.doxygen/docBin/html/index`.
+For replacements, see the `AMD_COMGR_ACTION_INFO_GET`/`SET_OPTION_LIST APIs`, and the `AMD_COMGR_ACTION_COMPILE_SOURCE_(WITH_DEVICE_LIBS)_TO_BC` macros.

+#### Deprecated Environment Variables

-#### SoftHang with `hipStreamWithCUMask` test on AMD Instinct™
+The following environment variables are removed in this ROCm release:

-##### Issue
+- `GPU_MAX_COMMAND_QUEUES`
+- `GPU_MAX_WORKGROUP_SIZE_2D_X`
+- `GPU_MAX_WORKGROUP_SIZE_2D_Y`
+- `GPU_MAX_WORKGROUP_SIZE_3D_X`
+- `GPU_MAX_WORKGROUP_SIZE_3D_Y`
+- `GPU_MAX_WORKGROUP_SIZE_3D_Z`
+- `GPU_BLIT_ENGINE_TYPE`
+- `GPU_USE_SYNC_OBJECTS`
+- `AMD_OCL_SC_LIB`
+- `AMD_OCL_ENABLE_MESSAGE_BOX`
+- `GPU_FORCE_64BIT_PTR`
+- `GPU_FORCE_OCL20_32BIT`
+- `GPU_RAW_TIMESTAMP`
+- `GPU_SELECT_COMPUTE_RINGS_ID`
+- `GPU_USE_SINGLE_SCRATCH`
+- `GPU_ENABLE_LARGE_ALLOCATION`
+- `HSA_LOCAL_MEMORY_ENABLE`
+- `HSA_ENABLE_COARSE_GRAIN_SVM`
+- `GPU_IFH_MODE`
+- `OCL_SYSMEM_REQUIREMENT`
+- `OCL_CODE_CACHE_ENABLE`
+- `OCL_CODE_CACHE_RESET`

-On GFX10 GPUs, kernel execution hangs when it is launched on streams created using `hipStreamWithCUMask`.
+### Known Issues In This Release

-##### Fix
+The following are the known issues in this release.

-On GFX10 GPUs, each workgroup processor encompasses two compute units, and the compute units must be enabled as a pair. The `hipStreamWithCUMask` API unit test cases are updated to set compute unit mask (cuMask) in pairs for GFX10 GPUs.
+#### `DISTRIBUTED`/`TEST_DISTRIBUTED_SPAWN` Fails

-#### ROCm Tools GPU IDs
+When user applications call `ncclCommAbort` to destruct communicators and then create new
+communicators repeatedly, subsequent communicators may fail to initialize.

-The HIP language device IDs are not the same as the GPU IDs reported by the tools. GPU IDs are globally unique and guaranteed to be consistent across APIs and processes.
+This issue is under investigation and will be resolved in a future release.

-GPU IDs reported by ROCTracer and ROCProfiler or ROCm Tools are HSA Driver Node ID of that GPU, as it is a unique ID for that device in that particular node.
+#### Failures In HIP Directed Tests
+
+Multiple HIP directed tests fail.
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -18,8 +18,8 @@ shutil.copy2('../CHANGELOG.md','./CHANGELOG.md')
 project = "ROCm Documentation"
 author = "Advanced Micro Devices, Inc."
 copyright = "Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved."
-version = "5.4.0"
-release = "5.4.0"
+version = "5.5.0"
+release = "5.5.0"

 setting_all_article_info = True
 all_article_info_os = ["linux"]
@@ -27,6 +27,12 @@ all_article_info_author = ""

 # pages with specific settings
 article_pages = [
+    {
+        "file":"release",
+        "os":["linux"],
+        "date":"2023-05-01"
+    },
+
    {"file":"deploy/linux/index", "os":["linux"]},
    {"file":"deploy/linux/install_overview", "os":["linux"]},
    {"file":"deploy/linux/prerequisites", "os":["linux"]},
@@ -64,7 +70,7 @@ article_pages = [

 external_toc_path = "./sphinx/_toc.yml"

-docs_core = ROCmDocs("ROCm 5.4.0 Documentation Home")
+docs_core = ROCmDocs("ROCm 5.5.0 Documentation Home")
 docs_core.setup()

 external_projects_current_project = "rocm"
--- a/docs/deploy/linux/installer/install.md
+++ b/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/5.4/ubuntu/focal/amdgpu-install_5.4.50400-1_all.deb
-sudo apt install ./amdgpu-install_5.4.50400-1_all.deb
+wget https://repo.radeon.com/amdgpu-install/5.5/ubuntu/focal/amdgpu-install_5.5.50500-1_all.deb
+sudo apt install ./amdgpu-install_5.5.50500-1_all.deb
 ```

 :::
@@ -28,8 +28,8 @@ sudo apt install ./amdgpu-install_5.4.50400-1_all.deb

 ```shell
 sudo apt update
-wget https://repo.radeon.com/amdgpu-install/5.4/ubuntu/jammy/amdgpu-install_5.4.50400-1_all.deb
-sudo apt install ./amdgpu-install_5.4.50400-1_all.deb
+wget https://repo.radeon.com/amdgpu-install/5.5/ubuntu/jammy/amdgpu-install_5.5.50500-1_all.deb
+sudo apt install ./amdgpu-install_5.5.50500-1_all.deb
 ```

 :::
@@ -44,7 +44,7 @@ sudo apt install ./amdgpu-install_5.4.50400-1_all.deb
 :sync: RHEL-8

 ```shell
-sudo yum install https://repo.radeon.com/amdgpu-install/5.4/rhel/8.6/amdgpu-install-5.4.50400-1.el8.noarch.rpm
+sudo yum install https://repo.radeon.com/amdgpu-install/5.5/rhel/8.6/amdgpu-install-5.5.50500-1.el8.noarch.rpm
 ```

 :::
@@ -53,7 +53,7 @@ sudo yum install https://repo.radeon.com/amdgpu-install/5.4/rhel/8.6/amdgpu-inst
 :sync: RHEL-8

 ```shell
-sudo yum install https://repo.radeon.com/amdgpu-install/5.4/rhel/8.7/amdgpu-install-5.4.50400-1.el8.noarch.rpm
+sudo yum install https://repo.radeon.com/amdgpu-install/5.5/rhel/8.7/amdgpu-install-5.5.50500-1.el8.noarch.rpm
 ```

 :::
@@ -62,7 +62,7 @@ sudo yum install https://repo.radeon.com/amdgpu-install/5.4/rhel/8.7/amdgpu-inst
 :sync: RHEL-9

 ```shell
-sudo yum install https://repo.radeon.com/amdgpu-install/5.4/rhel/9.1/amdgpu-install-5.4.50400-1.el9.noarch.rpm
+sudo yum install https://repo.radeon.com/amdgpu-install/5.5/rhel/9.1/amdgpu-install-5.5.50500-1.el9.noarch.rpm
 ```

 :::
@@ -76,7 +76,7 @@ sudo yum install https://repo.radeon.com/amdgpu-install/5.4/rhel/9.1/amdgpu-inst
 :sync: SLES15-SP4

 ```shell
-sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/5.4/sle/15.4/amdgpu-install-5.4.50400-1.noarch.rpm
+sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/5.5/sle/15.4/amdgpu-install-5.5.50500-1.noarch.rpm
 ```

 :::
@@ -155,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.3.3 and 5.4
+**Example:** If you want to install ROCm releases 5.3.3 and 5.5
 simultaneously, you are required to download the installer from the latest ROCm
-release v5.4.
+release v5.5.

 ### Add Required Repositories

@@ -176,7 +176,7 @@ Run the following commands based on your distribution to add the repositories:
 :sync: ubuntu-20.04

 ```shell
-for ver in 5.3.3 5.4; do
+for ver in 5.3.3 5.4.3; 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
@@ -188,7 +188,7 @@ sudo apt update
 :sync: ubuntu-22.04

 ```shell
-for ver in 5.3.3; do
+for ver in 5.3.3 5.4.3; do
 echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/rocm-keyring.gpg] https://repo.radeon.com/rocm/apt/$ver jammy 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
@@ -206,7 +206,7 @@ sudo apt update
 :sync: RHEL-8

 ```shell
-for ver in 5.3.3; do
+for ver in 5.3.3 5.4.3; do
 sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -225,7 +225,7 @@ sudo yum clean all
 :sync: RHEL-9

 ```shell
-for ver in 5.3.3; do
+for ver in 5.3.3 5.4.3; do
 sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -246,7 +246,7 @@ sudo yum clean all
 :sync: SLES15

 ```shell
-for ver in 5.3.3; do
+for ver in 5.3.3 5.4.3; 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
@@ -272,12 +272,12 @@ sudo amdgpu-install --usecase=rocm --rocmrelease=<release-number-3>
 ```

 Following are examples of ROCm multi-version installation. The kernel-mode
-driver, associated with the ROCm release v5.4, will be installed as its latest
+driver, associated with the ROCm release v5.5, will be installed as its latest
 release in the list.

 ```none
 sudo amdgpu-install --usecase=rocm --rocmrelease=5.3.3
-sudo amdgpu-install --usecase=rocm --rocmrelease=5.4.0
+sudo amdgpu-install --usecase=rocm --rocmrelease=5.5
 ```

 ## Additional options
--- a/docs/deploy/linux/os-native/install.md
+++ b/docs/deploy/linux/os-native/install.md
@@ -53,7 +53,7 @@ To add the AMDGPU repository, follow these steps:

 ```shell
 # amdgpu repository for focal
-echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.4/ubuntu focal main' \
+echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.5/ubuntu focal main' \
    | sudo tee /etc/apt/sources.list.d/amdgpu.list
 sudo apt update
 ```
@@ -64,7 +64,7 @@ sudo apt update

 ```shell
 # amdgpu repository for jammy
-echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.4/ubuntu jammy main' \
+echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.5/ubuntu jammy 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 focal
-for ver in 5.3.3 5.4; do
+for ver in 5.3.3 5.4.3 5.5; 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
@@ -106,7 +106,7 @@ sudo apt update

 ```shell
 # ROCm repositories for jammy
-for ver in 5.3.3 5.4; do
+for ver in 5.3.3 5.4.3 5.5; do
 echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/$ver jammy 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.4.0 rocm-hip-sdk5.3.3
+   sudo apt install rocm-hip-sdk5.5 rocm-hip-sdk5.3.3
   ```

 :::::
@@ -160,7 +160,7 @@ section.
 sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/rhel/8.6/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/5.5/rhel/8.6/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -179,7 +179,7 @@ sudo yum clean all
 sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/rhel/8.7/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/5.5/rhel/8.7/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -198,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/5.4/rhel/9.1/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/5.5/rhel/9.1/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -228,7 +228,7 @@ To add the ROCm repository, use the following steps, based on your distribution:
 :sync: RHEL-8

 ```shell
-for ver in 5.3.3 5.4; do
+for ver in 5.3.3 5.4.3 5.5; do
 sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -247,7 +247,7 @@ sudo yum clean all
 :sync: RHEL-9

 ```shell
-for ver in 5.3.3 5.4; do
+for ver in 5.3.3 5.4.3 5.5; do
 sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -282,7 +282,7 @@ For a comprehensive list of meta-packages, refer to
 - Sample Multi-version installation

   ```shell
-   sudo yum install rocm-hip-sdk5.4.0 rocm-hip-sdk5.3.3
+   sudo yum install rocm-hip-sdk5.5 rocm-hip-sdk5.3.3
   ```

 :::::
@@ -301,7 +301,7 @@ section.
 sudo tee /etc/zypp/repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/sle/15.4/main/x86_64
+baseurl=https://repo.radeon.com/amdgpu/5.5/sle/15.4/main/x86_64
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
@@ -323,7 +323,7 @@ sudo reboot
 To add the ROCm repository, use the following steps:

 ```shell
-for ver in 5.3.3 5.4; do
+for ver in 5.3.3 5.4.3 5.5; do
 sudo tee --append /etc/zypp/repos.d/rocm.repo <<EOF
 [ROCm-$ver]
 name=ROCm$ver
@@ -355,7 +355,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.4.0 rocm-hip-sdk5.3.3
+   sudo zypper --gpg-auto-import-keys install rocm-hip-sdk5.5 rocm-hip-sdk5.3.3
   ```

 :::::
@@ -392,7 +392,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.4.0/bin:/opt/rocm-5.4.0/opencl/bin
+   export PATH=$PATH:/opt/rocm-5.5/bin:/opt/rocm-5.5/opencl/bin
   ```

   ```{attention}
--- a/docs/deploy/linux/os-native/upgrade.md
+++ b/docs/deploy/linux/os-native/upgrade.md
@@ -26,7 +26,7 @@ repository to the new release.

 ```shell
 # amdgpu repository for focal
-echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.4/ubuntu focal main' \
+echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.5/ubuntu focal main' \
    | sudo tee /etc/apt/sources.list.d/amdgpu.list
 sudo apt update
 ```
@@ -37,7 +37,7 @@ sudo apt update

 ```shell
 # amdgpu repository for jammy
-echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.4/ubuntu jammy main' \
+echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.5/ubuntu jammy main' \
    | sudo tee /etc/apt/sources.list.d/amdgpu.list
 sudo apt update
 ```
@@ -57,7 +57,7 @@ sudo apt update
 sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/rhel/8.6/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/5.5/rhel/8.6/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -75,7 +75,7 @@ sudo yum clean all
 sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/rhel/8.7/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/5.5/rhel/8.7/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -93,7 +93,7 @@ sudo yum clean all
 sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/rhel/9.1/main/x86_64/
+baseurl=https://repo.radeon.com/amdgpu/5.5/rhel/9.1/main/x86_64/
 enabled=1
 priority=50
 gpgcheck=1
@@ -112,7 +112,7 @@ sudo yum clean all
 sudo tee /etc/zypp/repos.d/amdgpu.repo <<EOF
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/sle/15.4/main/x86_64
+baseurl=https://repo.radeon.com/amdgpu/5.5/sle/15.4/main/x86_64
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
@@ -172,7 +172,7 @@ repository to the new release.
 :sync: ubuntu-20.04

 ```shell
-echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.4 focal main" \
+echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.5 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
@@ -184,7 +184,7 @@ sudo apt update
 :sync: ubuntu-22.04

 ```shell
-echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.4 jammy main" \
+echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.5 jammy 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
@@ -203,9 +203,9 @@ sudo apt update

 ```shell
 sudo tee /etc/yum.repos.d/rocm.repo <<EOF
-[ROCm-5.4]
-name=ROCm5.4
-baseurl=https://repo.radeon.com/rocm/rhel8/5.4/main
+[ROCm-5.5]
+name=ROCm5.5
+baseurl=https://repo.radeon.com/rocm/rhel8/5.5/main
 enabled=1
 priority=50
 gpgcheck=1
@@ -220,9 +220,9 @@ sudo yum clean all

 ```shell
 sudo tee /etc/yum.repos.d/rocm.repo <<EOF
-[ROCm-5.4]
-name=ROCm5.4
-baseurl=https://repo.radeon.com/rocm/rhel9/5.4/main
+[ROCm-5.5]
+name=ROCm5.5
+baseurl=https://repo.radeon.com/rocm/rhel9/5.5/main
 enabled=1
 priority=50
 gpgcheck=1
@@ -239,10 +239,10 @@ sudo yum clean all

 ```shell
 sudo tee /etc/zypp/repos.d/rocm.repo <<EOF
-[ROCm-5.4]
-name=ROCm5.4
+[ROCm-5.5]
+name=ROCm5.5
 name=rocm
-baseurl=https://repo.radeon.com/rocm/zyp/5.4/main
+baseurl=https://repo.radeon.com/rocm/zyp/5.5/main
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
--- a/docs/deploy/linux/quick_start.md
+++ b/docs/deploy/linux/quick_start.md
@@ -29,11 +29,11 @@ wget https://repo.radeon.com/rocm/rocm.gpg.key -O - | \
 ```shell
 # Kernel driver repository for focal
 sudo tee /etc/apt/sources.list.d/amdgpu.list <<'EOF'
-deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.4/ubuntu focal main
+deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.5/ubuntu focal main
 EOF
 # ROCm repository for focal
 sudo tee /etc/apt/sources.list.d/rocm.list <<'EOF'
-deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.4 focal main
+deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.5 focal main
 EOF
 ```

@@ -44,13 +44,15 @@ EOF
 ```shell
 # Kernel driver repository for jammy
 sudo tee /etc/apt/sources.list.d/amdgpu.list <<'EOF'
-deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.4/ubuntu jammy main
+deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.5/ubuntu jammy main
 EOF
 # ROCm repository for jammy
 sudo tee /etc/apt/sources.list.d/rocm.list <<'EOF'
-deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.4 jammy main
-echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' | sudo tee /etc/apt/preferences.d/rocm-pin-600
+deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.5 jammy main
 EOF
+
+# Prefer packages from the rocm repository over system packages
+echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' | sudo tee /etc/apt/preferences.d/rocm-pin-600
 ```

 :::
@@ -80,7 +82,7 @@ sudo apt update
 sudo tee /etc/yum.repos.d/amdgpu.repo <<'EOF'
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/rhel/8.6/main/x86_64
+baseurl=https://repo.radeon.com/amdgpu/5.5/rhel/8.6/main/x86_64
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
@@ -89,7 +91,7 @@ EOF
 sudo tee /etc/yum.repos.d/rocm.repo <<'EOF'
 [rocm]
 name=rocm
-baseurl=https://repo.radeon.com/rocm/rhel8/5.4/main
+baseurl=https://repo.radeon.com/rocm/rhel8/5.5/main
 enabled=1
 priority=50
 gpgcheck=1
@@ -107,7 +109,7 @@ EOF
 sudo tee /etc/yum.repos.d/amdgpu.repo <<'EOF'
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/rhel/8.7/main/x86_64
+baseurl=https://repo.radeon.com/amdgpu/5.5/rhel/8.7/main/x86_64
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
@@ -116,7 +118,7 @@ EOF
 sudo tee /etc/yum.repos.d/rocm.repo <<'EOF'
 [rocm]
 name=rocm
-baseurl=https://repo.radeon.com/rocm/rhel8/5.4/main
+baseurl=https://repo.radeon.com/rocm/rhel8/5.5/main
 enabled=1
 priority=50
 gpgcheck=1
@@ -134,7 +136,7 @@ EOF
 sudo tee /etc/yum.repos.d/amdgpu.repo <<'EOF'
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/rhel/9.1/main/x86_64
+baseurl=https://repo.radeon.com/amdgpu/5.5/rhel/9.1/main/x86_64
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
@@ -143,7 +145,7 @@ EOF
 sudo tee /etc/yum.repos.d/rocm.repo <<'EOF'
 [rocm]
 name=rocm
-baseurl=https://repo.radeon.com/rocm/rhel9/5.4/main
+baseurl=https://repo.radeon.com/rocm/rhel9/5.5/main
 enabled=1
 priority=50
 gpgcheck=1
@@ -179,7 +181,7 @@ sudo yum clean all
 sudo tee /etc/zypp/repos.d/amdgpu.repo <<'EOF'
 [amdgpu]
 name=amdgpu
-baseurl=https://repo.radeon.com/amdgpu/5.4/sle/15.4/main/x86_64
+baseurl=https://repo.radeon.com/amdgpu/5.5/sle/15.4/main/x86_64
 enabled=1
 gpgcheck=1
 gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
--- a/docs/release/3rd_party_support_matrix.md
+++ b/docs/release/3rd_party_support_matrix.md
@@ -18,6 +18,7 @@ TensorFlow
 | 5.2.x | 1.10, 1.11, 1.12           | 2.8, 2.9, 2.9        |       |
 | 5.3.x | 1.10.1, 1.11, 1.12.1, 1.13 | 2.8, 2.9, 2.10       |       |
 | 5.4.x | 1.10.1, 1.11, 1.12.1, 1.13 | 2.8, 2.9, 2.10, 2.11 | 2.5.4 |
+| 5.5.x | 1.10.1, 1.11, 1.12.1, 1.13 | 2.10, 2.11           | 2.5.4 |

 ## Communication libraries

@@ -45,6 +46,7 @@ contemporary CUDA / NVIDIA HPC SDK alternatives.
 | 5.2.x | 1.15         | 22.2, 22.3 |
 | 5.3.x | 1.16         | 22.7       |
 | 5.4.x | 1.16         | 22.9       |
+| 5.5.x | 1.17         | 22.9       |

 For the latest documentation of these libraries, refer to the
 [associated documentation](../reference/gpu_libraries/c%2B%2B_primitives.md).
--- a/docs/release/gpu_os_support.md
+++ b/docs/release/gpu_os_support.md
@@ -12,7 +12,7 @@ AMD ROCm™ Platform supports the following Linux distributions.
 | RHEL 8.6 to 8.7    | x86-64                | 4.18               |
 | SLES 15 SP4        | x86-64                | 5.14.21            |
 | Ubuntu 20.04.5 LTS | x86-64                | 5.15               |
-| Ubuntu 22.04.1 LTS | x86-64                | 5.15, 5.17 OEM     |
+| Ubuntu 22.04.2 LTS | x86-64                | 5.19               |

 ## Virtualization Support

--- a/docs/release/licensing.md
+++ b/docs/release/licensing.md
@@ -121,4 +121,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.4.0/share/doc/amd_comgr/LICENSE.txt`
+`/opt/rocm-5.4.3/share/doc/amd_comgr/LICENSE.txt`
--- a/docs/release/user_kernel_space_compat_matrix.md
+++ b/docs/release/user_kernel_space_compat_matrix.md
@@ -12,4 +12,7 @@ the compatibility combinations that are currently supported.
 | 5.2.0 | 5.0.2, 5.1.3               |
 | 5.2.3 | 5.3.0, 5.4.0               |
 | 5.3.0 | 5.1.3, 5.2.3               |
+| 5.3.3 | 5.4.0, 5.5.0               |
 | 5.4.0 | 5.2.3, 5.3.3               |
+| 5.4.4 | 5.5.0                      |
+| 5.5.0 | 5.3.3, 5.4.3               |
--- a/tools/autotag/templates/rocm_changes/5.5.0.md
+++ b/tools/autotag/templates/rocm_changes/5.5.0.md
@@ -26,6 +26,29 @@ The following hipcc changes are implemented in this release:
  - `hipCommander` at <https://github.com/ROCm-Developer-Tools/hip-tests/tree/develop/samples/1_Utils/hipCommander>

  Note that the samples will continue to be available in previous release branches.
+- Removal of gcnarch from hipDeviceProp_t structure
+- Addition of new fields in hipDeviceProp_t structure
+  - maxTexture1D
+  - maxTexture2D
+  - maxTexture1DLayered
+  - maxTexture2DLayered
+  - sharedMemPerMultiprocessor
+  - deviceOverlap
+  - asyncEngineCount
+  - surfaceAlignment
+  - unifiedAddressing
+  - computePreemptionSupported
+  - hostRegisterSupported
+  - uuid
+- Removal of deprecated code
+  - hip-hcc codes from hip code tree
+- Correct hipArray usage in HIP APIs such as hipMemcpyAtoH and hipMemcpyHtoA
+- HIPMEMCPY_3D fields correction to avoid truncation of "size_t" to "unsigned int" inside hipMemcpy3D()
+- Renaming of 'memoryType' in hipPointerAttribute_t structure to 'type'
+- Correct hipGetLastError to return the last error instead of last API call's return code
+- Update hipExternalSemaphoreHandleDesc to add "unsigned int reserved[16]"
+- Correct handling of flag values in hipIpcOpenMemHandle for hipIpcMemLazyEnablePeerAccess
+- Remove hiparray* and make it opaque with hipArray_t

 ##### New HIP APIs in This Release
Author	SHA1	Message	Date
Sam Wu	8e1883e3b5	Update documentation requirements	2024-09-16 10:12:48 -08:00
Sam Wu	7b47153482	Update documentation requirements	2024-06-06 16:58:41 -06:00
Sam Wu	4e862b6b64	Fix RTD config	2024-05-02 08:55:18 -06:00
Sam Wu	a68d0c95c2	Update documentation requirements	2024-05-01 16:59:31 -06:00
Sam Wu	6683d7d24d	Update documentation requirements	2024-05-01 16:54:02 -06:00
Mátyás Aradi	602e82e6da	Update Linux and ROCm versions (#2880 )	2024-02-07 13:14:17 -07:00
xiaohuguo2023	08caa3481d	fix issue of ROCm repository for ubuntu22.04 (#2633 )	2023-11-12 20:24:05 -07:00
Sam Wu	04420d976f	Update rtd yaml config (#2634 ) Require build.os	2023-11-09 15:25:28 -07:00
Sam Wu	d4306c51fd	add version to html title	2023-08-04 17:18:01 -06:00
Sam Wu	4d7fc6bcb0	rocm-docs-core v0.18.3	2023-06-30 09:41:08 -06:00
Sam Wu	9562420ae4	update conf.py	2023-06-29 11:16:58 -06:00
Rahul Garg	99d28df040	Update backward incompatible planned changes in 5.5 (#2279 ) * Update backward incompatible planned changes * add planned changes to changelog * update rocm-docs-core to v0.18.3 --------- Co-authored-by: Sam Wu <sam.wu2@amd.com>	2023-06-29 11:00:04 -06:00