README.md

   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