T

Laurent Morichetti 3d0198c395 Remove the roctx range message stack

The range message stack is mirrored in case ranges are pushed or popped
while tracing is stopped (by the tracer tool?). When a stop event is
reported, the tracer tool emits RangePop events by unwinding the stack,
then when the start event is reported, it emits RangePush events again
by unwinding the stack. The issue is that the RangePush events should
be emitted in reverse order.

For example:

RangePush(M1); RangePush(M2); \
  TracerStop; RangePop; RangePop; \
...; \
  TracerStart; RangePush(M2); RangePush(M1); \ <- In the wrong order
RangePop; RangePop;

It could be fixed by reversing the stack in RangeStackIterate but is it
worth it? The roctx range markers are supposed to be unintrusive so that
they can be left in the application even when it isn't being traced.

Simplifying the roctx API and reducing its added latency by removing
the range message stack mirroring seems like the better choise.

TODO: A future change should make roctx events immune to tracer start
and tracer stop requests. Or simply remove roctracer_start/stop.

Change-Id: Ie4d76afb5ce8d263848dcf1b599af394db56ddab

2022-05-10 12:08:06 -07:00

cmake_modules

Removing HIP_API_PROF_STRING from the tracer_tool

2022-05-04 09:46:56 -04:00

DEBIAN

roctracer: Consider apt upgrade operation check in package scripts.

2022-03-21 23:43:19 -04:00

doc

Add doxygen to roctracer.h

2022-04-30 00:33:05 +00:00

inc

Remove the roctx range message stack

2022-05-10 12:08:06 -07:00

RPM

File reorganization with backward compatibility

2022-03-04 04:03:51 -08:00

script

Cleanup CallbackTable::Get

2022-05-10 08:13:18 -07:00

src

Remove the roctx range message stack

2022-05-10 12:08:06 -07:00

test

Remove the roctx range message stack

2022-05-10 12:08:06 -07:00

_clang-format

Initial commit

2018-05-10 13:19:10 -05:00

.gitignore

SWDEV-307394: Fixing Download HSA-Class Issue

2022-03-29 22:27:25 +00:00

build_proto.sh

Fix copyright headers

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

build_static.sh

Removing HIP_API_PROF_STRING from the tracer_tool

2022-05-04 09:46:56 -04:00

build.sh

Removing HIP_API_PROF_STRING from the tracer_tool

2022-05-04 09:46:56 -04:00

CMakeLists.txt

Consolidate all sources of timestamps

2022-05-10 08:13:09 -07:00

defaults.sh

Fix copyright headers

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

header_template.hpp.in

Populate roctracer.h wrapper file with orginal file contents as dead code

2022-04-26 03:09:35 -07:00

LICENSE

SWDEV-318551: Adding License file for tracer

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

README.md

Update README.md

2022-04-15 20:34:21 +00:00

roctracer-backward-compat.cmake

Populate roctracer.h wrapper file with orginal file contents as dead code

2022-04-26 03:09:35 -07:00

run_test.sh

Fix copyright headers

2022-04-19 09:30:45 -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/roctracer/include/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
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
mkdir build && cd build
cmake -DCMAKE_PREFIX_PATH=/opt/rocm -DCMAKE_INSTALL_PREFIX=/opt/rocm ..
make

To build and run test:
```
make mytest
run.sh
```

Installation

Install by:

make install

or:

make package && dpkg -i *.deb

Languages

C++ 67.5%

C 20.6%

Python 6.6%

CMake 3.4%

Shell 0.6%

Other 1.1%