amd/blis
1
0
Fork 0
mirror of https://github.com/amd/blis.git synced 2026-04-19 23:28:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

CMake: Adding targets and aliases so that blis works with fetch content (#179)

Browse Source 
* Adding targets and aliases so that blis works with fetch content

* Using PUBLIC instead of INTERFACE

* Using BLIS instead of blis and adding BLAS in the targets

* Fixing installation paths do be the same as before

* Adding documentation for FetchContent()
This commit is contained in:
Vlachopoulou, Eleni
2025-12-10 13:02:09 +00:00
committed by GitHub
parent 1d80d5fee4
commit 504ac9d8a2
2 changed files with 159 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
docs/CMakeBuildSystem.md
View File

@@ -12,6 +12,7 @@
* **[Adding configurations](CMakeBuildSystem.md#adding-configurations)**
* **[Some examples](CMakeBuildSystem.md#some-examples)**
* **[Building Benchmark suite](CMakeBuildSystem.md#building-benchmark-suite)**
* **[Consuming BLIS via FetchContent](CMakeBuildSystem.md#consuming-via-FetchContent)**
* **[Final notes](CMakeBuildSystem.md#final-notes)**
## Introduction
@@ -279,6 +280,48 @@ Run any of the bench executable using
./<executable> ../../bench/inputfile.txt outfile.txt
```
## Conclusion
## Consuming BLIS via FetchContent
CMake's `FetchContent` module allows you to automatically download and build BLIS as part of your project's build process.
This approach is useful when you want to integrate BLIS directly into your CMake project without requiring a separate installation step.
FetchContent provides a convenient way to:
- Automatically download BLIS from a Git repository during configuration
- Build BLIS as a dependency of your project
- Link against BLIS using CMake targets (`AOCL::BLIS_static`, `AOCL::BLIS_shared`, `AOCL::BLAS_static`, `AOCL::BLAS_shared`)
- Avoid managing external dependencies manually
### Basic Usage
To use BLIS via FetchContent, include the following in your `CMakeLists.txt`:
```cmake
# Include the FetchContent module
include(FetchContent)
# Optionally set BLIS CMake variables
set(BLIS_CONFIG_FAMILY "amdzen" CACHE STRING "" FORCE)
set(BLIS_ENABLE_CBLAS ON CACHE BOOL "Enable CBLAS interface")
# Declare BLIS as a dependency
FetchContent_Declare(
libaoclblas
GIT_REPOSITORY https://github.com/amd/blis.git
GIT_TAG dev # or specify a release tag
GIT_SHALLOW 1 # Optional: fetch only the latest commit for faster download
)
# Download and make BLIS available
FetchContent_MakeAvailable(libaoclblas)
# Example 1: Static BLIS library
add_executable(example_static src/example.cpp)
target_link_libraries(example_static PRIVATE AOCL::BLIS_static) # or AOCL::BLAS_static
# Example 2: Shared BLIS library
add_executable(example_shared src/example.cpp)
target_link_libraries(example_shared PRIVATE AOCL::BLIS_shared) # or AOCL::BLAS_shared
```
## Final notes
The BLIS CMake system is developed and maintained by AMD. You can contact us on the email-id toolchainsupport@amd.com. You can also raise any issue/suggestion on the git-hub repository at https://github.com/amd/blis/issues.