Current ROCm Version: 2.10

• ROCm Binary Package Structure

The latest ROCm platform - ROCm 2.10

The latest supported version of the drivers, tools, libraries and source code for the ROCm platform have been released and are available from the following GitHub repositories:

• ROCm Core Components
  • ROCk Kernel Driver
  • ROCr Runtime
  • ROCt Thunk Interface
• ROCm Support Software
  • ROCm SMI
  • ROCm cmake
  • rocminfo
  • ROCm Bandwidth Test
• ROCm Development Tools
  • HCC compiler
  • HIP
  • ROCm Device Libraries
  • ROCm OpenCL, which is created from the following components:
    • ROCm OpenCL Runtime
    • ROCm OpenCL Driver
  • The ROCm OpenCL compiler, which is created from the following components:
    • ROCm LLVM OCL
    • ROCm LLVM HCC
    • ROCm Clang
    • ROCm lld OCL
    • ROCm lld HCC
    • ROCm Device Libraries
  • ROCM Clang-OCL Kernel Compiler
  • Asynchronous Task and Memory Interface (ATMI)
  • ROCr Debug Agent
  • ROCm Code Object Manager
  • ROC Profiler
  • ROC Tracer
  • Radeon Compute Profiler
  • Example Applications:
    • HCC Examples
    • HIP Examples
• ROCm Libraries
  • rocBLAS
  • hipBLAS
  • rocFFT
  • rocRAND
  • rocSPARSE
  • hipSPARSE
  • rocALUTION
  • MIOpenGEMM
  • MIOpen
  • rocThrust
  • ROCm SMI Lib
  • RCCL
  • MIVisionX
  • hipCUB

ROCm Binary Package Structure

ROCm is a collection of software ranging from drivers and runtimes to libraries and developer tools. In AMD's package distributions, these software projects are provided as a separate packages. This allows users to install only the packages they need, if they do not wish to install all of ROCm. These packages will install most of the ROCm software into /opt/rocm/ by default.

The packages for each of the major ROCm components are:

• ROCm Core Components
  • ROCk Kernel Driver: rock-dkms
  • ROCr Runtime: hsa-rocr-dev, hsa-ext-rocr-dev
  • ROCt Thunk Interface: hsakmt-roct, hsakmt-roct-dev
• ROCm Support Software
  • ROCm SMI: rocm-smi
  • ROCm cmake: rocm-cmake
  • rocminfo: rocminfo
  • ROCm Bandwidth Test: rocm_bandwidth_test
• ROCm Development Tools
  • HCC compiler: hcc
  • HIP: hip_base, hip_doc, hip_hcc, hip_samples
  • ROCm Device Libraries: rocm-device-libs
  • ROCm OpenCL: rocm-opencl, rocm-opencl-devel (on RHEL/CentOS), rocm-opencl-dev (on Ubuntu)
  • ROCM Clang-OCL Kernel Compiler: rocm-clang-ocl
  • Asynchronous Task and Memory Interface (ATMI): atmi
  • ROCr Debug Agent: rocr_debug_agent
  • ROCm Code Object Manager: comgr
  • ROC Profiler: rocprofiler-dev
  • ROC Tracer: roctracer-dev
  • Radeon Compute Profiler: rocm-profiler
• ROCm Libraries
  • rocALUTION: rocalution
  • rocBLAS: rocblas
  • hipBLAS: hipblas
  • hipCUB: hipCUB
  • rocFFT: rocfft
  • rocRAND: rocrand
  • rocSPARSE: rocsparse
  • hipSPARSE: hipsparse
  • ROCm SMI Lib: rocm_smi_lib64
  • rocThrust: rocThrust
  • MIOpen: MIOpen-HIP (for the HIP version), MIOpen-OpenCL (for the OpenCL version)
  • MIOpenGEMM: miopengemm
  • MIVisionX: mivisionx
  • RCCL: rccl

To make it easier to install ROCm, the AMD binary repositories provide a number of meta-packages that will automatically install multiple other packages. For example, rocm-dkms is the primary meta-package that is used to install most of the base technology needed for ROCm to operate. It will install the rock-dkms kernel driver, and another meta-package (rocm-dev) which installs most of the user-land ROCm core components, support software, and development tools.

The rocm-utils meta-package will install useful utilities that, while not required for ROCm to operate, may still be beneficial to have. Finally, the rocm-libs meta-package will install some (but not all) of the libraries that are part of ROCm.

The chain of software installed by these meta-packages is illustrated below

  rocm-dkms
    |--rock-dkms
    \--rocm-dev
       |--hsa-rocr-dev
       |--hsa-ext-rocr-dev
       |--hsakmt-roct
       |--hsakmt-roct-dev
       |--rocm-cmake
       |--rocm-device-libs
       |--hcc
       |--hip_base
       |--hip_doc
       |--hip_hcc
       |--hip_samples
       |--rocm-smi
       |--hsa-amd-aqlprofile
       |--comgr
       |--rocr_debug_agent
       \--rocm-utils
          |--rocminfo
          \--rocm-clang-ocl # This will cause OpenCL to be installed

  rocm-libs
    |--rocalution
    |--hipblas
    |--rocblas
    |--rocfft
    |--rocrand
    |--hipsparse
    \--rocsparse

These meta-packages are not required but may be useful to make it easier to install ROCm on most systems.

Note:Some users may want to skip certain packages. For instance, a user that wants to use the upstream kernel drivers (rather than those supplied by AMD) may want to skip the rocm-dkms and rock-dkms packages, and instead directly install rocm-dev.

Similarly, a user that only wants to install OpenCL support instead of HCC and HIP may want to skip the rocm-dkms and rocm-dev packages. Instead, they could directly install rock-dkms, rocm-opencl, and rocm-opencl-dev and their dependencies.

Features and enhancements introduced in previous versions of ROCm can be found in version_history.md