18.7.3. External Dependencies - 5.2 English - 57404

AOCL User Guide (57404)
Document ID
57404
Release Date
2025-12-29
Version
5.2 English

Required Dependencies (Build Time):

Dependency

Version

Purpose

CMake

>= 3.26

Build system

C/C++ Compiler

See below

Compilation

Supported Compilers:

Compiler

Minimum Version

Notes

GCC

8.5+

Tested and validated

Clang

12+

Tested and validated

AOCC

4.2+

AMD Optimizing Compiler

Standard Libraries (Runtime):

Library

When Required

Notes

libstdc++ or libc++

Always

C++ standard library

libpthread

au_core module

Implicit in glibc >= 2.34

Optional Dependencies:

Dependency

Purpose

Required For

Python

Version 3.9-3.13

Running tests (Cpuid tests)

QEMU

qemu-user package

Running tests on Linux

Doxygen

Documentation

Building API docs (AU_BUILD_DOCS=ON)

Sphinx

Documentation

Building user guide

GoogleTest

Testing

Building tests (AU_BUILD_TESTS=ON) - auto-fetched

Platform-Specific Notes:

Linux:

  • May need explicit -lstdc++ or -lpthread on older distributions

  • glibc < 2.34 requires explicit pthread linking

  • QEMU required for testing

Windows:

  • Requires Visual Studio 2022 with Clang-cl toolset

  • MultiThreaded runtime library

  • Tests disabled (QEMU unavailable)

Runtime Requirements:

Requirement

Details

CPU

AMD Zen-based x86_64 (Zen1-Zen5)

OS

Linux (Ubuntu, RHEL, etc.) or Windows 10+

Privileges

CAP_SYS_NICE for thread pinning (Linux, optional)

Dependency Installation Examples:

# Ubuntu/Debian
$ sudo apt-get install cmake g++ python3 python3-dev qemu-user

# Fedora/RHEL/CentOS
$ sudo dnf install cmake gcc-c++ python3 python3-devel qemu-user

# For documentation
$ sudo apt-get install doxygen sphinx-common

Additional Information: