SWDEV-469310 - Add more information in clr for static library support
Change-Id: I9a784a6b3935a771670b91cbc4f92f1e168a8165
[ROCm/clr commit: c0bc99e679]
This commit is contained in:
committed by
Julia Jiang
orang tua
7d021f8196
melakukan
11627840ee
+27
-10
@@ -1,6 +1,6 @@
|
|||||||
# AMD CLR - Compute Language Runtimes
|
# AMD CLR - Compute Language Runtimes
|
||||||
|
|
||||||
AMD Common Language Runtime contains source codes for AMD's compute languages runtimes: `HIP` and `OpenCL™`.
|
AMD CLR (Compute Language Runtime) contains source codes for AMD's compute languages runtimes: `HIP` and `OpenCL™`.
|
||||||
|
|
||||||
## Project Organisation
|
## Project Organisation
|
||||||
|
|
||||||
@@ -15,21 +15,36 @@ AMD Common Language Runtime contains source codes for AMD's compute languages ru
|
|||||||
Please refer to Quick Start Guide in [ROCm Docs](https://rocm.docs.amd.com/projects/install-on-linux/en/latest/tutorial/quick-start.html).
|
Please refer to Quick Start Guide in [ROCm Docs](https://rocm.docs.amd.com/projects/install-on-linux/en/latest/tutorial/quick-start.html).
|
||||||
|
|
||||||
Building clr requires `rocm-hip-libraries` meta package, which provides the pre-requisites for clr.
|
Building clr requires `rocm-hip-libraries` meta package, which provides the pre-requisites for clr.
|
||||||
|
If you need to build static clr library, `rocm-llvm-dev` package should be installed which has support for compilation of the static library.
|
||||||
|
|
||||||
### Linux
|
### Linux
|
||||||
|
|
||||||
- Clone this repository
|
- Clone this repository
|
||||||
- `cd clr && mkdir build && cd build`
|
```
|
||||||
- For HIP : `cmake .. -DCLR_BUILD_HIP=ON -DHIP_COMMON_DIR=$HIP_COMMON_DIR`
|
cd clr && mkdir build && cd build
|
||||||
- `HIP_COMMON_DIR` points to [HIP](https://github.com/ROCm/HIP)
|
```
|
||||||
- `HIPCC_BIN_DIR` points to [HIPCC](https://github.com/ROCm/HIPCC)'s bin folder. If not provided, it defaults to `/opt/rocm/bin`.
|
- For HIP:
|
||||||
- For OpenCL™ : `cmake .. -DCLR_BUILD_OCL=ON`
|
|
||||||
- `make` : to build
|
`cmake .. -DCLR_BUILD_HIP=ON -DHIP_COMMON_DIR=$HIP_COMMON_DIR`
|
||||||
- `make install` : to install
|
|
||||||
|
|
||||||
|
`HIP_COMMON_DIR` points to [HIP](https://github.com/ROCm/HIP)
|
||||||
|
|
||||||
|
- For OpenCL™:
|
||||||
|
|
||||||
|
`cmake .. -DCLR_BUILD_OCL=ON`
|
||||||
|
|
||||||
|
- Build and install
|
||||||
|
|
||||||
|
```
|
||||||
|
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.
|
Users can also build `OCL` and `HIP` at the same time by passing `-DCLR_BUILD_HIP=ON -DCLR_BUILD_OCL=ON` to configure command.
|
||||||
|
|
||||||
HIP/CLR can be built as a static library by passing `-DBUILD_SHARED_LIBS=OFF` during the CLR `cmake` step.
|
HIP/CLR can be built as a static library, users need to add more options in `cmake` command,
|
||||||
|
`-DBUILD_SHARED_LIBS=OFF` and `-DCMAKE_PREFIX_PATH="/opt/rocm/;/opt/rocm/llvm`.
|
||||||
|
|
||||||
For detail instructions, please refer to [how to build HIP](https://rocm.docs.amd.com/projects/HIP/en/latest/install/build.html)
|
For detail instructions, please refer to [how to build HIP](https://rocm.docs.amd.com/projects/HIP/en/latest/install/build.html)
|
||||||
|
|
||||||
@@ -39,7 +54,9 @@ For detail instructions, please refer to [how to build HIP](https://rocm.docs.am
|
|||||||
|
|
||||||
To run `hip-tests` please go to the repository and follow the steps.
|
To run `hip-tests` please go to the repository and follow the steps.
|
||||||
|
|
||||||
There used to be directed tests in [ROCm/HIP](https://github.com/ROCm/HIP) which are now removed in favor of `hip-tests` repository.
|
## Release notes
|
||||||
|
|
||||||
|
HIP provides release notes in [CLR change log](https://github.com/ROCm/clr/blob/develop/CHANGELOG.md), which has the records of changes in each release.
|
||||||
|
|
||||||
## Disclaimer
|
## Disclaimer
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user