Data Collection Using CLI - Data Collection Using CLI - 57368

uProf User Guide

Document ID
57368
Release Date
2025-06-09
Revision
5.1 English
Command to collect basic trace info of an OpenMP application supporting OMPT interface:
$ AMDuProfCLI collect --trace openmp --openmp-impl ompt --openmp-scope basic -o /tmp/myapp_perf <openmp-app>
Command to profile an OpenMP application compiled with GCC OpenMP library:
$ AMDuProfCLI collect --trace openmp --openmp-impl omplib -o /tmp/myapp_perf <openmp-app>

Use the --openmp-impl option to provide OpenMP implementation type: ompt for tracing of OpenMP libraries supporting OMPT interface (example: LLVM, AOCC, ICC), omplib for tracing GCC OpenMP library. If --openmp-impl is not specified, the default selection is ompt.

Use --openmp-scope option to provide tracing scope: full for tracing all the OpenMP events, basic for basic tracing, where synchronization related OpenMP events are not traced to reduce the disk space usage. If --openmp-scope is not specified, the default selection is basic.
Note: This option is only applicable with --openmp-impl ompt.

While performing the regular profiling, add option --trace openmp --openmp-impl <ompt | omplib> to enable OpenMP profiling. This command will launch the program and collect the profile data required to generate the OpenMP analysis report.

Once profile data collection is complete, a session directory will be generated. Use session directory to generate the csv report (or) to import the session in GUI.

Refer CLI collection for all supported options.