Compare commits

..

80 Commits

Author SHA1 Message Date
zhang2amd
c058e7a1c9 Added hipamd and MIOpenTensile to manifest. 2021-11-09 07:57:31 -08:00
zhang2amd
0d12925fe9 Merge pull request #1602 from RadeonOpenCompute/zhang2amd-patch-1
Update manifest for ROCm 4.5 release.
2021-10-27 20:36:31 -07:00
zhang2amd
f088317e44 Update manifest for ROCm 4.5 release. 2021-10-27 20:35:20 -07:00
Roopa Malavally
ca8f60e96f Update README.md 2021-10-27 19:26:36 -07:00
Roopa Malavally
ba8c56abdc Update README.md 2021-10-27 19:24:34 -07:00
Roopa Malavally
18410afcd7 Add files via upload 2021-10-27 07:24:03 -07:00
Roopa Malavally
c637c2a964 Add files via upload 2021-10-26 19:00:15 -07:00
Roopa Malavally
5a56a31fac Delete AMD_HIP_Supported_CUDA_API_Reference_Guide.pdf 2021-10-26 18:59:59 -07:00
Roopa Malavally
82b35be1ee Add files via upload 2021-10-26 18:21:01 -07:00
Roopa Malavally
03fb0f863c Delete HIP-API-4.5.pdf 2021-10-26 17:28:58 -07:00
Roopa Malavally
c730ade1e3 Add files via upload 2021-10-26 17:28:44 -07:00
Roopa Malavally
164a386ed6 Add files via upload 2021-10-26 17:27:34 -07:00
Roopa Malavally
db517138f6 Add files via upload 2021-10-26 17:17:19 -07:00
Roopa Malavally
bc63e35725 Add files via upload 2021-10-26 16:49:33 -07:00
Roopa Malavally
c9a8556171 Add files via upload 2021-10-26 16:34:10 -07:00
Roopa Malavally
91f193a510 Delete AMD_ROCm_SMI_Guide_v4.3.pdf 2021-10-26 15:46:18 -07:00
Roopa Malavally
b2fac149b5 Delete AMD_ROCm_Release_Notes_v4.3.pdf 2021-10-26 15:46:04 -07:00
Roopa Malavally
1d23bb0ec6 Delete AMD_ROCm_Release_Notes_v4.3.1.pdf 2021-10-26 15:45:49 -07:00
Roopa Malavally
fedfa50634 Delete AMD_ROCm_DataCenter_Tool_User_Guide_v4.3.pdf 2021-10-26 15:45:37 -07:00
Roopa Malavally
51ea894667 Delete AMD_ROCDebugger_User_Guide.pdf 2021-10-26 15:45:26 -07:00
Roopa Malavally
63b0e6d273 Delete AMD_ROCDebugger_API.pdf 2021-10-26 15:45:14 -07:00
Roopa Malavally
f1383c5d16 Delete AMD_RDC_API_Guide_v4.3.pdf 2021-10-26 15:45:02 -07:00
Roopa Malavally
f3ec7b4720 Delete AMD_HIP_Supported_CUDA_API_Reference_Guide_v4.3.pdf 2021-10-26 15:44:52 -07:00
Roopa Malavally
9492fc9b0d Delete AMD_HIP_Programming_Guide_v4.3.pdf 2021-10-26 15:44:37 -07:00
Roopa Malavally
c103fe233f Delete AMD_HIP_API_Guide_v4.3.pdf 2021-10-26 15:44:23 -07:00
Roopa Malavally
63c16a229e Delete AMD_Compiler_Reference_Guide_v4.3.pdf 2021-10-26 15:44:08 -07:00
Paul Menzel
18aa89804f README: Replace screenshots of tables with Markdown table (#1593)
The screenshots are from tables with text, which are not easily searchable,
are bigger in size than needed – increasing load times – and are in a
resolution, causing them to be blurry on HiDPI displays.  Therefore, use a
Markdown table instead solving all the issues above, and delete the images
from the repository.

The SLES service pack version differs in the two screenshots: SP2 vs SP3.
Go for *SP3*.

Resolves: https://github.com/RadeonOpenCompute/ROCm/issues/1591
2021-10-15 06:27:44 -07:00
Roopa Malavally
65a4524834 Update README.md 2021-09-18 12:36:44 -07:00
Roopa Malavally
b04ab30e81 Delete AMD_ROCm_v2.10_Release_Notes.pdf 2021-09-15 19:40:10 -07:00
Roopa Malavally
4c8787087a Update README.md 2021-08-27 15:37:37 -07:00
Roopa Malavally
7cd85779c4 Update README.md 2021-08-27 15:31:42 -07:00
Aakash Sudhanwa
c676ff480e Update default.xml (#1567) 2021-08-27 15:26:48 -07:00
Roopa Malavally
6d19f5b6c1 Add files via upload 2021-08-27 15:24:56 -07:00
Roopa Malavally
4679e8ac87 Update README.md 2021-08-27 15:24:20 -07:00
Roopa Malavally
8a3209f985 Update README.md 2021-08-27 15:23:58 -07:00
Roopa Malavally
79d0d00b2a Update README.md 2021-08-27 15:23:18 -07:00
Roopa Malavally
db5121cdfe Update README.md 2021-08-27 15:22:30 -07:00
Aakash Sudhanwa
035f4995bb Merge branch 'master' into master 2021-08-27 15:08:41 -07:00
Roopa Malavally
f63e3f9ce1 Add files via upload 2021-08-27 15:02:49 -07:00
Roopa Malavally
4e56ed7dc3 Update README.md 2021-08-13 11:49:38 -07:00
Roopa Malavally
2faf5b6ab7 Update README.md 2021-08-13 11:48:18 -07:00
Roopa Malavally
e69b7e6f71 Delete OSKernel.PNG 2021-08-13 11:48:00 -07:00
Roopa Malavally
d53ffd1c89 Add files via upload 2021-08-13 11:47:48 -07:00
Roopa Malavally
e177599de1 Add files via upload 2021-08-09 12:55:19 -07:00
Roopa Malavally
9fc1ba3970 Add files via upload 2021-08-09 12:47:17 -07:00
Nick Curtis
520764faa3 Fix missing links in rocprof docs (#1550) 2021-08-07 08:42:25 -07:00
Roopa Malavally
7d0b53c87f Add files via upload 2021-08-03 10:53:16 -07:00
Roopa Malavally
c3a8ecd0c5 Delete AMD_Compiler_Reference_Guide_v4.3.pdf 2021-08-03 10:49:28 -07:00
Roopa Malavally
21cf37b2df Add files via upload 2021-08-02 21:37:19 -07:00
Roopa Malavally
f4419a3d1c Delete AMD_HIP_Programming_Guide_v4.3.pdf 2021-08-02 21:37:00 -07:00
zhozha
5ffdcf84ab Update to ROCm 4.3 manifest 2021-08-02 17:33:25 -07:00
Roopa Malavally
085295daea Update README.md 2021-08-02 16:51:39 -07:00
Roopa Malavally
cf5cec2580 ROCm v4.3 Release Notes (#1540)
* Delete AMD HIP Programming Guide_v4.2.pdf

* Delete AMD_HIP_API_Guide_4.2.pdf

* Delete AMD_ROCm_DataCenter_Tool_User_Guide_v4.2.pdf

* Delete AMD_ROCm_Release_Notes_v4.2.pdf

* Delete HIP_Supported_CUDA_API_Reference_Guide_v4.2.pdf

* Delete ROCm_Data_Center_Tool_API_Guide_v4.2.pdf

* Delete ROCm_Debugger_API_Guide_v4.2.pdf

* Delete ROCm_Debugger_User_Guide_v4.2.pdf

* Delete ROCm_SMI_Manual_4.2.pdf

* Update README.md

* Update README.md

* Delete CG1.PNG

* Delete CG2.PNG

* Delete CG3.PNG

* Delete CGMain.PNG

* Delete CLI1.PNG

* Delete CLI2.PNG

* Delete SMI.PNG

* Delete keyfeatures.PNG

* Delete latestGPU.PNG

* Delete rocsolverAPI.PNG

* Create test.rst

* Add files via upload

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md
2021-08-02 16:39:54 -07:00
Roopa Malavally
e7a93ae3f5 Add files via upload 2021-08-01 18:53:14 -07:00
Roopa Malavally
e3b7d2f39d Delete AMD_ROCDebugger_API.pdf.pdf 2021-08-01 18:52:58 -07:00
Roopa Malavally
0c4565d913 Delete AMD_ROCDebugger_User_Guide.pdf.pdf 2021-08-01 18:52:30 -07:00
Roopa Malavally
313a589132 Add files via upload 2021-08-01 18:52:03 -07:00
Roopa Malavally
1caf5514e8 Add files via upload 2021-08-01 18:33:33 -07:00
Roopa Malavally
d029ad24cf Add files via upload 2021-08-01 18:09:17 -07:00
Roopa Malavally
ca6638d917 Add files via upload 2021-08-01 17:42:39 -07:00
Roopa Malavally
5cba920022 Add files via upload 2021-08-01 16:21:37 -07:00
Roopa Malavally
cefc8ef1d7 Add files via upload 2021-08-01 16:17:54 -07:00
Roopa Malavally
b71c5705a2 Delete ROCm_SMI_Manual_4.2.pdf 2021-08-01 16:13:32 -07:00
Roopa Malavally
977a1d14cd Delete ROCm_Debugger_User_Guide_v4.2.pdf 2021-08-01 16:13:17 -07:00
Roopa Malavally
3ab60d1326 Delete ROCm_Debugger_API_Guide_v4.2.pdf 2021-08-01 16:13:04 -07:00
Roopa Malavally
4b5b13294e Delete ROCm_Data_Center_Tool_API_Guide_v4.2.pdf 2021-08-01 16:12:50 -07:00
Roopa Malavally
ce66b14d9e Delete HIP_Supported_CUDA_API_Reference_Guide_v4.2.pdf 2021-08-01 16:12:32 -07:00
Roopa Malavally
01f63f546f Delete AMD_ROCm_Release_Notes_v4.2.pdf 2021-08-01 16:12:20 -07:00
Roopa Malavally
72eab2779e Delete AMD_ROCm_DataCenter_Tool_User_Guide_v4.2.pdf 2021-08-01 16:12:05 -07:00
Roopa Malavally
8a366db3d7 Delete AMD_HIP_API_Guide_4.2.pdf 2021-08-01 16:11:50 -07:00
Roopa Malavally
8267a84345 Delete AMD HIP Programming Guide_v4.2.pdf 2021-08-01 16:11:30 -07:00
zhang2amd
f7b3a38d49 Merge pull request #1470 from RadeonOpenCompute/roc-4.2.x
4.2 : Manifest Files
2021-05-11 14:58:43 -07:00
Aakash Sudhanwa
67bd7501c1 Update README.md 2019-12-18 14:10:38 -08:00
Aakash Sudhanwa
d62f1c4247 Merge pull request #12 from RadeonOpenCompute/master
Rebase
2019-12-18 14:09:40 -08:00
Aakash Sudhanwa
c3d5bc6406 Rename Release nodes pdf 2019-11-25 20:54:25 -08:00
Aakash Sudhanwa
db45731729 Merge pull request #11 from RadeonOpenCompute/master
ROCm Release 2.10 (#947)
2019-11-25 20:12:36 -08:00
Aakash Sudhanwa
34552e95e0 Release Notes 2019-11-25 19:23:24 -08:00
Aakash Sudhanwa
8d0c516c5c Merge pull request #10 from RadeonOpenCompute/master
Update to 2.10
2019-11-25 19:20:50 -08:00
Aakash Sudhanwa
5cba919767 default.xml: ROCm Rel 2.10 2019-11-25 14:38:06 -08:00
Aakash Sudhanwa
bb0022e972 Merge pull request #9 from RadeonOpenCompute/master
Updating to latest
2019-11-25 13:04:27 -08:00
32 changed files with 62961 additions and 53044 deletions

Binary file not shown.

62524
AMD-HIP-API-4.5.pdf Normal file

File diff suppressed because it is too large Load Diff

Binary file not shown.

File diff suppressed because it is too large Load Diff

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

BIN
RDC_API_Manual_4.5.pdf Normal file

Binary file not shown.

780
README.md
View File

@@ -1,29 +1,28 @@
# AMD ROCm™ v4.2 Release Notes
# AMD ROCm™ v4.5 Release Notes
This document describes the features, fixed issues, and information about downloading and installing the AMD ROCm™ software. It also covers known issues and deprecations in this release.
- [Supported Operating Systems and Documentation Updates](#Supported-Operating-Systems-and-Documentation-Updates)
* [Supported Operating Systems](#Supported-Operating-Systems)
- Supported Operating Environments and Documentation Updates
* [Supported Operating Environments](#Supported-Operating-Environments)
* [ROCm Installation Updates](#ROCm-Installation-Updates)
* [AMD ROCm Documentation Updates](#AMD-ROCm-Documentation-Updates)
- [What\'s New in This Release](#Whats-New-in-This-Release)
- What\'s New in This Release
* [HIP Enhancements](#HIP-Enhancements)
* [ROCm Data Center Tool](#ROCm-Data-Center-Tool)
* [ROCm Math and Communication Libraries](#ROCm-Math-and-Communication-Libraries)
* [Unified Memory Support in ROCm](#Unified-Memory-Support-in-ROCm)
* [System Management Interface](#System-Management-Interface)
* [ROCm Math and Communication Libraries](#ROCm-Math-and-Communication-Libraries)
* [OpenMP Enhancements](#OpenMP-Enhancements)
- Known Issues in This Release
* [Known Issues in This Release](#Known-Issues-in-This-Release)
- [Fixed Defects](#Fixed-Defects)
- Deprecations in This Release
* [Deprecations](#Deprecations)
- [Known Issues](#Known-Issues)
- [Deprecations](#Deprecations)
* [Compiler Generated Code Object Version 2 Deprecation ](#Compiler-Generated-Code-Object-Version-2-Deprecation)
- [Deploying ROCm](#Deploying-ROCm)
- [Hardware and Software Support](#Hardware-and-Software-Support)
- [Machine Learning and High Performance Computing Software Stack for AMD GPU](#Machine-Learning-and-High-Performance-Computing-Software-Stack-for-AMD-GPU)
@@ -33,434 +32,515 @@ This document describes the features, fixed issues, and information about downlo
## ROCm Installation Updates
# ROCm Installation Updates
### Supported Operating Systems
This document describes the features, fixed issues, and information
about downloading and installing the AMD ROCm™ software.
The AMD ROCm platform is designed to support the following operating systems:
It also covers known issues and deprecations in this release.
* Ubuntu 20.04.2 HWE (5.4 and 5.6-oem) and 18.04.5 (Kernel 5.4)
* CentOS 7.9 (3.10.0-1127) & RHEL 7.9 (3.10.0-1160.6.1.el7) (Using devtoolset-7 runtime support)
* CentOS 8.3 (4.18.0-193.el8)and RHEL 8.3 (4.18.0-193.1.1.el8) (devtoolset is not required)
* SLES 15 SP2
## Supported Operating Environments
The AMD ROCm platform supports the following operating systems:
| OS | Kernel |
| --- | --- |
| SLES15 SP3 | 5.3.18-24.49 |
| RHEL 7.9 | 3.10.0-1160.6.1.el7 |
| CentOS 7.9 | 3.10.0-1127 |
| RHEL 8.4 | 4.18.0-193.1.1.el8 |
| CentOS 8.3 | 4.18.0-193.el8 |
| Ubuntu 18.04.5 | 5.4.0-71-generic |
| Ubuntu 20.04.3HWE | 5.8.0-48-generic |
| Host OS | Azure RS1.86 |
| Guest OS | Ubuntu 20.04 |
### Complete Installation of AMD ROCM V4.2 Recommended
## Enhanced Installation Process for ROCm v4.5
Complete uninstallation of previous ROCm versions is required before installing a new version of ROCm. **An upgrade from previous releases to AMD ROCm v4.2 is not supported**. For more information, refer to the AMD ROCm Installation Guide at
In addition to the installation method using the native Package Manager, AMD ROCm v4.5 introduces added methods to install ROCm. With this
release, the ROCm installation uses the *amdgpu-install* and *amdgpu-uninstall* scripts. 
https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html
The *amdgpu-install* script streamlines the installation process by:
**Note**: AMD ROCm release v3.3 or prior releases are not fully compatible with AMD ROCm v3.5 and higher versions. You must perform a fresh ROCm installation if you want to upgrade from AMD ROCm v3.3 or older to 3.5 or higher versions and vice-versa.
- Abstracting the distribution-specific package installation logic
**Note**: *render* group is required only for Ubuntu v20.04. For all other ROCm supported operating systems, continue to use video group.
- Performing the repository set-up
* For ROCm v3.5 and releases thereafter, the clinfo path is changed to /opt/rocm/opencl/bin/clinfo.
- Allowing user to specify the use case and automating the installation of all the required packages,
* For ROCm v3.3 and older releases, the clinfo path remains /opt/rocm/opencl/bin/x86_64/clinfo.
## ROCm Multi-Version Installation Update
- Performing post-install checks to verify whether the installation was performed successfully
With the AMD ROCm v4.2 release, the following ROCm multi-version installation changes apply:
- Installing the uninstallation script
The meta packages rocm-dkms<version> are now deprecated for multi-version ROCm installs. For example, rocm-dkms3.7.0, rocm-dkms3.8.0.
* Multi-version installation of ROCm should be performed by installing rocm-dev<version> using each of the desired ROCm versions. For example, rocm-dev3.7.0, rocm-dev3.8.0, rocm-dev3.9.0.
The *amdgpu-uninstall* script allows the removal of the entire ROCm stack by using a single command.
* The rock-dkms loadable kernel modules should be installed using a single rock-dkms package.
Some of the ROCm-specific use cases that the installer currently supports are:
* ROCm v3.9 and above will not set any ldconfig entries for ROCm libraries for multi-version installation. Users must set LD_LIBRARY_PATH to load the ROCm library version of choice.
- OpenCL (ROCr/KFD based) runtime
**NOTE**: The single version installation of the ROCm stack remains the same. The rocm-dkms package can be used for single version installs and is not deprecated at this time.
- HIP runtimes
- ROCm libraries and applications
- ROCm Compiler and device libraries
- ROCr runtime and thunk
**Note:** Graphics use cases are not supported in this release.
For more details, refer to the AMD ROCm Installation Guide v4.5 at,
https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation_new.html
### Updated HIP Instructions for ROCm Installation
The hip-base package has a dependency on Perl modules that some operating systems may not have in their default package repositories. Use the following commands to add repositories that have the required Perl packages:
#### For SLES 15 SP2
sudo zypper addrepo
For more information, see
https://download.opensuse.org/repositories/devel:languages:perl/SLE_15/devel:languages:perl.repo
#### For CentOS8.3
sudo yum config-manager --set-enabled powertools
#### For RHEL8.3
sudo subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
# AMD ROCm Documentation Updates
# AMD ROCm Documentation Updates
## AMD ROCm Installation Guide
The AMD ROCm Installation Guide in this release includes:
The AMD ROCm Installation Guide in this release includes the following
updates:
* Supported Environments
- New - Installation Guide for ROCm v4.5
* Installation Instructions
* HIP Installation Instructions
For more information, refer to the ROCm documentation website at:
https://rocmdocs.amd.com/en/latest/
https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation_new.html
## AMD ROCm - HIP Documentation Updates
## AMD Instinct™ High Performance Computing and Tuning
* HIP Programming Guide v4.2
- New - AMD Instinct™ High Performance Computing and Tuning Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD%20HIP%20Programming%20Guide_v4.2.pdf
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD%20Instinct%E2%84%A2High%20Performance%20Computing%20and%20Tuning%20Guide.pdf
## HIP Documentation
* HIP API Guide v4.2
- HIP installation instructions
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_HIP_API_Guide_4.2.pdf
https://rocmdocs.amd.com/en/latest/Installation_Guide/HIP-Installation.html
- HIP Programming Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_HIP_Programming_Guide.pdf
- HIP API Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD-HIP-API-4.5.pdf
- HIP-Supported CUDA API Reference Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_HIP_Supported_CUDA_API_Reference_Guide.pdf
- AMD ROCm Compiler Reference Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_Compiler_Reference_Guide_v4.5.pdf
- HIP FAQ
<https://rocmdocs.amd.com/en/latest/Programming_Guides/HIP-FAQ.html#hip-faq>
## System Interface Management
- System Interface Management (SMI)
https://rocmdocs.amd.com/en/latest/ROCm_System_Managment/ROCm-System-Managment.html
## AMD ROCm Data Center Tool
- AMD ROCm Data Center Tool API Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/RDC_API_Manual_4.5.pdf
- AMD ROCm Data Center Tool User Guide
* HIP-Supported CUDA API Reference Guide v4.2
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_ROCm_DataCenter_Tool_User_Guide_v4.5.pdf
https://github.com/RadeonOpenCompute/ROCm/blob/master/HIP_Supported_CUDA_API_Reference_Guide_v4.2.pdf
## ROCm SMI API Guide
* HIP FAQ
- ROCm SMI API Guide
For more information, refer to
https://github.com/RadeonOpenCompute/ROCm/blob/master/ROCm_SMI_Manual_4.5.pdf
https://rocmdocs.amd.com/en/latest/Programming_Guides/HIP-FAQ.html#hip-faq
## ROCm Data Center User and API Guide
* ROCm Data Center Tool User Guide
- Reliability, Accessibility, and Serviceability (RAS) Plugin Integration
For more information, refer to the ROCm Data Center User Guide at,
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_ROCm_DataCenter_Tool_User_Guide_v4.2.pdf
* ROCm Data Center Tool API Guide
For more information, refer to the ROCm Data Center API Guide at,
https://github.com/RadeonOpenCompute/ROCm/blob/master/ROCm_Data_Center_Tool_API_Guide_v4.2.pdf
## ROCm SMI API Documentation Updates
* ROCm SMI API Guide
For more information, refer to the ROCm SMI API Guide at,
https://github.com/RadeonOpenCompute/ROCm/blob/master/ROCm_SMI_Manual_4.2.pdf
## ROC Debugger User and API Guide
* ROC Debugger User Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/ROCm_Debugger_User_Guide_v4.2.pdf
- ROCDebugger User Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/ROCDebugger_User_Guide.pdf
- Debugger API Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/ROCDebugger_API_Guide.pdf
## OpenMP Documentation
- Updated OpenMP documentation
https://rocmdocs.amd.com/en/latest/Programming_Guides/openmp_support.html
* Debugger API Guide
https://github.com/RadeonOpenCompute/ROCm/blob/master/ROCm_Debugger_API_Guide_v4.2.pdf
## AMD ROCm General Documentation Links
- For AMD ROCm documentation, see
https://rocmdocs.amd.com/en/latest/
- For installation instructions on supported platforms, see
https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html
- For AMD ROCm binary structure, see
https://rocmdocs.amd.com/en/latest/Installation_Guide/Software-Stack-for-AMD-GPU.html
- For AMD ROCm release history, see
https://rocmdocs.amd.com/en/latest/Current_Release_Notes/ROCm-Version-History.html
## General AMD ROCm Documentation Links
Access the following links for more information:
* For AMD ROCm documentation, see
https://rocmdocs.amd.com/en/latest/
* For installation instructions on supped platforms, see
https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html
* For AMD ROCm binary structure, see
https://rocmdocs.amd.com/en/latest/Installation_Guide/Software-Stack-for-AMD-GPU.html
* For AMD ROCm Release History, see
https://rocmdocs.amd.com/en/latest/Current_Release_Notes/ROCm-Version-History.html
# What\'s New in This Release
# What's New in This Release
## HIP Enhancements
### HIP Target Platform Macro
The ROCm v4.5 release consists of the following HIP enhancements:
The platform macros are updated to target either the AMD or NVIDIA platform in HIP projects. They now include corresponding headers and libraries for compilation/linking.
### HIP Direct Dispatch
* *__HIP_PLATFORM_AMD__* is defined if the HIP platform targets AMD. Note, __HIP_PLATFORM_HCC__ was used previously if the HIP platform targeted AMD.
This is now deprecated.
The conventional producer-consumer model where the host thread(producer) enqueues commands to a command queue (per stream), which is then
processed by a separate, per-stream worker thread (consumer) created by the runtime, is no longer applicable.
* *__HIP_PLATFORM_NVIDIA__* is defined if the HIP platform targets NVIDIA. Note, _HIP_PLATFORM_NVCC__ was used previously if the HIP platform targeted NVIDIA. This is now deprecated.
In this release, for Direct Dispatch, the runtime directly queues a packet to the AQL queue (user mode queue to GPU) in Dispatch and some of
the synchronization. This new functionality indicates the total latency of the HIP Dispatch API and the latency to launch the first wave on the
GPU.
For example,
In addition, eliminating the threads in runtime has reduced the variance in the dispatch numbers as the thread scheduling delays and
atomics/locks synchronization latencies are reduced.
This feature can be disabled by setting the following environment variable,
```
AMD_DIRECT_DISPATCH=0
```
#if (defined(__HIP_PLATFORM_AMD__)) && !(defined(__HIP_PLATFORM_NVIDIA__))
### Support for HIP Graph
#include <hip/amd_detail/hip_complex.h>
ROCm v4.5 extends support for HIP Graph. For details, refer to the HIP
API Guide at
#elif !(defined(__HIP_PLATFORM_AMD__)) && (defined(__HIP_PLATFORM_NVIDIA__))
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD-HIP-API-4.5.pdf
#include <hip/nvidia_detail/hip_complex.h>
### Enhanced *launch_bounds* Check Error Log Message
When a kernel is launched with HIP APIs, for example, hipModuleLaunchKernel(), HIP validates to check that input kernel
dimension size is not larger than specified launch_bounds.
If exceeded, HIP returns launch failure if AMD_LOG_LEVEL is set with the proper value. Users can find more information in the error log message,
including launch parameters of kernel dim size, launch bounds, and the name of the faulting kernel. It is helpful to figure out the faulting
kernel. Besides, the kernel dim size and launch bounds values will also assist in debugging such failures.
For more details, refer to the HIP Programming Guide at
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_HIP_Programming_Guide.pdf
### HIP Runtime Compilation
HIP now supports runtime compilation (hipRTC), the usage of which will provide the possibility of optimizations and performance improvement
compared with other APIs via regular offline static compilation.
hipRTC APIs accept HIP source files in character string format as input parameters and create handles of programs by compiling the HIP source
files without spawning separate processes.
For more details on hipRTC APIs, refer to the HIP API Guide at
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD-HIP-API-4.5.pdf
### New Flag for Backwards Compatibility on float/double atomicAdd Function
In the ROCm4.5 release, a new compilation flag is introduced as an
option in the CMAKE file. This flag ensures backwards compatibility in
float/double atomicAdd functions.
```
\_\_HIP_USE_CMPXCHG_FOR_FP_ATOMICS
```
This compilation flag is not set("0") by default, so the HIP runtime uses the current float/double atomicAdd functions.
If this compilation flag is set to "1" with the CMAKE option, the existing float/double atomicAdd functions is used for compatibility with
compilers that do not support floating point atomics.
```
D\_\_HIP_USE_CMPXCHG_FOR_FP_ATOMICS=1
```
For details on how to build the HIP runtime, refer to the HIP Programming Guide at
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_HIP_Programming_Guide.pdf
### Updated HIP Version Definition
The HIP version definition is updated as follows:
```
HIP_VERSION=HIP_VERSION_MAJOR \* 10000000 + HIP_VERSION_MINOR \*
100000 + HIP_VERSION_PATCH)
```
The HIP version can be queried from the following HIP API call,
```
hipRuntimeGetVersion(&runtimeVersion);
```
The version returned is always greater than the versions in the previous
ROCm releases.
**Note:** The version definition of the HIP runtime is different from that of CUDA. The function returns the HIP runtime version on the AMD
platform, while on the NVIDIA platform, it returns the CUDA runtime version. There is no mapping or a correlation between the HIP and CUDA
versions.
### Planned HIP Enhancements and Fixes
#### Changes to hiprtc implementation to match nvrtc behavior
In this release, there are changes to the *hiprtc* implementation to
match the *nvrtc* behavior.
**Impact:** Applications can no longer explicitly include HIP runtime header files. Minor code changes are required to remove the HIP runtime
header files.
#### HIP device attribute enumeration
In a future release, there will be a breaking change in the HIP device attribute enumeration. Enum values are being rearranged to accommodate
future enhancements and additions.
**Impact:** This will require users to rebuild their applications. No code changes are required.
#### Changes to behavior of hipGetLastError() and hipPeekAtLastError() to match CUDA behavior available
In a later release, changes to behavior of hipGetLastError() and hipPeekAtLastError() to match CUDA behavior will be available.
**Impact:** Applications relying on the previous behavior will be impacted and may require some code changes.
## Unified Memory Support in ROCm
Unified memory allows applications to map and migrate data between CPU and GPU seamlessly without explicitly copying it between different
allocations. This enables a more complete implementation of *hipMallocManaged*, *hipMemAdvise*, *hipMemPrefetchAsync* and related
APIs. Without unified memory, these APIs only support system memory. With unified memory, the driver can automatically migrate such memory to
GPU memory for faster access.
### Supported Operating Systems and Versions
This feature is only supported on recent Linux kernels. Currently, it works on Ubuntu versions with 5.6 or newer kernels and the DKMS driver
from ROCm. Current releases of RHEL and SLES do not support this feature yet. Future releases of those distributions will add support for this.
The unified memory feature is also supported in the KFD driver included with upstream kernels starting from Linux 5.14.
Unified memory only works on GFXv9 and later GPUs, including Vega10 and MI100. Fiji, Polaris and older GPUs are not supported. To check whether
unified memory is enabled, look in the kernel log for this message:
```
\$ dmesg \| grep \"HMM registered"
```
If unified memory is enabled, there should be a message like "HMM registered xyzMB device memory". If unified memory is not supported on
your GPU or kernel version, this message is missing.
### Unified Memory Support and XNACK
Unified memory support comes in two flavours, XNACK-enabled and XNACK-disabled. XNACK refers to the ability of the GPU to handle page
faults gracefully and retry a memory access. In XNACK-enabled mode, the GPU can handle retry after page-faults, which enables mapping and
migrating data on demand, as well as memory overcommitment. In XNACK-disabled mode, all memory must be resident and mapped in the GPU
page tables when the GPU is executing application code. Any migrations involve temporary preemption of the GPU queues by the driver. Both page
fault handling and preemptions, happen automatically and are transparent to the applications.
XNACK-enabled mode only has experimental support. XNACK-enabled mode requires compiling shader code differently. By default, the ROCm
compiler builds code that works in both modes. Code can be optimized for one specific mode with compiler options:
OpenCL:
```
clang \... -mcpu=gfx908:***xnack+***:sramecc- \... // xnack on, sramecc off\
clang \... -mcpu=gfx908:***xnack-***:sramecc+ \... // xnack off, sramecc on
```
HIP:
```
clang \... \--cuda-gpu-arch=gfx906:xnack+ \... // xnack on\
clang \... \--cuda-gpu-arch=gfx906:xnack- \... // xnack off
```
Not all the math libraries included in ROCm support XNACK-enabled mode on current hardware. Applications will fail to run if their shaders are
compiled in the incorrect mode.
On current hardware, the XNACK mode can be chosen at boot-time by a module parameter amdgpu.noretry. The default is XNACK-disabled
(amdgpu.noretry=1).
## System Management Interface
### Enhanced ROCm SMI --setpoweroverdrive Functionality
The ROCm System Management Interface (SMI) *--setpoweroverdrive* functionality is used to lower the power cap on a device without needing
to enable the OverDrive functionality in the driver. Similarly, even with the OverDrive driver functionality enabled, it is possible to
request a lower power cap than the card's default.
Currently, any use of the *--setpoweroverdrive* functionality in rocm-smi prints an out-of-spec warning to the screen and requires the
user to agree that using this functionality potentially voids their warranty. However, this warning should only be printed when users are
trying to set the power cap to higher than the card's default, which requires the OverDrive driver functionality to be enabled.
For example:
The default power cap is 225.0W before any changes.
```
### Updated HIP 'Include' Directories
\[atitest\@rhel85 smi\]\$ ./rocm_smi.py --resetpoweroverdrive
======================= ROCm System Management Interface =======================
In the ROCm4.2 release, HIP *include* header directories for platforms are updated as follows:
========================== Reset GPU Power OverDrive ===========================
* *amd_detail/* - includes source header details for the amd platform implementation. In previous releases, the "hcc_detail" directory was defined, and it it is now deprecated.
GPU\[0\] : Successfully reset Power OverDrive to: 225W
============================ End of ROCm SMI Log ============================
* *nvidia_detail/* - includes source header details for the nvidia platform implementation. In previous releases, the "nvcc_detail" directory was defined, and it is now deprecated.
Now, after using --setpoweroverdrive to lower the power cap to 123
watts:
\[atitest\@rhel85 smi\]\$ ./rocm_smi.py --setpoweroverdrive 123
======================= ROCm System Management Interface =======================
=========================== Set GPU Power OverDrive ============================
GPU\[0\] : Successfully set power to: 123W
======================= End of ROCm SMI Log ==============================
Setting a power cap lower than the default of 225.0W (in this case,
123W) does not give a warning.
To verify that the power is set to the correct value:
\[atitest\@rhel85 smi\]\$ ./rocm_smi.py --showmaxpower
======================= ROCm System Management Interface =======================
======================== Power Cap ===================================
GPU\[0\] : Max Graphics Package Power (W): 123.0
========================End of ROCm SMI Log ==============================
```
### HIP Stream Memory Operations
## OpenMP Enhancements
The ROCm v4.2 extends support to Stream Memory Operations to enable direct synchronization between Network Nodes and GPU. The following new APIs are added:
* hipStreamWaitValue32
* hipStreamWaitValue64
* hipStreamWriteValue32
* hipStreamWriteValue64
For more details, see the HIP API guide at
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_HIP_API_Guide_4.2.pdf
### HIP Events in Kernel Dispatch
HIP events in kernel dispatch using *hipExtLaunchKernelGGL/hipExtLaunchKernel* and passed in the API are not explicitly recorded and should only be used to get elapsed time for that specific launch.
Events used across multiple dispatches, for example, start and stop events from different *hipExtLaunchKernelGGL/hipExtLaunchKernel* calls, are treated as invalid unrecorded events. In such scenarios, HIP will display the error *"hipErrorInvalidHandle"* from *hipEventElapsedTime*.
For more details, refer to the HIP API Guide at
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_HIP_API_Guide_4.2.pdf
### Changed Environment Variables for HIP
In the ROCm v3.5 release, the Heterogeneous Compute Compiler (HCC) compiler was deprecated, and the HIP-Clang compiler was introduced for compiling Heterogeneous-Compute Interface for Portability (HIP) programs. In addition, the HIP runtime API was implemented on top of Radeon Open Compute Common Language Runtime (ROCclr). ROCclr is an abstraction layer that provides the ability to interact with different runtime backends such as ROCr.
While the HIP_PLATFORM=hcc environment variable was functional in subsequent releases, in the ROCm v4.1 release, the following environment variables were changed:
* *HIP_PLATFORM=hcc to HIP_PLATFORM=amd*
* *HIP_PLATFORM=nvcc to HIP_PLATFORM=nvidia*
Therefore, any applications continuing to use the HIP_PLATFORM=hcc variable will fail. You must update the environment variables to reflect the changes as mentioned above.
## ROCm Data Center Tool
### RAS Integration
The ROCm Data Center (RDC) Tool is enhanced with the Reliability, Accessibility, and Serviceability (RAS) plugin.
For more information about RAS integration and installation, refer to the ROCm Data Center Tool User guide at:
https://github.com/RadeonOpenCompute/ROCm/blob/master/AMD_ROCm_DataCenter_Tool_User_Guide_v4.2.pdf
## ROCm Math and Communication Libraries
### rocBLAS
Enhancements and fixes:
* Added option to install script to build only rocBLAS clients with a pre-built rocBLAS library
* Supported gemm ext for unpacked int8 input layout on gfx908 GPUs
* Added new flags rocblas_gemm_flags::rocblas_gemm_flags_pack_int8x4 to specify if using the packed layout
* Set the rocblas_gemm_flags_pack_int8x4 when using packed int8x;, this should be always set on GPUs before gfx908
* For gfx908 GPUs, unpacked int8 is supported. Setting of this flag is no longer required
* Notice the default flags 0 uses unpacked int8 and changes the behaviour of int8 gemm from ROCm 4.1.0
* Added a query function rocblas_query_int8_layout_flag to get the preferable layout of int8 for gemm by device
For more information, refer to
https://rocblas.readthedocs.io/en/master/
### rocRAND
* Performance fixes
The ROCm installation includes an LLVM-based implementation, which fully
supports OpenMP 4.5 standard and a subset of the OpenMP 5.0 standard.
Fortran and C/C++ compilers and corresponding runtime libraries are
included. Along with host APIs, the OpenMP compilers support offloading
code and data onto GPU devices.
For more information, refer to
https://rocrand.readthedocs.io/en/latest/
<https://rocmdocs.amd.com/en/latest/Programming_Guides/openmp_support.html>
## ROCm Math and Communication Libraries
### rocSOLVER
In this release, ROCm Math and Communication Libraries consists of the
following enhancements and fixes:
Support for:
| Library | Changes |
| --- | --- |
| rocBLAS | **Optimizations** <ul><li>Improved performance of non-batched and batched syr for all sizes and data types</li><li>Improved performance of non-batched and batched hemv for all sizes and data types</li><li>Improved performance of non-batched and batched symv for all sizes and data types</li><li>Improved memory utilization in rocblas-bench, rocblas-test gemm functions, increasing possible runtime sizes.</li></ul>**Changes** <ul><li>Update from C++14 to C++17.</li> <li>Packaging split into a runtime package (called rocblas) and a development package (called rocblas-dev for .deb packages, and rocblas-devel for .rpm packages). The development package depends on runtime. The runtime package suggests the development package for all supported OSes except CentOS 7 to aid in the transition. The 'suggest' feature in packaging is introduced as a deprecated feature and will be removed in a future ROCm release.</li></ul> **Fixed**<ul><li>For function geam avoid overflow in offset calculation.</li> <li> For function syr avoid overflow in offset calculation.</li> <li>For function gemv (Transpose-case) avoid overflow in offset calculation.</li> <li>For functions ssyrk and dsyrk, allow conjugate-transpose case to match legacy BLAS. Behavior is the same as the transpose case.</li></ul> |
| hipBLAS| **Added**<ul><li>More support for hipblas-bench</li></ul>**Fixed**<ul><li>Avoid large offset overflow for gemv and hemv in hipblas-test</li></ul>**Changed**<ul><li>Packaging split into a runtime package called hipblas and a development package called hipblas-devel. The development package depends on runtime. The runtime package suggests the development package for all supported OSes except CentOS 7 to aid in the transition. The 'suggests' feature in packaging is a transitional feature and will be removed in a future rocm release.</li></ul> |
| rocFFT | **Optimizations**<ul><li>Optimized SBCC kernels of length 52, 60, 72, 80, 84, 96, 104, 108, 112, 160, 168, 208, 216, 224, 240 with new kernel generator.</li></ul>**Added**<ul><li>Split 2D device code into separate libraries.</li> </ul>**Changed**<ul><li>Packaging split into a runtime package called rocfft and a development package called rocfft-devel. The development package depends on runtime. The runtime package suggests the development package for all supported OSes except CentOS 7 to aid in the transition. The suggests feature in packaging is introduced as a deprecated feature and will be removed in a future rocm release.</li></ul>**Fixed**<ul><li>Fixed a few validation failures of even-length R2C inplace. 2D, 3D cubics sizes such as 100^2 (or ^3), 200^2 (or ^3), 256^2 (or ^3)...etc. We don't combine the three kernels (stockham-r2c-transpose). We only combine two kernels (r2c-transpose) instead.</li></ul> |
| hipFFT | **Changed** <ul><li>Packaging split into a runtime package called hipfft and a development package called hipfft-devel. The development package depends on runtime. The runtime package suggests the development package for all supported OSes except CentOS 7 to aid in the transition. The 'suggests' feature in packaging is a transitional feature and will be removed in a future rocm release.</li></ul> |
| rocSPARSE | **Added** <ul><li>Triangular solve for multiple right-hand sides using BSR format</li> <li>SpMV for BSRX format</li> <li>SpMM in CSR format enhanced to work with transposed A</li> <li>Matrix coloring for CSR matrices </li><li>Added batched tridiagonal solve (gtsv_strided_batch)</li></ul> **Improved** <ul><li>Fixed a bug with gemvi on Navi21 </li><li>Optimization for pivot based gtsv</li></ul> |
| hipSPARSE | **Added** <ul><li>Triangular solve for multiple right-hand sides using BSR format</li> <li>SpMV for BSRX format</li> <li>SpMM in CSR format enhanced to work with transposed A</li> <li>Matrix coloring for CSR matrices </li> <li>Added batched tridiagonal solve (gtsv_strided_batch)</li></ul> **Improved** <ul><li>Fixed a bug with gemvi on Navi21</li> <li>Optimization for pivot based gtsv</li></ul> |
| rocALUTION | **Changed** <ul><li>Packaging split into a runtime package called rocalution and a development package called rocalution-devel. The development package depends on runtime. The runtime package suggests the development package for all supported OSes except CentOS 7 to aid in the transition. The 'suggests' feature in packaging is a transitional feature and will be removed in a future rocm release.</li></ul> **Improved** <ul><li>(A)MG solving phase optimization</li></ul> |
| rocTHRUST | **Changed** <ul><li>Packaging changed to a development package (called rocthrust-dev for .deb packages, and rocthrust-devel for .rpm packages). As rocThrust is a header-only library, there is no runtime package. To aid in the transition, the development package sets the "provides" field to provide the package rocthrust, so that existing packages depending on rocthrust can continue to work. The 'provides' feature is a transitional feature and will be removed in a future ROCm release.</li></ul> |
| rocSOLVER | **Added** <ul><li>RQ factorization routines:</li><li>GERQ2, GERQF (with batched and strided_batchedversions)</li> <li>Linear solvers for general square systems:</li> <li>GESV (with batched and strided_batched versions)</li><li>Linear solvers for symmetric/hermitian positive definite systems:</li> <li>POTRS (with batched and strided_batched versions)</li> <li>POSV (with batched and strided_batched versions) </li> <li>Inverse of symmetric/hermitian positive definite matrices:</li><li>POTRI (with batched and strided_batched versions)</li> <li>General matrix inversion without pivoting: </li> <li>GETRI_NPVT (with batched and strided_batched versions)</li> <li>GETRI_NPVT_OUTOFPLACE (with batched and strided_batched versions)</li></ul>**Optimized**<ul><li>Improved performance of LU factorization (especially for large matrix sizes)</li> <li>Changed</li> <li>Raised reference LAPACK version used for rocSOLVER test and benchmark clients to v3.9.1</li> <li>Minor CMake improvements for users building from source without install.sh:</li> <li>Removed fmt::fmt from rocsolver\'s public usage requirements</li> <li>Enabled small-size optimizations by default </li> <li>Split packaging into a runtime package ('rocsolver') and a development package ('rocsolver-devel'). The development package depends on the runtime package. To aid in the transition, the runtime package suggests the development package (except on CentOS 7). This use of the 'suggests feature' is transitional and will be removed in a future ROCm release.</li></ul> **Fixed** <ul><li>Use of the GCC / Clang __attribute__((deprecated(...))) extension is now guarded by compiler detection macros. |
| hipSOLVER | The following functions were added in this release:<ul><li>gesv</li><ul><li>hipsolverSSgesv_bufferSize, hipsolverDDgesv_bufferSize, hipsolverCCgesv_bufferSize, hipsolverZZgesv_bufferSize</li><li>hipsolverSSgesv, hipsolverDDgesv, hipsolverCCgesv, hipsolverZZgesv</li></ul><li>potrs</li><ul><li>hipsolverSpotrs_bufferSize, hipsolverDpotrs_bufferSize, hipsolverCpotrs_bufferSize, hipsolverZpotrs_bufferSize</li><li>hipsolverSpotrs, hipsolverDpotrs, hipsolverCpotrs, hipsolverZpotrs</li></ul><li>potrsBatched</li><ul><li>hipsolverSpotrsBatched_bufferSize, hipsolverDpotrsBatched_bufferSize, hipsolverCpotrsBatched_bufferSize, hipsolverZpotrsBatched_bufferSize</li><li>hipsolverSpotrsBatched, hipsolverDpotrsBatched, hipsolverCpotrsBatched, hipsolverZpotrsBatched</li></ul><li>potri</li><ul><li>hipsolverSpotri_bufferSize, hipsolverDpotri_bufferSize, hipsolverCpotri_bufferSize, hipsolverZpotri_bufferSize</li><li>hipsolverSpotri, hipsolverDpotri, hipsolverCpotri, hipsolverZpotri</li></ul></ul></li></ul> |
| RCCL | **Added** <ul><li>Compatibility with NCCL 2.9.9 </li></ul>**Changed** <ul><li>Packaging split into a runtime package called rccl and a development package called rccl-devel. The development package depends on runtime. The runtime package suggests the development package for all supported OSes except CentOS 7 to aid in the transition. The 'suggests' feature in packaging is a tranistional feature and will be removed in a future rocm release.</li></ul> |
| hipCUB | **Changed** <ul><li>Packaging changed to a development package (called hipcub-dev for .deb packages, and hipcub-devel for .rpm packages). As hipCUB is a header-only library, there is no runtime package. To aid in the transition, the development package sets the "provides" field to provide the package hipcub, so that existing packages depending on hipcub can continue to work. This provides feature is introduced as a deprecated feature and will be removed in a future ROCm release.</li></ul> |
| rocPRIM| **Added** <ul><li>bfloat16 support added.</li></ul> **Changed** <ul><li>Packaging split into a runtime package called rocprim and a development package called rocprim-devel. The development package depends on runtime. The runtime package suggests the development package for all supported OSes except CentOS 7 to aid in the transition. The suggests feature in packaging is introduced as a deprecated feature and will be removed in a future rocm release.</li> <li>As rocPRIM is a header-only library, the runtime package is an empty placeholder used to aid in the transition. This package is also a deprecated feature and will be removed in a future rocm release.</li></ul> **Deprecated** <ul><li>The warp_size() function is now deprecated; please switch to host_warp_size() and device_warp_size() for host and device references respectively.</li></ul> |
| rocRAND| **Changed** <ul><li>Packaging split into a runtime package called rocrand and a development package called rocrand-devel. The development package depends on runtime. The runtime package suggests the development package for all supported OSes except CentOS 7 to aid in the transition. The suggests feature in packaging is introduced as a deprecated feature and will be removed in a future rocm release.</li></ul> **Fixed** <ul><li>Fix for mrg_uniform_distribution_double generating incorrect range of values</li> <li>Fix for order of state calls for log_normal, normal, and uniform</li></ul> **Known issues** <ul><li>kernel_xorwow test is failing for certain GPU architectures.</li></ul> |
* Multi-level logging functionality
For more information about ROCm Libraries, refer to the documentation at
* Implementation of the Thin-SVD algorithm
<https://rocmdocs.amd.com/en/latest/ROCm_Libraries/ROCm_Libraries.html>
* Reductions of generalized symmetric- and hermitian-definite eigenproblems:
* SYGS2, SYGST (with batched and strided_batched versions)
* HEGS2, HEGST (with batched and strided_batched versions)
* Symmetric and hermitian matrix eigensolvers:
* SYEV (with batched and strided_batched versions)
* HEEV (with batched and strided_batched versions)
* Generalized symmetric- and hermitian-definite eigensolvers:
* SYGV (with batched and strided_batched versions)
* HEGV (with batched and strided_batched versions)
For more information, refer to
https://rocsolver.readthedocs.io/en/latest/
### rocSPARSE
Enhancements:
* SpMM (CSR, COO)
* Code coverage analysis
For more information, refer to
https://rocsparse.readthedocs.io/en/latest/usermanual.html#rocsparse-gebsrmv
### hipSPARSE
Enhancements:
* Generic API support, including SpMM (CSR, COO)
* csru2csr, csr2csru
For more information, refer to
https://rocsparse.readthedocs.io/en/latest/usermanual.html#types
# Fixed Defects
## Performance Impact for LDS-BOUND Kernels
The following issue is fixed in the ROCm v4.2 release.
The compiler in ROCm v4.1 generates LDS load and stores instructions that incorrectly assume equal performance between aligned and misaligned accesses. While this does not impact code correctness, it may result in sub-optimal performance.
# Known Issues
# Known Issues in This Release
The following are the known issues in this release.
## Upgrade to AMD ROCm v4.2 Not Supported
## clinfo and rocminfo Do Not Display Marketing Name
An upgrade from previous releases to AMD ROCm v4.2 is not supported. Complete uninstallation of previous ROCm versions is required before installing a new version of ROCm.
clinfo and rocminfo display a blank field for Marketing Name.
The hip-base package has a dependency on Perl modules that some operating systems may not have in their default package repositories. Use the following commands to add repositories that have the required Perl packages:
This is due to a missing package that is not yet available from ROCm. This package will be distributed in future ROCm releases.
## Compiler Support for Function Pointers and Virtual Functions
A known issue in the compiler support for function pointers and virtual functions on the GPU may cause undefined behavior due to register
corruption. 
A temporary workaround is to compile the affected application with this option:
```
-mllvm -amdgpu-fixed-function-abi=1
```
**Note:** This is an internal compiler flag and may be removed without notice once the issue is addressed in a future release.
#### For SLES 15 SP2
## Debugger Process Exit May Cause ROCgdb Internal Error
sudo zypper addrepo
For more information, see
https://download.opensuse.org/repositories/devel:languages:perl/SLE_15/devel:languages:perl.repo
#### For CentOS8.3
sudo yum config-manager --set-enabled powertools
#### For RHEL8.3
sudo subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
If the debugger process exits during debugging, ROCgdb may report internal errors. This issue occurs as it attempts to access the AMD GPU
state for the exited process. To recover, users must restart ROCgdb.
## Modulefile Fails to Install Automatically in ROCm Multi-Version Environment
As a workaround, users can set breakpoints to prevent the debugged process from exiting. For example, users can set breakpoints at the last
statement of the main function and in the abort() and exit() functions. This temporary solution allows the application to be re-run without
restarting ROCgdb.
The ROCm v4.2 release includes a preliminary implementation of environment modules to enable switching between multi versions of ROCm installation. The modulefile in */opt/rocm-4.2/lib/rocmmod* fails to install automatically in the ROCm multi-version environment.
This issue is currently under investigation and will be fixed in a future release.
This is a known limitation for environment modules in ROCm, and the issue is under investigation at this time.
For more information, refer to the ROCgdb User Guide at,
**Workaround**
https://github.com/RadeonOpenCompute/ROCm/blob/master/ROCDebugger_User_Guide.pdf
Ensure you install the modulefile in */opt/rocm-4.2/lib/rocmmod* manually in a multi-version installation environment.
## Cache Issues with ROCProfiler
For general information about modules, see
http://modules.sourceforge.net/
When the same kernel is launched back-to-back multiple times on a GPU, a cache flush is executed each time the kernel finishes when profiler data is collected. The cache flush is inserted by ROCprofiler for each kernel. This prevents kernel from being cached, instead it is being read each time it is launched. As a result the cache hit rate from rocprofiler is reported as 0% or very low.
## Issue with Input/Output Types for Scan Algorithms in rocThrust
This issue is under investigation and will be fixed in a future release.
As rocThrust is updated to match CUDA Thrust 1.10, the different input/output types for scan algorithms in rocThrust/CUDA Thrust are no longer officially supported. In this situation, the current C++ standard does not specify the intermediate accumulator type leading to potentially incorrect results and ill-defined behavior.
## Stability Issue on LAMMPS-KOKKOS Applications
As a workaround, users can:
On mGPU machines, lammps-kokkos applications experience a stability issue (AMD Instinct MI100™).
* Use the same types for input and output
As a workaround, perform a Translation LookAside Buffer (TLB) flush.
Or
* For exclusive_scan, explicitly specify an *InitialValueType* in the last argument
Or
* For inclusive_scan, which does not have an initial value argument, use a transform_iterator to explicitly cast the input iterators to match the outputs value_type
## Precision Issue in AMD RADEON™ PRO VII and AMD RADEON™ VII
In AMD Radeon™ Pro VII AND AMD Radeon™ VII, a precision issue can occur when using the Tensorflow XLA path.
This issue is currently under investigation.
The issue is under active investigation and will be resolved in a future release.
# Deprecations
This section describes deprecations and removals in AMD ROCm.
## AMD Instinct MI25 End of Life
## Compiler Generated Code Object Version 2 Deprecation
ROCm release v4.5 is the final release to support AMD Instinct MI25. AMD Instinct MI25 has reached End of Life (EOL). ROCm 4.5 represents the
last certified release for software and driver support. AMD will continue to provide technical support and issue resolution for AMD
Instinct MI25 on ROCm v4.5 for a period of 12 months from the software GA date. 
## Planned Deprecation for Code Object Versions 2 and 3
With the ROCm v4.5 release, the generation of code object versions 2 and 3 is being deprecated and may be removed in a future release. This deprecation notice does not impact support for the execution of AMD GPU code object versions.
The -mcode-object-version Clang option can be used to instruct the compiler to generate a specific AMD GPU code object version. In ROCm v4.5, the compiler can generate AMD GPU code object version 2, 3, and 4, with version 4 being the default if not specified.
Compiler-generated code object version 2 is no longer supported and has been completely removed. Support for loading code object version 2 is also deprecated with no announced removal release.
# Deploying ROCm
@@ -476,7 +556,7 @@ https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html
For an updated version of the software stack for AMD GPU, see
https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html#software-stack-for-amd-gpu
https://rocmdocs.amd.com/en/latest/Installation_Guide/Software-Stack-for-AMD-GPU.html
@@ -613,15 +693,15 @@ For users that have the option of using either AMD's or the upstreamed driver, t
# Disclaimer
AMD®, the AMD Arrow logo, AMD Instinct™, Radeon™, ROCm® and combinations thereof are trademarks of Advanced Micro Devices, Inc.
The information presented in this document is for informational purposes only and may contain technical inaccuracies, omissions, and typographical errors. The information contained herein is subject to change and may be rendered inaccurate for many reasons, including but not limited to product and roadmap changes, component and motherboard versionchanges, new model and/or product releases, product differences between differing manufacturers, software changes, BIOS flashes, firmware upgrades, or the like. Any computer system has risks of security vulnerabilities that cannot be completely prevented or mitigated.AMD assumes no obligation to update or otherwise correct or revise this information. However, AMD reserves the right to revise this information and to make changes from time to time to the content hereof without obligation of AMD to notify any person of such revisions or changes.THIS INFORMATION IS PROVIDED AS IS.” AMD MAKES NO REPRESENTATIONS OR WARRANTIES WITH RESPECT TO THE CONTENTS HEREOF AND ASSUMES NO RESPONSIBILITY FOR ANY INACCURACIES, ERRORS, OR OMISSIONS THAT MAY APPEAR IN THIS INFORMATION. AMD SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR ANY PARTICULAR PURPOSE. IN NO EVENT WILL AMD BE LIABLE TO ANY PERSON FOR ANY RELIANCE, DIRECT, INDIRECT, SPECIAL, OR OTHER CONSEQUENTIAL DAMAGES ARISING FROM THE USE OF ANY INFORMATION CONTAINED HEREIN, EVEN IF AMD IS EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.AMD, the AMD Arrow logo,[insert all other AMD trademarks used in the material here perAMD Trademarks]and combinations thereof are trademarks of Advanced Micro Devices, Inc.Other product names used in this publication are for identification purposes only and may be trademarks of their respective companies. [Insert any third party trademark attribution here per AMD'sThird Party Trademark List.]
©[2021]Advanced Micro Devices, Inc.All rights reserved.
Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.
Third-party Disclaimer
Third-party content is licensed to you directly by the third party that owns the content and is not licensed to you by AMD. ALL LINKED THIRD-PARTY CONTENT IS PROVIDED “AS IS” WITHOUT A WARRANTY OF ANY KIND. USE OF SUCH THIRD-PARTY CONTENT IS DONE AT YOUR SOLE DISCRETION AND UNDER NO CIRCUMSTANCES WILL AMD BE LIABLE TO YOU FOR ANY THIRD-PARTY CONTENT. YOU ASSUME ALL RISK AND ARE SOLELY RESPONSIBLE FOR ANY DAMAGES THAT MAY ARISE FROM YOUR USE OF THIRD-PARTY CONTENT.
PCIe® is a registered trademark of PCI-SIG Corporation. Other product names used in this publication are for identification purposes only and may be trademarks of their respective companies.
Google® is a registered trademark of Google LLC.
Ubuntu and the Ubuntu logo are registered trademarks of Canonical Ltd.
## Disclaimer
Third-party content is licensed to you directly by the third party that owns the content and is not licensed to you by AMD. ALL LINKED THIRD-PARTY CONTENT IS PROVIDED “AS IS” WITHOUT A WARRANTY OF ANY KIND. USE OF SUCH THIRD-PARTY CONTENT IS DONE AT YOUR SOLE DISCRETION AND UNDER NO CIRCUMSTANCES WILL AMD BE LIABLE TO YOU FOR ANY THIRD-PARTY CONTENT. YOU ASSUME ALL RISK AND ARE SOLELY RESPONSIBLE FOR ANY DAMAGES THAT MAY ARISE FROM YOUR USE OF THIRD-PARTY CONTENT.
Other product names used in this publication are for identification purposes only and may be trademarks of their respective companies.

BIN
ROCDebugger_API_Guide.pdf Normal file

Binary file not shown.

BIN
ROCDebugger_User_Guide.pdf Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

BIN
ROCm_SMI_Manual_4.5.pdf Normal file

Binary file not shown.

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<manifest>
<remote name="roc-github"
fetch="http://github.com/RadeonOpenCompute/" />
fetch="https://github.com/RadeonOpenCompute/" />
<remote name="rocm-devtools"
fetch="https://github.com/ROCm-Developer-Tools/" />
<remote name="rocm-swplat"
@@ -12,7 +12,7 @@ fetch="https://github.com/GPUOpen-ProfessionalCompute-Libraries/" />
fetch="https://github.com/GPUOpen-Tools/" />
<remote name="KhronosGroup"
fetch="https://github.com/KhronosGroup/" />
<default revision="refs/tags/rocm-4.2.0"
<default revision="refs/tags/rocm-4.5.0"
remote="roc-github"
sync-c="true"
sync-j="4" />
@@ -20,7 +20,6 @@ fetch="https://github.com/KhronosGroup/" />
<project name="ROCK-Kernel-Driver" />
<project name="ROCT-Thunk-Interface" />
<project name="ROCR-Runtime" />
<project name="ROC-smi" revision="refs/tags/rocm-4.1.0" />
<project name="rocm_smi_lib" />
<project name="rocm-cmake" />
<project name="rocminfo" />
@@ -31,6 +30,7 @@ fetch="https://github.com/KhronosGroup/" />
<project name="clang-ocl" />
<!--HIP Projects-->
<project name="HIP" remote="rocm-devtools" />
<project name="hipamd" remote="rocm-devtools" />
<project name="HIP-Examples" remote="rocm-devtools" />
<project name="ROCclr" remote="rocm-devtools" />
<project name="HIPIFY" remote="rocm-devtools" />
@@ -47,7 +47,7 @@ fetch="https://github.com/KhronosGroup/" />
<project name="ROCgdb" remote="rocm-devtools" />
<project name="ROCdbgapi" remote="rocm-devtools" />
<!-- ROCm Libraries -->
<project name="rdc" remote="roc-github" />
<project name="rdc" />
<project name="rocBLAS" remote="rocm-swplat" />
<project name="Tensile" remote="rocm-swplat" />
<project name="hipBLAS" remote="rocm-swplat" />
@@ -56,10 +56,12 @@ fetch="https://github.com/KhronosGroup/" />
<project name="rocRAND" remote="rocm-swplat" />
<project name="rocSPARSE" remote="rocm-swplat" />
<project name="rocSOLVER" remote="rocm-swplat" />
<project name="hipSOLVER" remote="rocm-swplat" />
<project name="hipSPARSE" remote="rocm-swplat" />
<project name="rocALUTION" remote="rocm-swplat" />
<project name="MIOpenGEMM" remote="rocm-swplat" />
<project name="MIOpen" remote="rocm-swplat" />
<project name="MIOpenTensile" remote="rocm-swplat" />
<project name="rccl" remote="rocm-swplat" />
<project name="MIVisionX" remote="gpuopen-libs" />
<project name="rocThrust" remote="rocm-swplat" />

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 221 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 58 KiB

1
images/test.rst Normal file
View File

@@ -0,0 +1 @@