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

-i <usize>
    Select GPU instance.

--pci <String>
    Specifying PCI path. (domain:bus: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.

--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. https://www.kernel.org/doc/html/latest/gpu/amdgpu/thermal.html#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 https://gitlab.freedesktop.org/emersion/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)

--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.

--gui
    Launch GUI mode.

--single-gui
    Launch Single GUI mode.

--tab-gui
    Launch Tab 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
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