Skip to content
Return to: AMDGPU Top Main

Man AMDgpu Top

Back to: AMDgpu-Top Main Page

Name⚓︎

  • amdgpu_top - Tool to displays AMDGPU usage.

Synopsis⚓︎

  • amdgpu_top [OPTIONS]

Description⚓︎

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⚓︎

Devices

  • Display a list of AMDGPU devices
$ amdgpu_top --list

CPU/GPU

  • Dump All GPU processes and memory usage per process
$ amdgpu_top -p

PCI Bus

  • Specifies PCI bus
$ amdgpu_top --pci "0000:01:00.0"

Options⚓︎

Options

1.

-i <usize>
Select GPU instance.
--pci <String>
Specifying PCI path. (domain🚌dev.func)
-s <u64>, -s <u64>ms
Refresh period (interval) in milliseconds for JSON mode. (default: 1000ms)
-n <u32>
Specifies the maximum number of iteration for JSON mode. If 0 is specified, it will be an infinite loop. (default: 0)
-u <u64>, --update-process-index <u64>
Update interval in seconds of the process index for fdinfo. (default: 5s)
--json_fifo <String>, --json-fifo <String>
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.
--apu, --select-apu
Select APU instance.

2.

--single, --single-gpu
Display only the selected GPU/APU.
--no-pc
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.
-gm, --gpu_metrics, --gpu-metrics
Dump gpu_metrics for all AMD GPUs. Dump gpu_metrics
--pp_table, --pp-table
Dump pp_table from sysfs and VBIOS for all AMD GPUs. (only support Navi1x and Navi2x, Navi3x)
--drm_info, --drm-info
Dump DRM info. Inspired by drm_info
--xdna
Dump XDNA NPU info.
--dark, --dark-mode
Set to the dark mode. (TUI/GUI)
--light, --light-mode
Set to the light mode. (TUI/GUI)

3.

--hide-fdinfo
Hide fdinfo panel and launch. (TUI)
--gl, --opengl
Use OpenGL API to the GUI backend.
--vk, --vulkan
Use Vulkan API to the GUI backend, and use APU/iGPU for GUI rendering if it is available.
-d, --dump
Dump AMDGPU info. (Specifications, VRAM, PCI, ResizableBAR, VBIOS, Video caps) This option can be combined with the "-J" option.
--list
Display a list of AMDGPU devices.
-p, --process
Dump All GPU processes and memory usage per process.
-J, --json
Output JSON formatted data. This option can be combined with the "-d" option.

4.

--gui
Launch GUI mode.
--smi
Launch Simple TUI mode. (like nvidia-smi, rocm-smi)
-V, --version
Print version information.
-h, --help
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 does 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⚓︎

BUGS⚓︎

Back to: AMDgpu-Top Main Page

  1. Debugger — User Mode Register Debugger for AMDGPU Hardware. Copyright © 2025 AMD Inc. ↩

  2. RadeonTop — View your GPU utilization, both for the total activity percent and individual blocks. ↩

  3. intel_gpu_top — Display a top-like summary of Intel GPU usage. ↩