8.7.3. DTL Logging - 5.2 English - 57404

AOCL User Guide (57404)

Document ID
57404
Release Date
2025-12-29
Version
5.2 English

AOCL-DLP provides detailed logging capabilities for debugging and performance analysis.

Enable Logging:

To enable logging, the library must be built with the DLP_ENABLE_LOGGING CMake option:

# Build with logging enabled
cmake -B build -DDLP_ENABLE_LOGGING=ON
make -j$(nproc)

Runtime Logging Control:

Once built with logging support, use the AOCL_ENABLE_LPGEMM_LOGGER environment variable to enable logging at runtime:

# Enable detailed logging for low-precision GEMM operations
export AOCL_ENABLE_LPGEMM_LOGGER=1
./your_application

# Logs are written to files: aocl_lpgemm_P<pid>_T<tid>.log

Accepted Values:

  • 1, true, yes, on (enable logging)

  • 0, false, no, off (disable logging)

Log Output Interpretation:

  • Kernel selection and JIT generation information

  • Thread allocation and decomposition details

  • Performance-related messages

  • Low-precision GEMM operation details