projects / deliverable / exatracer.git / blame
| Commit | Line | Data |
|---|---|---|
| c75d6f3f OD |
1 | # Exatracer |
| 2 | ||
| 3 | The Exatracer is powered by the LTTng ecosystem and can instrument the HIP and | |
| 4 | HSA runtimes and ROC-TX. | |
| 5 | ||
| 6 | ## Usage | |
| 7 | ||
| 8 | Link program against `libexatracer.so` or `LD_PRELOAD` it. | |
| 9 | ||
| 10 | ```sh | |
| 11 | TRACE_OUTPUT="$(pwd)/my-application-trace" | |
| 12 | lttng create --output $TRACE_OUTPUT | |
| 13 | lttng enable-event --userspace 'hip:*' | |
| 14 | lttng enable-event --userspace 'hsa:*' | |
| 15 | lttng enable-event --userspace 'roctx:*' | |
| 16 | lttng start | |
| 17 | LD_PRELOAD=libexatracer.so ./my-application | |
| 18 | lttng destroy | |
| 19 | babeltrace2 $TRACE_OUTPUT | |
| 20 | ``` | |
| 21 | ||
| 22 | ## Dependencies | |
| 23 | ||
| 24 | ### Runtime | |
| 25 | ||
| 26 | - lttng-ust | |
| 27 | - rocprofiler-sdk | |
| 28 | ||
| 29 | ### Development | |
| 30 | ||
| 31 | - babeltrace2 | |
| 32 | - coreutils | |
| 33 | - clang-toolchain | |
| 34 | - g++ | |
| 35 | - lttng-tools | |
| 36 | - make | |
| 37 | - pkg-config | |
| 38 | - python3 >= 3.8 | |
| 39 | - python3-clang | |
| 40 | - sed | |
| 41 | ||
| 42 | ## Compilation | |
| 43 | ||
| 44 | See top of `Makefile` for configuration. | |
| 45 | ||
| 46 | - `make ROCM_VERSION=VERSION` | |
| 47 | - `make check` | |
| 48 | ||
| 49 |