ROC-tracer library: Runtimes Generic Callback/Activity APIs
The goal of the implementation is to provide a generic independent from specific runtime profiler to trace API and asynchronous activity.
The API provides functionality for registering the runtimes API callbacks and asynchronous activity records pool support.
ROC-TX library: Code Annotation Events API
Includes API for:
roctxMark
roctxRangePush
roctxRangePop
rocTracer
APITo use the rocTracer API you need the API header and to link your application with roctracer
.so library:
/opt/rocm/include/roctracer/roctracer.h
API header.
/opt/rocm/lib/libroctracer64.so
.so library.
rocTX
APITo use the rocTX API you need the API header and to link your application with roctx
.so library:
/opt/rocm/roctracer/include/roctx.h
API header.
/opt/rocm/lib/libroctx64.so
.so library.
doc
Documentation.
inc
Include header files.
roctracer.h
rocTacer
library public API header.
roctx.h
rocTX
library public API header.
src
Library sources.
core
rocTracer
library API sources.
roctx
rocTX
library API sources.
util
Library utils sources.
test
Test suit.
MatrixTranspose
Test based on HIP MatrixTranspose sample.
ROCm is required
Packages required:
apt install python3 python3-pip gcc g++ libatomic1 make \
cmake doxygen graphviz texlive-full
yum install -y python3 python3-pip gcc gcc-g++ make \
cmake libatomic doxygen graphviz texlive \
texlive-xtab texlive-multirow texlive-sectsty \
texlive-tocloft texlive-tabu texlive-adjustbox
zypper in python3 python3-pip gcc gcc-g++ make \
cmake libatomic doxygen graphviz \
texlive-scheme-medium texlive-hanging texlive-stackengine \
texlive-tocloft texlive-etoc texlive-tabu
Python modules requirements: CppHeaderParser
, argparse
.
To install:
pip3 install CppHeaderParser argparse
Clone development branch of roctracer
:
git clone -b amd-master https://github.com/ROCm-Developer-Tools/roctracer
To build roctracer
library:
cd <your path>/roctracer
./build.sh
To build and run test:
cd <your path>/roctracer/build
make mytest
run.sh
Install by:
make install
or:
make package && dpkg -i *.deb