Files
glfs/shareddeps/drivers/amdgpu-pro.xml
Zeckmathederg b6e0053e6a *: Remove <application> tags.
The application tag seemed to just put an extra space on either side of
the word(s) the tags surrounded and seemed to serve no purpose beyond
that. If it served the purpose of jhalfs, well this book is not
supported by jhalfs. The result of the tags just added space in both the
rendered output and in the XML files.

Now, when referring to a package name, we just say the name and don't
surround it via a tag. The only exception is using <command>,
<filename>, <xref>, or <ulink>.
2025-07-17 13:32:36 -06:00

298 lines
13 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;
<!ENTITY amdgpu-pro-download-http
"https://repo.radeon.com/amdgpu/&amdgpu-pro-repo-folder-version;/ubuntu/pool/proprietary/">
]>
<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>
<important><para>
This page is now considered deprecated and will be removed right before
release of GLFS-12.4. Please use the drivers from <xref linkend="mesa"/>
and replace AMF with <xref linkend="libva"/>.
</para></important>
<para>
The AMDGPU PRO proprietary driver contains
userland drivers and libraries, providing hardware acceleration encoding,
EGL, OpenGL, GLES, and Vulkan support <emphasis>FOR</emphasis> AMDGPU
cards. If you do not have an AMDGPU card, you can skip this page.
</para>
<bridgehead renderas="sect3">AMDGPU PRO Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xorg7-lib"/>,
<xref linkend="gpuconfig"/>,
<xref linkend="mesa"/>, and
<xref linkend="wget"/> (for getting the .deb files in the installation
instructions)
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="vulkan-sdk"/> 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 &gt; x86_64-amdgpu-pro-wget-list &lt;&lt; "EOF"
<literal>a/amf-amdgpu-pro/amf-amdgpu-pro_&amdgpu-pro-amf-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
liba/libamdenc-amdgpu-pro/libamdenc-amdgpu-pro_&amdgpu-pro-libamdenc-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
o/oglp-amdgpu-pro/libegl1-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-dri_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-ext_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-gbm_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-glx_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
o/oglp-amdgpu-pro/libgles1-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
o/oglp-amdgpu-pro/libgles2-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_amd64.deb
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 x86_64-amdgpu-pro &amp;&amp;
cd x86_64-amdgpu-pro &amp;&amp;
grep -v '^#' ../x86_64-amdgpu-pro-wget-list | wget -i- -c \
-B &amdgpu-pro-download-http; &amp;&amp;
for deb in *.deb; do
ar x $deb &amp;&amp;
tar -xf data.tar.xz &amp;&amp;
rm -rf *.tar.xz debian-binary dists
done &amp;&amp;
install -d usr/lib/amdgpu-pro &amp;&amp;
install -d usr/share/drirc.d &amp;&amp;
cp -r opt/amdgpu-pro/lib/x86_64-linux-gnu/* usr/lib &amp;&amp;
cp -r usr/lib/x86_64-linux-gnu/* usr/lib &amp;&amp;
cp -r opt/amdgpu-pro/lib/x86_64-linux-gnu/* usr/lib/amdgpu-pro &amp;&amp;
mv opt/amdgpu-pro/lib/xorg usr/lib/amdgpu-pro &amp;&amp;
cp -r opt/amdgpu/share/drirc.d/* usr/share/drirc.d &amp;&amp;
cp -r usr/lib/amdgpu-pro/* usr/lib &amp;&amp;
cp -r opt/amdgpu-pro/etc/vulkan usr/share &amp;&amp;
mv usr/share/vulkan/icd.d/amd_icd64.json usr/share/vulkan/icd.d/amd_pro_icd64.json &amp;&amp;
mv usr/lib/amdvlk64.so usr/lib/amdvlkpro64.so &amp;&amp;
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 &amp;&amp;
rm -rf usr/lib/dri/* &amp;&amp;
cp -a opt/amdgpu/lib/x86_64-linux-gnu/dri/* usr/lib/dri/ &amp;&amp;
rm -rf opt/amdgpu-pro/lib/x86_64-linux-gnu &amp;&amp;
rm -rf usr/lib/x86_64-linux-gnu &amp;&amp;
rm -rf opt/amdgpu-pro/lib/x86_64-linux-gnu &amp;&amp;
rm -rf opt/amdgpu-pro/share/drirc.d &amp;&amp;
rm -rf usr/lib/amdgpu-pro &amp;&amp;
rm -rf opt/amdgpu-pro/etc/vulkan &amp;&amp;
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 &amp;&amp;
ldconfig</userinput></screen>
</sect2>
<sect2 role="installation">
<title>i686 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 &gt; i386-amdgpu-pro-wget-list &lt;&lt; "EOF"
<literal>o/oglp-amdgpu-pro/libegl1-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-dri_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
o/oglp-amdgpu-pro/libgl1-amdgpu-pro-oglp-glx_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
o/oglp-amdgpu-pro/libgles1-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
o/oglp-amdgpu-pro/libgles2-amdgpu-pro-oglp_&amdgpu-pro-major-short-version;-&amdgpu-pro-minor-version;.&amdgpu-pro-ubuntu-version;_i386.deb
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 i386-amdgpu-pro &amp;&amp;
cd i386-amdgpu-pro &amp;&amp;
grep -v '^#' ../i386-amdgpu-pro-wget-list | wget -i- -c \
-B &amdgpu-pro-download-http; &amp;&amp;
for deb in *.deb; do
ar x $deb &amp;&amp;
tar -xf data.tar.xz &amp;&amp;
rm -rf *.tar.xz debian-binary dists
done &amp;&amp;
install -d usr/lib32/amdgpu-pro &amp;&amp;
install -d usr/share/drirc.d &amp;&amp;
cp -r opt/amdgpu-pro/lib/i386-linux-gnu/* usr/lib32 &amp;&amp;
cp -r usr/lib/i386-linux-gnu/* usr/lib32 &amp;&amp;
cp -r opt/amdgpu-pro/lib/i386-linux-gnu/* usr/lib32/amdgpu-pro &amp;&amp;
cp -r opt/amdgpu/share/drirc.d/* usr/share/drirc.d &amp;&amp;
cp -r usr/lib32/amdgpu-pro/* usr/lib32 &amp;&amp;
cp -r opt/amdgpu-pro/etc/vulkan usr/share &amp;&amp;
mv usr/share/vulkan/icd.d/amd_icd32.json usr/share/vulkan/icd.d/amd_pro_icd32.json &amp;&amp;
mv usr/lib32/amdvlk32.so usr/lib32/amdvlkpro32.so &amp;&amp;
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 &amp;&amp;
rm -rf usr/lib32/dri/* &amp;&amp;
cp -a opt/amdgpu/lib/i386-linux-gnu/dri/* usr/lib32/dri/ &amp;&amp;
rm -rf usr/lib &amp;&amp;
rm -rf usr/lib32/amdgpu-pro &amp;&amp;
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 &amp;&amp;
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 <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,
amdvlkpro{64,32},
libamdenc64,
libamfrt64, and
libGLX_amd
</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</filename></term>
<listitem>
<para>
is the AMDGPU DRI driver
</para>
<indexterm zone="amdgpu-pro amdgpu_dri">
<primary sortas="c-amdgpu_dri">amdgpu_dri</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="amdvlkpro">
<term><filename class="libraryfile">amdvlkpro{64,32}</filename></term>
<listitem>
<para>
is the AMDGPU Vulkan driver
</para>
<indexterm zone="amdgpu-pro amdvlkpro">
<primary sortas="c-amdvlkpro">amdvlkpro{64,32}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libamdenc64">
<term><filename class="libraryfile">libamdenc64</filename></term>
<listitem>
<para>
handles encoding for AMDGPU cards
</para>
<indexterm zone="amdgpu-pro libamdenc64">
<primary sortas="c-libamdenc64">libamdenc64</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libamfrt64">
<term><filename class="libraryfile">libamfrt64</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</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libGLX_amd">
<term><filename class="libraryfile">libGLX_amd</filename></term>
<listitem>
<para>
is the AMD version of GLX
</para>
<indexterm zone="amdgpu-pro libGLX_amd">
<primary sortas="c-libGLX_amd">libGLX_amd</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>