source: x/lib/libdrm.xml@ 724fc4d1

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since 724fc4d1 was 724fc4d1, checked in by Douglas R. Reno <renodr@…>, 4 months ago

libdrm: Fix building sysprof by disabling valgrind in libdrm.

  • Property mode set to 100644
File size: 8.1 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 "4e316ae1966a1a63c31a3885313a8fb8">
10 <!ENTITY libdrm-size "412 KB">
11 <!ENTITY libdrm-buildsize "10 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 &lfs101_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 -Dudev=true -Dvalgrind=false &amp;&amp;
113ninja</userinput></screen>
114
115 <para>
116 To check the results, issue <command>ninja test</command>. <!--One test,
117 'threaded' in the nouveau subdirectory, is known to fail with a
118 30 second timeout.-->
119 <!-- Regarding the 'threaded' test, it's now skipped by default (2.4.102)
120 -renodr -->
121
122 <!-- Tests may hang
123 for unknown reasons. --><!-- If nouveau threaded test hangs, you can disable it
124 with
125 <command>sed -i 's/^TESTS/#&amp;/' tests/nouveau/Makefile.in</command>.
126
127 Now that tests are run with ninja, the test merely times out after 30 seconds.
128 -->
129 </para>
130
131 <para>
132 Now, as the <systemitem class="username">root</systemitem> user:
133 </para>
134
135<screen role="root"><userinput>ninja install</userinput></screen>
136
137 </sect2>
138
139 <sect2 role="commands">
140 <title>Command Explanations</title>
141
142 <para>
143 <parameter>-Dudev=true</parameter>: This parameter enables support for using
144 <application>Udev</application> instead of <command>mknod</command>.
145 </para>
146
147 <para>
148 <parameter>-Dvalgrind=false</parameter>: This parameter disables building
149 libdrm with valgrind support. This fixes building sysprof and other
150 packages that use libdrm. Change this parameter to "true" if you need
151 support for valgrind.
152 </para>
153
154 </sect2>
155
156 <sect2 role="content">
157 <title>Contents</title>
158
159 <segmentedlist>
160 <segtitle>Installed Programs</segtitle>
161 <segtitle>Installed Libraries</segtitle>
162 <segtitle>Installed Directories</segtitle>
163
164 <seglistitem>
165 <seg>
166 None
167 </seg>
168 <seg>
169 libdrm_amdgpu.so, libdrm_intel.so, libdrm_nouveau.so,
170 libdrm_radeon.so, libdrm.so, and libkms.so
171 </seg>
172 <seg>
173 /usr/include/libdrm, /usr/include/libkms, and /usr/share/libdrm
174 </seg>
175 </seglistitem>
176 </segmentedlist>
177
178 <variablelist>
179 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
180 <?dbfo list-presentation="list"?>
181 <?dbhtml list-presentation="table"?>
182
183 <varlistentry id="libdrm_amdgpu">
184 <term><filename class="libraryfile">libdrm_amdgpu.so</filename></term>
185 <listitem>
186 <para>
187 contains the AMDGPU specific Direct Rendering Manager functions
188 </para>
189 <indexterm zone="libdrm libdrm_amdgpu">
190 <primary sortas="c-libdrm_amdgpu">libdrm_amdgpu.so</primary>
191 </indexterm>
192 </listitem>
193 </varlistentry>
194
195 <varlistentry id="libdrm_intel">
196 <term><filename class="libraryfile">libdrm_intel.so</filename></term>
197 <listitem>
198 <para>
199 contains the Intel specific Direct Rendering Manager
200 functions
201 </para>
202 <indexterm zone="libdrm libdrm_intel">
203 <primary sortas="c-libdrm_intel">libdrm_intel.so</primary>
204 </indexterm>
205 </listitem>
206 </varlistentry>
207
208 <varlistentry id="libdrm_nouveau">
209 <term><filename class="libraryfile">libdrm_nouveau.so</filename></term>
210 <listitem>
211 <para>
212 contains the open source nVidia (Nouveau) specific Direct
213 Rendering Manager functions
214 </para>
215 <indexterm zone="libdrm libdrm_nouveau">
216 <primary sortas="c-libdrm_nouveau">libdrm_nouveau.so</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="libdrm_radeon">
222 <term><filename class="libraryfile">libdrm_radeon.so</filename></term>
223 <listitem>
224 <para>
225 contains the AMD Radeon specific Direct Rendering Manager
226 functions
227 </para>
228 <indexterm zone="libdrm libdrm_radeon">
229 <primary sortas="c-libdrm_radeon">libdrm_radeon.so</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="libdrm-lib">
235 <term><filename class="libraryfile">libdrm.so</filename></term>
236 <listitem>
237 <para>
238 contains the Direct Rendering Manager API functions
239 </para>
240 <indexterm zone="libdrm libdrm-lib">
241 <primary sortas="c-libdrm">libdrm.so</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="libkms">
247 <term><filename class="libraryfile">libkms.so</filename></term>
248 <listitem>
249 <para>
250 contains API functions for kernel mode setting abstraction
251 </para>
252 <indexterm zone="libdrm libkms">
253 <primary sortas="c-libkms">libkms.so</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 </variablelist>
259
260 </sect2>
261
262</sect1>
Note: See TracBrowser for help on using the repository browser.