RPI-GPU-USAGE(1)

NAME
rpi-gpu-usage - monitor VideoCore GPU block utilisation

SYNOPSIS
rpi-gpu-usage [options]

DESCRIPTION
rpi-gpu-usage monitors the VideoCore GPU block utilisation on Raspberry Pi 4/5. It reads per-process GPU engine times from DRM fdinfo and global utilisation from the V3D gpu_stats sysfs interface.

The display is refreshed once per second, showing per-client GPU engine usage (render, tfu, bin, csd, cache_clean) and CPU usage.

Note that compute workloads (OpenCL, Vulkan compute, ML inference) run on the csd queue rather than the render queue, so they will only be visible in the csd column.

OPTIONS

--csv
    Output in CSV format instead of a formatted table. Suitable for piping to a file for later analysis.

--help
    Show usage information and exit.

EXAMPLES
sudo rpi-gpu-usage                      # interactive terminal display
sudo rpi-gpu-usage --csv > gpu.csv      # log CSV to file

SEE ALSO
vcgencmd(1)