NAME¶

amdgpu-ls - display details about amdgpu compatible GPU cards

SYNOPSIS¶

amdgpu-ls [--debug]
amdgpu-ls [--help | --about]
amdgpu-ls [--clinfo] [--no_fan] [--ppm] [--pstates]

CONFIGURATION¶

All amdgpu-utils require that compatible GPU cards and drivers are installed and that the feature to access them is enabled. This can be accomplished by adding amdgpu.ppfeaturemask=0xfffd7fff to the GRUB_CMDLINE_LINUX_DEFAULT value in /etc/default/grub and executing update-grub.

DESCRIPTION¶

amdgpu-ls displays most relevant parameters for installed and compatible AMD GPUs. The default behavior is to list relevant base parameters by GPU.

OPTIONS¶

--about

Will display details about amdgpu-ls.

--clinfo

If the clinfo package is installed, openCL details will be included in the output for each compatible AMD GPU.

--no_fan

Will exclude fan information from the display. Useful with water cooled GPUs.

--table

Will display table of basic GPU parameters.

--ppm

Will display descriptions of available power performance modes.

--pstates

Will display P-state table for system and memory clocks.

--debug

Will display additional details useful in troubleshooting.

-h, --help

Display help text and exit.

EXAMPLES¶

amdgpu-ls

This will display the basic parameters for all compatible AMD GPUs. These include device ID, GPU frequency/voltage control type, decoded device ID, card model, short card model, display card model, card number, card path, PCIe ID, driver, vBIOS version, HWmon path, current power, power cap, power cap range, fan enable, fan PWM mode, current fan PWM, current fan speed, fan target speed, fan speed range, fan PWM range, current temp, critical temp, current VddGF, Vddc range, current loading, link speed, link width, current Sclk p-state, current Sclk frequency, Sclk range, current Mclk p-state, current Mclk frequency, Mclk range, power performance mode, and power force performance level.

amdgpu-ls --clinfo

In addition to the basic parameters, openCL parameters are also displayed for each compatible AMD GPU. This option is dependent on the installation of clinfo.

amdgpu-ls --ppm

Instead of the basic parameters, a table of power/performance modes is displayed.

amdgpu-ls --pstates

Instead of the basic parameters, a table of power states or curve points is displayed.

FILES¶

/usr/share/misc/pci.ids

The system list of all known AMD PCI ID's (vendors, devices, classes and subclasses). It can be updated with the update-pciids command.

~/.amdgpu-utils/amd_pci_id.txt

A locally updated list of all known AMD PCI ID's (vendors, devices, classes and subclasses). It is preferred to use the system PCI ID file. If the local file exists, it will be used instead of the system file and can be removed with amdgpu-pciid --remove_local command.

/sys/class/drm/card*/device/pp_od_clk_voltage

Special driver file for each GPU required for amdgpu-utils.

/etc/default/grub

The grub defaults file where amdgpu.ppfeaturemask needs to be set.

BUGS¶

Known to not work well with Fiji ProDuo cards and will issue warning messages for Fiji Nano cards. Please report any additional bugs/issues at https://github.com/Ricks-Lab/amdgpu-utils

SEE ALSO¶

clinfo(1), amdgpu(4), update-grub(8), update-pciids(8), lspci(8)

AVAILABILITY¶

The amdgpu-ls command is part of the amdgpu-utils package and is available from https://github.com/Ricks-Lab/amdgpu-utils