.. Auto-generated by modules/generate_doc.py — do not edit manually.

perf-functions
==============

.. code-block:: text

   Simple performance profiling that reports time spent in each function.

   Uses perf record followed by perf report to list functions sorted by
   overhead. Outputs RESULT-PERF-<symbol>@<pid> for each function above the
   PERF_MIN threshold.

   For more advanced classification-based profiling, see the :doc:`perf-class <modules/perf-class>` module.

   Variables:
     PERF_OPT   - Extra options for perf record (default: empty)
     PERF_TIME  - Recording duration in seconds (default: 4)
     PERF_EVENT - Hardware event to record (default: cycles)
     PERF_MIN   - Minimum overhead percentage to report (default: 1)
     PERF_PATH  - Path to perf binary (default: perf)

   Usage:
     %import@dut perf-functions PERF_TIME=5 PERF_MIN=2