This page contains proposed changes for a future release of ROCm. Read the latest Linux release of ROCm documentation for your production environments.

AMD Common Language Runtimes (CLR)

AMD Common Language Runtimes (CLR)#

CLR contains source codes for AMD’s compute languages runtimes: HIP and OpenCL™. CLR is the part of HIP runtime which is supported on the AMD ROCm platform, it provides a header and runtime library built on top of HIP-Clang compiler. For developers and users, CLR implements HIP runtime APIs including streams, events, and memory APIs, which is a object library that is linked with the application. The source codes for all headers and the library implementation are available on GitHub in the clr repository.

Project Organisation#

CLR includes the following source code,

  • hipamd - contains implementation of HIP language on the AMD platform. It is hosted at clr/hipamd.

  • opencl - contains implementation of OpenCL™ on AMD platform. It is hosted at clr/opencl.

  • rocclr - contains common runtime used in HIP and OpenCL™. This is hosted at clr/rocclr.

How to build/install#

Prerequisites#

Please refer to Quick Start Guide in ROCm Docs.

Building CLR requires rocm-hip-libraries meta package, which provides the pre-requisites for CLR.

Linux#

  • Clone this repository

cd clr && mkdir build && cd build
  • For HIP

cmake .. -DCLR_BUILD_HIP=ON -DHIP_COMMON_DIR=$HIP_COMMON_DIR

``HIP_COMMON_DIR`` points to `HIP <https://github.com/ROCm/HIP>`_.
  • For OpenCL™

cmake .. -DCLR_BUILD_OCL=ON
make
make install

Users can also build OCL and HIP at the same time by passing -DCLR_BUILD_HIP=ON -DCLR_BUILD_OCL=ON to configure command.

For detail instructions, please refer to build HIP.

Test#

hip-tests is a separate repository hosted at hip-tests.

To run hip-tests please go to the repository and follow the steps.

Release notes#

HIP provides release notes in CLR change log, which has records of changes in each release.