19.6.2. Usage - 19.6.2. Usage - 5.3 English - 57404

AOCL User Guide (57404)

Document ID
57404
Release Date
2026-05-13
Version
5.3 English

Important

Symbol renaming is not compatible with AOCL-LibMem. LibMem uses IFUNC (indirect functions) for runtime CPU dispatch, which requires standard C library names (memcpy, memset, etc.) and cannot be renamed. If you enable both LibMem and symbol renaming, the build will fail with an error. To use symbol renaming, set -DENABLE_AOCL_LIBMEM=OFF.

To enable symbol renaming, add the -DSYMBOL_RENAME_PREFIX=<prefix> option when configuring CMake:

cmake --preset aocl-linux-make-lp-ga-gcc-config \
  -DENABLE_TESTS=ON \
  -DSYMBOL_RENAME_PREFIX=AOCL_

Configuration Options

  • With Symbol Renaming: -DSYMBOL_RENAME_PREFIX=AOCL_ (or any custom prefix)

  • Without Symbol Renaming: Omit the option or use -DSYMBOL_RENAME_PREFIX=""

Build Process

cd build
cmake --build . --target install -j 10

Installation Structure

  • Original libraries: install_package/lib/

  • Renamed libraries: install_package/renamed/lib/