AOCL-LibM requires a 64-bit x86 (x86_64/AMD64) machine to build and run.
32-bit-only machines are not supported.
Software requirements for compilation:
The LIBM build system currently supports source code compilation using both SCons and CMake.
Note
AOCL-LibM no longer depends on AOCL-Utils. As CPU feature detection is handled by an internal module, there is no need to install or configure any external AOCL-Utils package.
Linux:
Operating System: Any modern Linux distribution (e.g., Ubuntu, RHEL, CentOS)
Compilers:
Compiler Version Requirements
The following table shows the minimum compiler versions required for each AMD Zen architecture:
Architecture
GCC
Clang
AOCC
Zen (znver1)
>= 9.2
>= 9.0
>= 3.0
Zen2 (znver2)
>= 9.2
>= 9.0
>= 3.0
Zen3 (znver3)
>= 10.0
>= 11.0
>= 3.0
Zen4 (znver4)
>= 12.0
>= 14.0
>= 4.0
Zen5 (znver5)
>= 14.0
>= 18.0
>= 5.0
Zen6 (znver6)
>= 16.1
>= 23.1*
>= 6.0
Note
* Upstream Clang added
-march=znver6support in the Clang 23 series (23.1.0). As AOCL-LibM 6.0 is tested and validated with Clang 9.0 - 21.1, Zen6-targeted builds with Clang are outside the validated matrix. When an older Clang is used, the build automatically selects the highestznvertarget that the compiler accepts.Tested and Validated Versions:
GCC: 9.2 - 16.2
Clang: 9.0 - 21.1
AOCC: 3.0 - 6.0
MSVC: Visual Studio 2022 (v17)
Note
For optimal Zen5 performance, we recommend using AOCC 5.0+ or GCC 14+. For optimal Zen6 performance, we recommend using AOCC 6.0+ or GCC 16.1+.
SCons Build: Python 3.6 or later (via Virtualenv) SCons version 3.1.1 or later
CMake Build: CMake v3.26 or later
Note
It is recommended to use GCC version 9.2 or later, as AMD architecture-specific compiler optimizations were introduced at different GCC versions:
AMD “Zen6” optimizations were added in GCC 16.1
AMD “Zen5” optimizations were added in GCC 14.1
AMD “Zen4” optimizations were added in GCC 12.3
AMD “Zen3” optimizations were added in GCC 10.3
AMD “Zen2” optimizations were introduced in GCC 9.2
Windows:
Operating System: Windows 10/11 or Windows Server 2019/2022
Compilers:
LLVM (clang-cl) v9.0 or later is the C/C++ compiler used on Windows (tested up to v21.1)
LLVM v18.0 or later for AMD “Zen5” support
LLVM v14.0 or later for AMD “Zen3”/”Zen4” support
LLVM v11.0 for AMD “Zen2” support
Build generators (CMake builds only):
Ninja generator (default), or
Visual Studio 17 2022 generator (MSBuild / “MSVC” generator) with the ClangCL toolset
Microsoft Visual Studio 2022 is required and provides both the Ninja and MSBuild generators. Building with the pure MSVC compiler (
cl.exe) is not supported; the ClangCL (clang-cl) toolset is used for compilation in all cases.SDK: Windows SDK Version 10.0.22621.0
SCons Build: Python 3.6 or later (via Virtualenv) SCons 4.4.0
CMake Build: CMake v3.26 or later Ninja (installed with MSVC)
Compiler Version Control (Linux and Windows):
The minimum and maximum supported versions of GCC, Clang, AOCC, and MSVC are specified in the following files:
SCons:
scripts/site_scons/alm/check.py
CMake:
CMake/Checkers/Clang.cmakeCMake/Checkers/Gcc.cmake
Note
The build will continue with a warning if the compiler version is below the minimum or exceeds the maximum supported version, allowing flexibility for testing with different compiler versions. However, functionality and performance are not guaranteed outside the documented supported version range.