Function Call Tracing - 5.2 English - 57404

AOCL User Guide (57404)

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

Function call tracing is implemented using instrumentation of the AOCL-BLAS code. Here, the functions are grouped based on their position in the call stack. You can configure the level up to which the traces must be generated. The default trace depth level is 5, which will show, for example, calls down to gemm kernel level. A lower level reduces the depth of the call stack used for a trace generation.

Complete the following steps to enable and view the traces:

  1. Enable the trace support and desired trace depth level, and build the AOCL-BLAS library as explained in Enabling Call Logging and/or Tracing.

  2. Run the application to generate the trace data.

    The trace output file for each thread is generated in the current folder.

    The following figure shows a sample running the call tracing function using the test_gemm application:

    _images/image5.jpeg

    Figure 4.5 Sample Run of Function Call Tracing#

    The trace data for each thread is saved in the file with appropriate naming conventions. The .txt extension is used to signify the readable file:

    P<process id>_T<thread id>_aocldtl_trace.txt

  3. View the trace data.

    The output of the call trace is in a readable format, you can open the file in any of the text editors. The first column shows the level in call stack for the given function.