The UMR (User Mode Register debugger) is a debugging tool for Linux platforms that provides functionality to inspect the state of AMDGPU based devices. This is accomplished via several commands that UMR supports such as register reads/writes, ring decoding, virtual memory decoding and memory read/writes, register activity tracing, and IP block monitoring and logging.
Usefull for bug reports or submit patches, it's published under the MIT license. This page contains a short guide to install UMR on Debian, for the user manual see umr/doc/sphinx/build.
Install dependencies
$ sudo apt install git build-essential cmake libncurses-dev libpciaccess-dev libdrm-dev \ llvm-dev libnanomsg-dev libgl-dev libegl-dev libgles-dev libopengl-dev libgbm-dev \ libedit-dev libz3-dev libzstd-dev libcurl4-gnutls-dev libsdl2-dev python3-sphinx
Get the source code
$ git clone https://gitlab.freedesktop.org/tomstdenis/umr.git
Configure and build
$ cd umr $ mkdir build-dir
$ cmake -B build-dir -S . or to build without the GUI: $ cmake -DUMR_GUI=OFF -B build-dir -S .
$ cmake --build build-dir
Build a Debian package to make uninstall simpler
$ cd build-dir
Edit CPackConfig.cmake to avoid build and install errors
Replace set(CPACK_DEBIAN_PACKAGE_DEPENDS "xxx, xxx") with set(CPACK_DEBIAN_PACKAGE_DEPENDS "")
Replace set(CPACK_GENERATOR "RPM;DEB") with set(CPACK_GENERATOR "DEB")
Make it
$ cpack
Install the Debian package
$ sudo dpkg -i umr-*-Linux.deb
Build the documentation
cd .. cd doc/sphinx make html man
Usage
Show the manpage
$ man umr
Run in CLI
$ sudo umr
Run with the GUI
$ sudo umrgui or $ sudo umr --gui
Remove the Debian package
$ sudo dpkg -r umr
You can also purge installed dependencies.