Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/clbr/radeontop


https://github.com/clbr/radeontop

Last synced: 12 days ago
JSON representation

Awesome Lists containing this project

README

        

RadeonTop
=========

View your GPU utilization, both for the total activity percent and individual blocks.

Requires access to /dev/dri/cardN files or /dev/mem (root privileges).

![Screenshot from 2019-10-19 01-34-50_cut](https://user-images.githubusercontent.com/11575/67134324-fdec5300-f211-11e9-8597-394d9c062fe7.png)

Supported cards
---------------

R600 and up, even Southern Islands should work fine.
Works with both the open drivers and AMD Catalyst.

For the Catalyst driver, only the mem path is currently supported - this
means it won't run on the default Ubuntu kernels that block /dev/mem.

The total GPU utilization is also valid for OpenCL loads; the other blocks
are only useful in GL loads.

Translations
------------

If you'd like to translate RadeonTop to your own language, please go here:

https://translations.launchpad.net/radeontop

Running
-------

#### Prerequisites

* libdrm
* libncurses
* libpciaccess
* libxcb

Simply start radeontop and it auto-selects the first supported GPU:

./radeontop

Running radeontop on a bus 0f:

./radeontop -b 0f

Writing values to stdout instead of showing a GUI:

./radeontop -d -

Getting all options:

./radeontop --help

Building
--------

#### Prerequisites
* all run time prerequisites with dev files
* gcc / clang
* pkgconf

### Building
If all prerequisites are fullfilled, it can be build by simply running:

make

#### Build options

Build options can be specified to having the following variables being set to "1"

nls enable translations, default on
debug enable debug symbols, default off
nostrip disable stripping, default off
plain apply neither gcc's -g nor -s.
xcb enable libxcb to run unprivileged in Xorg, default on
amdgpu enable amdgpu usage reporting, default auto (requires libdrm >= 2.4.63)

Example:

make amdgpu=1 xcb=1

This will build radeontop with amdgpu reporting and xcb support.