The following table lists other key AOCL-BLAS build options and the CMake and configure options to control them, with the default setting in bold (where appropriate):
Build characteristic |
CMake options
————————————
configure options
|
Usage |
|---|---|---|
Serial or multithreaded (OpenMP) |
-DENABLE_THREADING=openmp
-DENABLE_THREADING=no
————————————
--enable-threading=openmp
--enable-threading=no
|
Enabling multithreading with OpenMP will add a link time dependency on the compiler’s OpenMP runtime library.
|
Enable/Disable dynamic thread scaling |
-DENABLE_AOCL_DYNAMIC=ON
-DENABLE_AOCL_DYNAMIC=OFF
————————————
–enable-aocl-dynamic
–disable-aocl-dynamic
|
In multithreaded builds with AOCL dynamic enabled, AOCL-BLAS may reduce the number of threads used within each API call from that requested where the problem parameters are small.
|
Installation directory |
-DCMAKE_INSTALL_PREFIX=</desired/location/>
Default location: /usr/local/
————————————
--prefix=</desired/location/>
Default location: /usr/local/
|
Specifies target directory for installing AOCL-BLAS. Installation will include
lib, include and share subdirectories.On Linux these will be placed inside a directory
lp64 or ilp64 as appropriate. |
Enable LPGEMM add-on |
-DENABLE_ADDON=”aocl_gemm”
Default: disabled
————————————
-a aocl_gemm
Default: disabled
|
LPGEMM provides a range of BF16 and INT8 GEMM operations with many supported pre-/post-ops, targeted at AI applications. See LPGEMM in AOCL-BLAS for details.
|
Change dynamic dispatch environment variables |
-DRENAME_BLIS_ARCH_TYPE=<user-defined-name>
(Default name
BLIS_ARCH_TYPE)-DRENAME_BLIS_MODEL_TYPE=<user-defined-name>
(Default name
BLIS_MODEL_TYPE)————————————
--rename-blis-arch-type=
(Default name
BLIS_ARCH_TYPE)--rename-blis-model-type=
(Default name
BLIS_MODEL_TYPE) |
If dynamic dispatch is enabled in the configuration (e.g. amdzen), the default runtime choice of code path based on the hardware can be overridden by environment variables.
These options allow the environment variables
BLIS_ARCH_TYPE and BLIS_MODEL_TYPE to be renamed. See Dynamic Dispatch for more details. |
Disable dynamic dispatch environment variables |
-DISABLE_BLIS_ARCH_TYPE=ON
-DISABLE_BLIS_ARCH_TYPE=OFF
————————————
--enable-blis-arch-type
--disable-blis-arch-type
|
If dynamic dispatch is enabled in the configuration (e.g. amdzen), alternatively use of these environment variables
(
BLIS_ARCH_TYPE, BLIS_MODEL_TYPE and AOCL_ENABLE_INSTRUCTIONS) can be disabled. See Dynamic Dispatch for more details. |