Building AMD Debugger API library#
Users can build the ROCdbgapi library on the following environments:
Ubuntu 18.04
Ubuntu 20.04
Centos 8.1
RHEL 8.1
SLES 15 Service Pack 1
Building the ROCdbgapi library requires the following prerequisites:
A C++17 compiler such as GCC 7 or Clang 5.
AMD Code Object Manager Library (ROCcomgr). Install this library using the
comgr
package included in AMD ROCm.ROCm CMake module. Install this module using the
rocm-cmake
package included in AMD ROCm.For Ubuntu 18.04 and Ubuntu 20.04 the following are the required packages:
apt install gcc g++ make cmake doxygen graphviz texlive-full pci.ids
Note
The
doxygen
1.8.13 that is installed by Ubuntu 18.04 has a bug that prevents the PDF from being created.doxygen
1.8.11 can be built from source to avoid the issue.For CentOS 8.1 and RHEL 8.1 the following adds the needed packages:
yum install -y gcc gcc-g++ make cmake doxygen graphviz texlive \ texlive-xtab texlive-multirow texlive-sectsty texlive-tocloft \ texlive-tabu texlive-adjustbox hwdata
Note
The
doxygen
1.8.14 that is installed by CentOS 8.1 and RHEL 8.1 has a bug that prevents the PDF from being created.doxygen
1.8.11 can be built from source to avoid the issue.For SLES 15 Service Pack 15, the following instructions add the required packages:
zypper in gcc gcc-g++ make cmake doxygen graphviz texlive-scheme-medium \ texlive-hanging texlive-stackengine texlive-tocloft texlive-etoc \ texlive-tabu hwdata
An example command-line to build the ROCdbgapi library on Linux is:
cd rocdbgapi
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=../install ..
make
Specify a path using the CMAKE_INSTALL_PREFIX
parameter.
The built ROCdbgapi library will be placed in:
build/include/amd-dbgapi.h
build/librocm-dbgapi.so*
An example command-line to generate the HTML and PDF library documentation is:
make doc
The generated ROCdbgapi library documentation is put in:
doc/html/index.html
doc/latex/refman.pdf
To install the ROCdbgapi library and documentation, use the following command:
make install
The installed ROCdbgapi library and documentation will be placed in:
../install/include/amd-dbgapi.h
../install/lib/librocm-dbgapi.so*
../install/share/amd-dbgapi/LICENSE.txt
../install/share/amd-dbgapi/README.md
../install/share/html/amd-dbgapi/index.html
../install/share/doc/amd-dbgapi/amd-dbgapi.pdf
To use the ROCdbgapi library, the comgr
library must be installed. This can be installed as part of the AMD ROCm release by the comgr
package:
libamd_comgr.so.1
The ROCdbgapi library requires that the ROCr library is loaded in the inferior to enable AMD GPU debugging. This can be installed as part of the AMD ROCm
release by the hsa-rocr-dev
package:
libhsa-runtime64.so.1