mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-23 22:42:14 +08:00
a5a5f0f785
Important: Added a section about stability. Also fixed a build failure with last commit (missing ending para tag).
298 lines
12 KiB
XML
298 lines
12 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
]>
|
|
|
|
<sect1 id="amdgpu-pro" xreflabel="AMDGPU PRO">
|
|
<?dbhtml filename="amdgpu-pro.html"?>
|
|
|
|
<title>AMDGPU PRO</title>
|
|
|
|
<indexterm zone="amdgpu-pro">
|
|
<primary sortas="a-amdgpu-pro">AMDGPU PRO</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to AMDGPU PRO</title>
|
|
|
|
<para>
|
|
The <application>AMDGPU PRO</application> proprietary driver contains
|
|
userland drivers and libraries, providing hardware acceleration encoding,
|
|
EGL, OpenGL, GLES, and Vulkan support.
|
|
</para>
|
|
|
|
|
|
|
|
<bridgehead renderas="sect3">AMDGPU PRO Dependencies</bridgehead>
|
|
|
|
<bridgehead renderas="sect4">Required</bridgehead>
|
|
<para role="required">
|
|
<xref linkend="xorg7-lib"/>,
|
|
<xref linkend="gpuconfig"/>, and
|
|
<xref linkend="wget"/> (for getting the .deb files in the installation
|
|
instructions)
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Recommended</bridgehead>
|
|
<para role="recommended">
|
|
<xref linkend="libglvnd"/>,
|
|
<xref linkend="libvk"/>,
|
|
and <xref linkend="wayland"/>
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
If you are doing multilib, follow both the x86_64 and i686
|
|
instructions.
|
|
</para>
|
|
</note>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>x86_64 Installation of AMDGPU PRO</title>
|
|
|
|
<para>
|
|
First create a list of all the files to download that will be downloaded
|
|
using <xref linkend="wget"/>:
|
|
</para>
|
|
|
|
<screen><userinput>cat >> x86_64-amdgpu-pro-wget-list << "EOF"
|
|
<literal>https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/a/amf-amdgpu-pro/amf-amdgpu-pro_&amdgpu-pro-amf-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/liba/libamdenc-amdgpu-pro/libamdenc-amdgpu-pro_&amdgpu-pro-libamdenc-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libegl1-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-dri_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-ext_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-gbm_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-glx_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgles1-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgles2-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/v/vulkan-amdgpu-pro/vulkan-amdgpu-pro_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb</literal>
|
|
EOF</userinput></screen>
|
|
|
|
<para>
|
|
Download and unpack the drivers by following the instructions below:
|
|
</para>
|
|
|
|
<screen><userinput>mkdir -pv x86_64-amdgpu-pro
|
|
cd x86_64-amdgpu-pro
|
|
|
|
wget --continue --input-file=../x86_64-amdgpu-pro-wget-list
|
|
for deb in *.deb; do
|
|
ar x $deb
|
|
tar -xf data.tar.xz
|
|
rm -rf *.tar.xz debian-binary dists
|
|
done
|
|
|
|
install -d usr/lib/amdgpu-pro
|
|
install -d usr/share/drirc.d
|
|
cp -r opt/amdgpu-pro/lib/x86_64-linux-gnu/* usr/lib
|
|
cp -r usr/lib/x86_64-linux-gnu/* usr/lib
|
|
cp -r opt/amdgpu-pro/lib/x86_64-linux-gnu/* usr/lib/amdgpu-pro
|
|
mv opt/amdgpu-pro/lib/xorg usr/lib/amdgpu-pro
|
|
cp -r opt/amdgpu/share/drirc.d/* usr/share/drirc.d
|
|
cp -r usr/lib/amdgpu-pro/* usr/lib
|
|
cp -r opt/amdgpu-pro/etc/vulkan usr/share
|
|
mv usr/share/vulkan/icd.d/amd_icd64.json usr/share/vulkan/icd.d/amd_pro_icd64.json
|
|
mv usr/lib/amdvlk64.so usr/lib/amdvlkpro64.so
|
|
sed -i "s#/opt/amdgpu-pro/lib/x86_64-linux-gnu/amdvlk64.so#/usr/lib/amdvlkpro64.so#" \
|
|
usr/share/vulkan/icd.d/amd_pro_icd64.json
|
|
rm -rf opt/amdgpu-pro/lib/x86_64-linux-gnu
|
|
rm -rf usr/lib/x86_64-linux-gnu
|
|
rm -rf opt/amdgpu-pro/lib/x86_64-linux-gnu
|
|
rm -rf opt/amdgpu-pro/share/drirc.d
|
|
rm -rf usr/lib/amdgpu-pro
|
|
rm -rf opt/amdgpu-pro/etc/vulkan
|
|
rm -rf etc opt</userinput></screen>
|
|
|
|
<para>
|
|
Now install the driver by running the following commands as the
|
|
<systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>cp -Rv usr/* /usr
|
|
ldconfig</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>i686 Installation of AMDGPU PRO</title>
|
|
|
|
<note>
|
|
<para>
|
|
When using a 32-bit CPU, you will lose support for AMF and AMDENC
|
|
support, which is a big reason to use the proprietary driver in the
|
|
first place. Consider upgrading your CPU to the x86_64 architecture.
|
|
</para>
|
|
</note>
|
|
|
|
<para>
|
|
First create a list of all the files to download that will be downloaded
|
|
using <xref linkend="wget"/>:
|
|
</para>
|
|
|
|
<screen><userinput>cat >> i386-amdgpu-pro-wget-list << "EOF"
|
|
<literal>https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libegl1-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-dri_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-glx_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgles1-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/o/oglp-amdgpu-pro/libgles2-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
|
|
https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/v/vulkan-amdgpu-pro/vulkan-amdgpu-pro_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb</literal>
|
|
EOF</userinput></screen>
|
|
|
|
<para>
|
|
Download and unpack the drivers by following the instructions below:
|
|
</para>
|
|
|
|
<screen><userinput>mkdir -pv i386-amdgpu-pro
|
|
cd i386-amdgpu-pro
|
|
|
|
wget --continue --input-file=../i386-amdgpu-pro-wget-list
|
|
for deb in *.deb; do
|
|
ar x $deb
|
|
tar -xf data.tar.xz
|
|
rm -rf *.tar.xz debian-binary dists
|
|
done
|
|
|
|
install -d usr/lib32/amdgpu-pro
|
|
install -d usr/share/drirc.d
|
|
cp -r opt/amdgpu-pro/lib/i386-linux-gnu/* usr/lib32
|
|
cp -r usr/lib/i386-linux-gnu/* usr/lib32
|
|
cp -r opt/amdgpu-pro/lib/i386-linux-gnu/* usr/lib32/amdgpu-pro
|
|
cp -r opt/amdgpu/share/drirc.d/* usr/share/drirc.d
|
|
cp -r usr/lib32/amdgpu-pro/* usr/lib32
|
|
cp -r opt/amdgpu-pro/etc/vulkan usr/share
|
|
mv usr/share/vulkan/icd.d/amd_icd32.json usr/share/vulkan/icd.d/amd_pro_icd32.json
|
|
mv usr/lib32/amdvlk32.so usr/lib32/amdvlkpro32.so
|
|
sed -i "s#/opt/amdgpu-pro/lib/i386-linux-gnu/amdvlk32.so#/usr/lib32/amdvlkpro32.so#" \
|
|
usr/share/vulkan/icd.d/amd_pro_icd32.json
|
|
rm -rf usr/lib
|
|
rm -rf usr/lib32/amdgpu-pro
|
|
rm -rf etc opt
|
|
|
|
case $(uname -m) in
|
|
i686)
|
|
mv -v usr/lib32 usr/lib
|
|
;;
|
|
esac</userinput></screen>
|
|
|
|
<para>
|
|
Now install the driver by running the following commands as the
|
|
<systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>cp -Rv usr/* /usr
|
|
ldconfig</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<note>
|
|
<para>
|
|
There are many libraries provided by this package that have the same
|
|
name and serve the same purpose. The info below covers the unique
|
|
libraries. Check the <quote>Contents</quote> section of either
|
|
<xref linkend="libglvnd"/> and/or <xref linkend="mesa"/>.
|
|
</para>
|
|
</note>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Libraries</segtitle>
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
None
|
|
</seg>
|
|
<seg>
|
|
amdgpu_dri.so,
|
|
amdvlkpro{64,32}.so,
|
|
libamdenc64.so,
|
|
libamfrt64.so, and
|
|
libGLX_amd.so
|
|
</seg>
|
|
<seg>
|
|
/usr/share/doc/{libegl1-amdgpu-pro-oglp,libgl1-amdgpu-pro-oglp-glx,libgles2-amdgpu-pro-oglp,libgl1-amdgpu-pro-oglp-dri,libgles1-amdgpu-pro-oglp,vulkan-amdgpu-pro},
|
|
/usr/share/drirc.d, and
|
|
/usr/share/vulkan/icd.d
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="amdgpu_dri">
|
|
<term><filename class="libraryfile">amdgpu_dri.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
is the AMDGPU DRI driver
|
|
</para>
|
|
<indexterm zone="amdgpu-pro amdgpu_dri">
|
|
<primary sortas="c-amdgpu_dri">amdgpu_dri.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="amdvlkpro">
|
|
<term><filename class="libraryfile">amdvlkpro{64,32}.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
is the AMDGPU Vulkan driver
|
|
</para>
|
|
<indexterm zone="amdgpu-pro amdvlkpro">
|
|
<primary sortas="c-amdvlkpro">amdvlkpro{64,32}.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libamdenc64">
|
|
<term><filename class="libraryfile">libamdenc64.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
handles encoding for AMDGPU cards
|
|
</para>
|
|
<indexterm zone="amdgpu-pro libamdenc64">
|
|
<primary sortas="c-libamdenc64">libamdenc64.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libamfrt64">
|
|
<term><filename class="libraryfile">libamfrt64.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides the Advanced Media Framework, allowing better multimedia
|
|
processing on AMD GPUs
|
|
</para>
|
|
<indexterm zone="amdgpu-pro libamfrt64">
|
|
<primary sortas="c-libamfrt64">libamfrt64.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libGLX_amd">
|
|
<term><filename class="libraryfile">libGLX_amd.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
is the AMD version of GLX
|
|
</para>
|
|
<indexterm zone="amdgpu-pro libGLX_amd">
|
|
<primary sortas="c-libGLX_amd">libGLX_amd.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|