Reporting Bugs

Bugs should be reported through your AMD Customer Engagement Representative.

If you downloaded a release archive directly from the AMD web site and do not have an AMD Customer Engagement Representative, you may report bugs using the issue tracker with the label “AMDgpu-pro”.

Generating a Bug Report

In order to facilitate efficient investigation, it’s important to include as much detail as possible with the bug report. Perform the following steps before you file a bug report:

  1. Create a destination folder for the report.


    If you gather several reports, identify them with the date and if needed add a number at the end to differentiate between your reports, as shown in the following example.

    $ LOGDIR=~/LOGS/20170913-1
    $ mkdir -p $LOGDIR
    $ cd $LOGDIR
  2. Gather basic configuration details.

    $ sudo lshw -c cpu | grep product >> basic.conf
    $ lspci -nn | grep "VGA\|Display" >> basic.conf
    $ sudo dmidecode -t BIOS | grep Version >> basic.conf
    $ lsb_release -sd >> basic.conf
    $ uname -a >> basic.conf
    $ dkms status | grep "amdgpu\|radeon" >> basic.conf
  3. Create detailed log files by running the following commands:

    $ dkms status > dkms.status.log
    $ lsmod | grep amdgpu > lsmod.amdgpu.log
    $ dmesg > dmesg.log
    $ cp /var/log/Xorg.0.log .
    $ type -p dpkg && dpkg -l > package.log
    $ type -p rpm && rpm -qa > package.log
  4. (Optional) To facilitate in-depth analysis, you can run the following commands:

    $ lspci -vnn > lspci.vnn.log
    $ lspci -nn > lspci.nn.log
    $ sudo dmidecode > dmidecode.log
    $ uname -a > uname.a.log
    $ lsinitramfs /boot/initrd.img-`uname -r` > lsinitramfs.log
    $ sudo lshw > lshw.log
    $ modinfo amdgpu > modinfo.amdgpu.log
    $ glxinfo > glxinfo.log

Capturing the Output of Your Commands to a File

  1. Start a script session to capture your commands to a log file.

    $ script /tmp/install-log.txt
  2. Run all commands you want to capture in the script (for example, install

    All-Open base driver).

    $ amdgpu-install -y --usecase=graphics
  3. End the capture session.

    $ exit