1. Manuals
  2. Tumbleweed
  3. amdgpu_top
  4. amdgpu_top(1)

Scroll to navigation

AMDGPU_TOP(1) AMDGPU_TOP(1)

NAME

amdgpu_top - Tool to displays AMDGPU usage.

SYNOPSIS

amdgpu_top [OPTIONS]

DESCRIPTION

amdgpu_top is tool that display AMD GPU utilization, like umr [1] or clbr/radeontop [2] or intel_gpu_top [3] .

The tool displays information gathered from performance counters (GRBM, GRBM2), sensors, fdinfo, and AMDGPU driver.

EXAMPLES

Display a list of AMDGPU devices

$ amdgpu_top --list

Dump All GPU processes and memory usage per process

$ amdgpu_top -p

Specifies PCI bus

$ amdgpu_top --pci "0000:01:00.0"

OPTIONS

Select GPU instance.
Specifying PCI path. (domain:bus:dev.func)
Refresh period (interval) in milliseconds for JSON mode. (default: 1000ms)
Specifies the maximum number of iteration for JSON mode. If 0 is specified, it will be an infinite loop. (default: 0)
Update interval in seconds of the process index for fdinfo. (default: 5s)
Output JSON formatted data to FIFO (named pipe) for other application and scripts.
–decode-gm <Path>, –decode-gpu-metrics <Path>
Decode the specified gpu_metrics file.
Select APU instance.
Display only the selected GPU/APU.
The application does not read the performance counter (GRBM, GRBM2) if this flag is set. Reading the performance counter may deactivate the power saving feature of APU/GPU.
Dump gpu_metrics for all AMD GPUs. https://www.kernel.org/doc/html/latest/gpu/amdgpu/thermal.html#gpu-metrics
Dump pp_table from sysfs and VBIOS for all AMD GPUs. (only support Navi1x and Navi2x, Navi3x)
Dump DRM info. Inspired by https://gitlab.freedesktop.org/emersion/drm_info
Dump XDNA NPU info.
Set to the dark mode. (TUI/GUI)
Set to the light mode. (TUI/GUI)
Hide fdinfo panel and launch. (TUI)
Use OpenGL API to the GUI backend.
Use Vulkan API to the GUI backend, and use APU/iGPU for GUI rendering if it is available.
Dump AMDGPU info. (Specifications, VRAM, PCI, ResizableBAR, VBIOS, Video caps) This option can be combined with the “-J” option.
Display a list of AMDGPU devices.
Dump All GPU processes and memory usage per process.
Output JSON formatted data. This option can be combined with the “-d” option.
Launch GUI mode.
Launch Simple TUI mode. (like nvidia-smi, rocm-smi)
Print version information.
Print help information.

COMMANDS FOR TUI MODE

key
f toggle fdinfo
n toggle Sensors
m toggle GPU Metrics
h change update interval (high = 100ms, low = 1000ms)
q Quit
P sort fdinfo by pid
M sort fdinfo by VRAM usage
G sort fdinfo by GFX usage
M sort fdinfo by MediaEngine usage
R reverse sort for fdinfo

FDINFO DESCRIPTION

fdinfo for the AMDGPU driver shows hardware IP usage per process.

VRAM

GTT

Graphics Translation Tables.

KFD

The process of using the AMDKFD driver.

GFX

GFX engine.

Compute/COMP

Compute engine.

The AMDKFD driver dose not track queues and does not show them in fdinfo.

DMA

DMA/SDMA (System DMA) engine.

Decode/DEC

Media decoder.

This is not show on RDNA 4.

Encode/ENC

Media encoder.

This is not show on RDNA 4.

VCN, Media

Media engine.

From VCN4, the encoding queue and decoding queue have been unified.

The AMDGPU driver handles both decoding and encoding as contexts for the encoding engine.

JPEG

JPEG decoder.

VPE

Video Processor Engine.

ref:

<https://gitlab.freedesktop.org/mesa/mesa/-/blob/main/src/amd/vpelib/README.md>

BUGS

<https://github.com/Umio-Yasuno/amdgpu_top/issues>

NOTES

[1]

<https://gitlab.freedesktop.org/tomstdenis/umr/>

[2]

<https://github.com/clbr/radeontop>

[3]

<https://gitlab.freedesktop.org/drm/igt-gpu-tools/-/blob/master/man/intel_gpu_top.rst>

AUTHORS

Umio Yasuno <coelacanth_dream@protonmail.com>.

2023-12-01