mirror of
https://github.com/glfs-book/glfs.git
synced 2025-08-16 17:15:44 +00:00

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>.
298 lines
13 KiB
XML
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 > x86_64-amdgpu-pro-wget-list << "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 &&
|
|
cd x86_64-amdgpu-pro &&
|
|
|
|
grep -v '^#' ../x86_64-amdgpu-pro-wget-list | wget -i- -c \
|
|
-B &amdgpu-pro-download-http; &&
|
|
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 usr/lib/dri/* &&
|
|
cp -a opt/amdgpu/lib/x86_64-linux-gnu/dri/* usr/lib/dri/ &&
|
|
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>
|
|
|
|
<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>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 &&
|
|
cd i386-amdgpu-pro &&
|
|
|
|
grep -v '^#' ../i386-amdgpu-pro-wget-list | wget -i- -c \
|
|
-B &amdgpu-pro-download-http; &&
|
|
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/lib32/dri/* &&
|
|
cp -a opt/amdgpu/lib/i386-linux-gnu/dri/* usr/lib32/dri/ &&
|
|
rm -rf usr/lib &&
|
|
rm -rf usr/lib32/amdgpu-pro &&
|
|
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="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>
|