source: x/lib/libdrm.xml@ 95f2d4b

11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 95f2d4b was 95f2d4b, checked in by Bruce Dubbs <bdubbs@…>, 8 months ago

Package updates.
Update to mousepad-0.5.8.
Update to libdrm-2.4.109.
Update to php-8.1.0.
Update to libreoffice-7.2.3.2.

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