# roctracer

**Repository Path**: mirrors_ROCmSoftwarePlatform/roctracer

## Basic Information

- **Project Name**: roctracer
- **Description**: ROCm Tracer Callback/Activity Library for Performance tracing AMD GPU's
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: amd-master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ROC-tracer
```
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 asyncronous activity.

The API provides functionality for registering the runtimes API callbacks and
asyncronous activity records pool support.
```

## The library source tree
```
 - inc/roctracer.h - Library public API
 - src  - Library sources
   - core - Library API sources
   - util - Library utils sources
 - test - test suit
   - MatrixTranspose - test based on HIP MatrixTranspose sample
```

## Documentation
```
 - API description: inc/roctracer.h
 - Code example: test/MatrixTranspose_test/MatrixTranspose.cpp
```

## To build and run test
```
 - ROCm-2.3 or higher is required

  cd <your path>

 - CLone development branch of roctracer:
  git clone -b amd-master https://github.com/ROCmSoftwarePlatform/roctracer.git

 - Set environment:
  export HIP_PATH=/opt/rocm/hip
  export HCC_HOME=/opt/rocm/hcc
  export CMAKE_PREFIX_PATH=/opt/rocm

 - Build ROCtracer
  export CMAKE_BUILD_TYPE=<debug|release> # release by default
  cd <your path>/roctracer && mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX=/opt/rocm .. && make -j <nproc>

 - To build and run test
  make mytest
  run.sh
  
 - To install
  make install
 or
  make package && dpkg -i *.deb
```