Install AQLprofile

Install AQLprofile#

2025-08-21

2 min read time

Applies to Linux

Learn how to build AQLprofile with a script or with CMake, then install the library with a command.

Prerequisites#

Before you begin, ensure these tools and dependencies are installed:

ROCm stack
rocm-llvm-dev (required to build tests)

Build AQLprofile#

You can build AQLprofile using either the provided build script (recommended for most users) or by manually invoking CMake for custom builds.

Option 1: Use the build script (Recommended)#

This configures and builds the project with the default settings:

./build.sh

Option 2: Use CMake for custom builds#

For more control over the build process, you can set the CMake options manually:

# Set the CMAKE_PREFIX_PATH to point to hsa-runtime includes path and hsa-runtime library path
export CMAKE_PREFIX_PATH=<path to hsa-runtime includes>:<path to hsa-runtime library>
# For example, if ROCm is installed at /opt/rocm:
# export CMAKE_PREFIX_PATH=/opt/rocm/lib:/opt/rocm/include/hsa

export CMAKE_BUILD_TYPE=<debug|release> # release by default

cd /path/to/aqlprofile
mkdir build
cd build
cmake ..
make -j

Enable debug tracing (Optional)#

To enable debug tracing, set this environment variable before running CMake:

export CMAKE_DEBUG_TRACE=1

This enables verbose debug output of the command packets while this library executes.

Install the AQLprofile libraries#

Once your build is successful, install the AQLprofile libraries with:

cd build
sudo make install