12.1.1. Requirements - 12.1.1. Requirements - 6.0 English - 57404

AOCL User Guide (57404)

Document_ID
57404
Release_Date
2026-11-10
Version
6.0 English

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=znver6 support 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 highest znver target 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.cmake

    • CMake/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.