Files

T

Benjamin Welton f15bf42e72 Added ROCTRACER_BUFFER_SIZE to set buffer size

[SWDEV-418917] reported that timing skew was being introduced by
roctracer. Most of the cause of this problem seems to stem from outrunning
the double buffering scheme that we use in memory_pool (part of the
reason for this outrun is due to File writing being slow). A semi-quick
fix that may be able to last until RocProf v2 is complete is to allow
adjustment of the buffer size. ROCTRACER_BUFFER_SIZE env variable was
introduced here which allows setting the buffer size of tracer tool.

By increasing the buffer size, an ~8% reduction in execution time when timing
on the program side. This should also reduce the frequency of large delays
when we outrun the buffer. Note: increasing this size dramatically can cause
slow startups (i.e. above 50MB).

Change-Id: I98c4316cfe93a043623ae2669cfe1a5abb55c990


[ROCm/roctracer commit: 38ba63030d]

2023-10-18 18:06:54 +00:00

doc

SWDEV-415259: Replacing HCC with AMD

2023-08-17 09:23:45 -04:00

inc

Cleanup the include files

2022-09-13 08:23:40 -07:00

plugin

SWDEV-412457 - Add <cassert> header in file that uses assert

2023-09-27 14:29:17 +01:00

script

SWDEV-340925 & ROCMOPS-4997: Fixing Tests package for roctracer

2023-06-08 14:48:28 +00:00

src

Added ROCTRACER_BUFFER_SIZE to set buffer size

2023-10-18 18:06:54 +00:00

test

SWDEV-412457 - <thread> header needs to be included

2023-09-26 14:52:25 +01:00

.clang-format

Rename _clang-format -> .clang-format

2022-05-20 17:08:41 -04:00

.gitignore

CMakeLists.txt cleanup

2022-05-20 10:36:38 -07:00

build_static.sh

fixing the build scripts

2022-05-21 16:14:09 -04:00

build.sh

Fixing RPM build errors for roctracer

2023-07-01 00:22:09 +05:30

CMakeLists.txt

SWDEV-407953: Adding Patch Version from ROCm Standard Option

2023-08-21 13:25:40 -04:00

defaults.sh

Fix copyright headers

2022-04-19 09:30:45 -07:00

header_template.hpp.in

SWDEV-366831 - Compile time flag to switch between #warning and #error message

2023-03-10 09:12:20 -08:00

LICENSE

SWDEV-318551: Adding License file for tracer

2022-01-26 13:39:31 -05:00

README.md

Fixing Readme.txt

2022-11-16 00:39:07 -06:00

roctracer-backward-compat.cmake

Split roctracer to runtime and dev/devel package

2023-01-17 14:10:58 -08:00

run_test.sh

SWDEV-295886 - Replaced hard coded path /opt/rocm with ROCM_PATH

2022-06-16 00:11:35 -07:00

README.md

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 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

Usage

`rocTracer` API

To 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` API

To 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.

Library source tree

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.

Documentation

API description:
- 'roctracer' / 'rocTX' profiling C API specification
Code examples:
- test/MatrixTranspose_test/MatrixTranspose.cpp
- test/MatrixTranspose/MatrixTranspose.cpp

Build and run tests

ROCm is required

Packages required:

For Ubuntu 18.04 and Ubuntu 20.04 the following adds the needed packages:

apt install python3 python3-pip gcc g++ libatomic1 make \
 cmake doxygen graphviz texlive-full

For CentOS 8.1 and RHEL 8.1 the following adds the needed packages:

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

For SLES 15 Service Pack 15 the following adds the needed packages:

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

Installation

Install by:

make install

or:

make package && dpkg -i *.deb