source: x/lib/libdrm.xml@ f4371a4

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since f4371a4 was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 19 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.

  • Property mode set to 100644
File size: 8.4 KB
RevLine 
[868c7c2]1<?xml version="1.0" encoding="ISO-8859-1"?>
[6732c094]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[868c7c2]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[0f5317a4]7 <!ENTITY libdrm-download-http "https://dri.freedesktop.org/libdrm/libdrm-&libdrm-version;.tar.xz">
[aa7a7fb]8 <!ENTITY libdrm-download-ftp " ">
[a82edc7]9 <!ENTITY libdrm-md5sum "07759750351465e5dd39f4fe40f000ea">
10 <!ENTITY libdrm-size "464 KB">
11 <!ENTITY libdrm-buildsize "8.2 MB (with tests)">
[80eea7aa]12 <!ENTITY libdrm-time "0.1 SBU (with tests)">
[f4327ad9]13 <!-- With version 2.4.102, the tests add 1 second to my build. -->
[f1a479c7]14 <!-- The 'threaded' test adds about 15 seconds if you're on an NVIDIA system
15 due to it directly interacting with the GPU. -->
[868c7c2]16]>
17
18<sect1 id="libdrm" xreflabel="libdrm-&libdrm-version;">
19 <?dbhtml filename="libdrm.html"?>
20
21
22 <title>libdrm-&libdrm-version;</title>
23
24 <indexterm zone="libdrm">
25 <primary sortas="a-libdrm">libdrm</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to libdrm</title>
30
[3bbf74c5]31 <para>
[ef704b0]32 <application>libdrm</application> provides a user space library for
[3538884]33 accessing the DRM, direct rendering manager, on operating systems that
34 support the ioctl interface. libdrm is a low-level library, typically used
35 by graphics drivers such as the Mesa DRI drivers, the X drivers, libva and
36 similar projects.
[3bbf74c5]37 </para>
[868c7c2]38
[aa0b625]39 &lfs112_checked;
[1ed7820]40
[868c7c2]41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
[3bbf74c5]44 <para>
45 Download (HTTP): <ulink url="&libdrm-download-http;"/>
46 </para>
[868c7c2]47 </listitem>
48 <listitem>
[3bbf74c5]49 <para>
50 Download (FTP): <ulink url="&libdrm-download-ftp;"/>
51 </para>
[868c7c2]52 </listitem>
53 <listitem>
[3bbf74c5]54 <para>
55 Download MD5 sum: &libdrm-md5sum;
56 </para>
[868c7c2]57 </listitem>
58 <listitem>
[3bbf74c5]59 <para>
60 Download size: &libdrm-size;
61 </para>
[868c7c2]62 </listitem>
63 <listitem>
[3bbf74c5]64 <para>
65 Estimated disk space required: &libdrm-buildsize;
66 </para>
[868c7c2]67 </listitem>
68 <listitem>
[3bbf74c5]69 <para>
70 Estimated build time: &libdrm-time;
71 </para>
[868c7c2]72 </listitem>
73 </itemizedlist>
74
[10e02da]75 <bridgehead renderas="sect3">libdrm Dependencies</bridgehead>
76
[3538884]77 <bridgehead renderas="sect4">Recommended</bridgehead>
78 <para role="recommended">
[6121fe5]79 <xref linkend="xorg7-lib"/> (for Intel KMS API support required by Mesa)
[0d6e0af]80 </para>
[10e02da]81
[0d6e0af]82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
[597ac4bd]84 <xref linkend="cairo"/> (for tests),
[7292e01]85 <xref linkend="cmake"/> (could be used to find dependencies without pkgconfig files),
[e520239f]86 <xref linkend="DocBook"/>,
[4d59e9e]87 <xref linkend="docbook-xsl"/>,
88 <xref linkend="docutils"/>, and
[597ac4bd]89 <xref linkend="libxslt"/> (to build manual pages),
[7292e01]90 <xref linkend="libatomic_ops"/> (required by architectures without native atomic operations),
[597ac4bd]91 <xref linkend="valgrind"/>, and
92 <ulink url="http://cunit.sourceforge.net/">CUNIT</ulink> (for AMDGPU tests)
[0d6e0af]93 </para>
[14dcfecb]94
[c5c2654]95 <para condition="html" role="usernotes">User Notes:
[3bbf74c5]96 <ulink url="&blfs-wiki;/libdrm"/>
97 </para>
[868c7c2]98 </sect2>
99
100 <sect2 role="installation">
101 <title>Installation of libdrm</title>
102
[3bbf74c5]103 <para>
104 Install <application>libdrm</application> by running the following
105 commands:
106 </para>
[868c7c2]107
[49df687a]108<screen><userinput>mkdir build &amp;&amp;
[431f388]109cd build &amp;&amp;
110
[adf17153]111meson --prefix=$XORG_PREFIX \
112 --buildtype=release \
[388f1375]113 -Dudev=true \
[80eea7aa]114 -Dvalgrind=disabled &amp;&amp;
[49df687a]115ninja</userinput></screen>
[868c7c2]116
[3bbf74c5]117 <para>
[f4327ad9]118 To check the results, issue <command>ninja test</command>. <!--One test,
[8558044]119 'threaded' in the nouveau subdirectory, is known to fail with a
[f4327ad9]120 30 second timeout.-->
121 <!-- Regarding the 'threaded' test, it's now skipped by default (2.4.102)
122 -renodr -->
[8558044]123
[17756081]124 <!-- Tests may hang
[0f09c2b8]125 for unknown reasons. --><!-- If nouveau threaded test hangs, you can disable it
[68d5b0e]126 with
[8558044]127 <command>sed -i 's/^TESTS/#&amp;/' tests/nouveau/Makefile.in</command>.
128
[17756081]129 Now that tests are run with ninja, the test merely times out after 30 seconds.
130 -->
[3bbf74c5]131 </para>
[ad54ac8]132
[3bbf74c5]133 <para>
134 Now, as the <systemitem class="username">root</systemitem> user:
135 </para>
[868c7c2]136
[49df687a]137<screen role="root"><userinput>ninja install</userinput></screen>
[868c7c2]138
139 </sect2>
140
[7c472863]141 <sect2 role="commands">
142 <title>Command Explanations</title>
143
[adf17153]144 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
145 href="../../xincludes/meson-buildtype-release.xml"/>
146
[6eceb9c8]147 <para>
[49df687a]148 <parameter>-Dudev=true</parameter>: This parameter enables support for using
[6eceb9c8]149 <application>Udev</application> instead of <command>mknod</command>.
150 </para>
[a9ae025]151
[724fc4d1]152 <para>
[80eea7aa]153 <parameter>-Dvalgrind=disabled</parameter>: This parameter disables
154 building libdrm with valgrind support. This fixes building sysprof and
155 other packages that use libdrm. Change this parameter to "enabled"
156 (or remove it) if you need support for valgrind.
[724fc4d1]157 </para>
158
[7c472863]159 </sect2>
160
[868c7c2]161 <sect2 role="content">
162 <title>Contents</title>
163
164 <segmentedlist>
[c3c56b2]165 <segtitle>Installed Programs</segtitle>
[a1e27dc]166 <segtitle>Installed Libraries</segtitle>
[86f7fa0]167 <segtitle>Installed Directories</segtitle>
[868c7c2]168
169 <seglistitem>
[c3c56b2]170 <seg>
171 None
172 </seg>
[3bbf74c5]173 <seg>
[68d5b0e]174 libdrm_amdgpu.so, libdrm_intel.so, libdrm_nouveau.so,
[4956ae3]175 libdrm_radeon.so, and libdrm.so<!--, and libkms.so-->
[3bbf74c5]176 </seg>
177 <seg>
[1fe05eb]178 /usr/include/libdrm <!--,/usr/include/libkms,-->
[4956ae3]179 and /usr/share/libdrm
[3bbf74c5]180 </seg>
[868c7c2]181 </seglistitem>
182 </segmentedlist>
183
184 <variablelist>
185 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
186 <?dbfo list-presentation="list"?>
187 <?dbhtml list-presentation="table"?>
188
[68d5b0e]189 <varlistentry id="libdrm_amdgpu">
190 <term><filename class="libraryfile">libdrm_amdgpu.so</filename></term>
[868c7c2]191 <listitem>
[3bbf74c5]192 <para>
[4c24eb0a]193 contains the AMDGPU specific Direct Rendering Manager functions
[3bbf74c5]194 </para>
[68d5b0e]195 <indexterm zone="libdrm libdrm_amdgpu">
196 <primary sortas="c-libdrm_amdgpu">libdrm_amdgpu.so</primary>
[a07e9eb]197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="libdrm_intel">
202 <term><filename class="libraryfile">libdrm_intel.so</filename></term>
203 <listitem>
204 <para>
205 contains the Intel specific Direct Rendering Manager
[4c24eb0a]206 functions
[a07e9eb]207 </para>
208 <indexterm zone="libdrm libdrm_intel">
209 <primary sortas="c-libdrm_intel">libdrm_intel.so</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="libdrm_nouveau">
215 <term><filename class="libraryfile">libdrm_nouveau.so</filename></term>
216 <listitem>
217 <para>
218 contains the open source nVidia (Nouveau) specific Direct
[4c24eb0a]219 Rendering Manager functions
[a07e9eb]220 </para>
221 <indexterm zone="libdrm libdrm_nouveau">
222 <primary sortas="c-libdrm_nouveau">libdrm_nouveau.so</primary>
223 </indexterm>
224 </listitem>
225 </varlistentry>
226
[34122fa4]227 <varlistentry id="libdrm_radeon">
228 <term><filename class="libraryfile">libdrm_radeon.so</filename></term>
[68d5b0e]229 <listitem>
230 <para>
[34122fa4]231 contains the AMD Radeon specific Direct Rendering Manager
[4c24eb0a]232 functions
[68d5b0e]233 </para>
[34122fa4]234 <indexterm zone="libdrm libdrm_radeon">
235 <primary sortas="c-libdrm_radeon">libdrm_radeon.so</primary>
[68d5b0e]236 </indexterm>
237 </listitem>
238 </varlistentry>
239
[34122fa4]240 <varlistentry id="libdrm-lib">
241 <term><filename class="libraryfile">libdrm.so</filename></term>
[a07e9eb]242 <listitem>
243 <para>
[4c24eb0a]244 contains the Direct Rendering Manager API functions
[a07e9eb]245 </para>
[34122fa4]246 <indexterm zone="libdrm libdrm-lib">
247 <primary sortas="c-libdrm">libdrm.so</primary>
[7c472863]248 </indexterm>
249 </listitem>
250 </varlistentry>
[3bbf74c5]251
[4956ae3]252 <!-- Removed in 2.4.111
[a07e9eb]253 <varlistentry id="libkms">
254 <term><filename class="libraryfile">libkms.so</filename></term>
[7c472863]255 <listitem>
[3bbf74c5]256 <para>
[4c24eb0a]257 contains API functions for kernel mode setting abstraction
[3bbf74c5]258 </para>
[a07e9eb]259 <indexterm zone="libdrm libkms">
[7c472863]260 <primary sortas="c-libkms">libkms.so</primary>
[868c7c2]261 </indexterm>
262 </listitem>
263 </varlistentry>
[4956ae3]264 -->
[868c7c2]265
266 </variablelist>
267
268 </sect2>
269
270</sect1>
Note: See TracBrowser for help on using the repository browser.