Getting Started docs for samples and tools (#261)

* getting started for amples and tools

* Adding getting started to documentation

* Addressing review comments

* minor update

* renaming rocprofv2 to rocprofv3 in doc

* Apply suggestions from code review

---------

Co-authored-by: Jonathan R. Madsen <jrmadsen@users.noreply.github.com>
This commit is contained in:
Gopesh Bhardwaj
2023-12-05 03:52:18 +05:30
committad av GitHub
förälder 1c02e7a92a
incheckning 5c42d7d82a
2 ändrade filer med 57 tillägg och 0 borttagningar
+56
Visa fil
@@ -0,0 +1,56 @@
## Running Samples and Tool
```eval_rst
.. toctree::
:glob:
:maxdepth: 4
```
Samples and tool can be run in order to see the profiler in action. This section covers on how to build these samples and run the tool.
Once the rocm build is installed, samples are installed under:
```bash
/opt/rocm/share/rocprofiler-sdk/samples
```
rocprofv3 tool is installed under:
```bash
/opt/rocm/bin
```
### Building Samples
From any directory, run:
```bash
cmake -B build-rocprofiler-sdk-samples /opt/rocm/share/rocprofiler-sdk/samples -DCMAKE_PREFIX_PATH=/opt/rocm
cmake --build build-rocprofiler-sdk-samples --target all --parallel 8
### Running samples
To run the built samples, cd into the `build-rocprofiler-sdk-samples` directory and run:
```bash
ctest -V
### Running Tool
#### Build an HIP application:
```bash
cmake -B <build-directory> <source-directory> -DCMAKE_PREFIX_PATH=/opt/rocm
cmake --build <build-directory> --target all --parallel <N>
```
#### Run the Tool:
```bash
rocprofv3 --hsa-api ./MatrixTranspose
```
See more tool options with
```bash
rocprofv3 --help
```
+1
Visa fil
@@ -14,4 +14,5 @@
buffered_tracing
intercept_table
developer_api
getting_started
```