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.

--smi

Launch Simple TUI mode. (like nvidia-smi, rocm-smi)

-V, --version

Print version information.

-h, --help

Print help information.

COMMANDS FOR TUI MODE¶

BUGS¶

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

NOTES¶

AUTHORS¶

Umio Yasuno <coelacanth_dream@protonmail.com>.