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

11.0 qt5new trunk
Last change on this file since 95a55b4a was 95a55b4a, checked in by Bruce Dubbs <bdubbs@…>, 4 months ago

Package updates
Update to Jinja2-3.0.1 (Python Module)
Update to MarkupSafe-2.0.1 (Python Module)
Update to Test-Differences-0.68 (Perl Module)
Update to libdrm-2.4.106

  • Property mode set to 100644
File size: 7.8 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 &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 </sect2>
148
149 <sect2 role="content">
150 <title>Contents</title>
151
152 <segmentedlist>
153 <segtitle>Installed Programs</segtitle>
154 <segtitle>Installed Libraries</segtitle>
155 <segtitle>Installed Directories</segtitle>
156
157 <seglistitem>
158 <seg>
159 None
160 </seg>
161 <seg>
162 libdrm_amdgpu.so, libdrm_intel.so, libdrm_nouveau.so,
163 libdrm_radeon.so, libdrm.so, and libkms.so
164 </seg>
165 <seg>
166 /usr/include/libdrm, /usr/include/libkms, and /usr/share/libdrm
167 </seg>
168 </seglistitem>
169 </segmentedlist>
170
171 <variablelist>
172 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
173 <?dbfo list-presentation="list"?>
174 <?dbhtml list-presentation="table"?>
175
176 <varlistentry id="libdrm_amdgpu">
177 <term><filename class="libraryfile">libdrm_amdgpu.so</filename></term>
178 <listitem>
179 <para>
180 contains the AMDGPU specific Direct Rendering Manager functions
181 </para>
182 <indexterm zone="libdrm libdrm_amdgpu">
183 <primary sortas="c-libdrm_amdgpu">libdrm_amdgpu.so</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="libdrm_intel">
189 <term><filename class="libraryfile">libdrm_intel.so</filename></term>
190 <listitem>
191 <para>
192 contains the Intel specific Direct Rendering Manager
193 functions
194 </para>
195 <indexterm zone="libdrm libdrm_intel">
196 <primary sortas="c-libdrm_intel">libdrm_intel.so</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="libdrm_nouveau">
202 <term><filename class="libraryfile">libdrm_nouveau.so</filename></term>
203 <listitem>
204 <para>
205 contains the open source nVidia (Nouveau) specific Direct
206 Rendering Manager functions
207 </para>
208 <indexterm zone="libdrm libdrm_nouveau">
209 <primary sortas="c-libdrm_nouveau">libdrm_nouveau.so</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="libdrm_radeon">
215 <term><filename class="libraryfile">libdrm_radeon.so</filename></term>
216 <listitem>
217 <para>
218 contains the AMD Radeon specific Direct Rendering Manager
219 functions
220 </para>
221 <indexterm zone="libdrm libdrm_radeon">
222 <primary sortas="c-libdrm_radeon">libdrm_radeon.so</primary>
223 </indexterm>
224 </listitem>
225 </varlistentry>
226
227 <varlistentry id="libdrm-lib">
228 <term><filename class="libraryfile">libdrm.so</filename></term>
229 <listitem>
230 <para>
231 contains the Direct Rendering Manager API functions
232 </para>
233 <indexterm zone="libdrm libdrm-lib">
234 <primary sortas="c-libdrm">libdrm.so</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="libkms">
240 <term><filename class="libraryfile">libkms.so</filename></term>
241 <listitem>
242 <para>
243 contains API functions for kernel mode setting abstraction
244 </para>
245 <indexterm zone="libdrm libkms">
246 <primary sortas="c-libkms">libkms.so</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 </variablelist>
252
253 </sect2>
254
255</sect1>
Note: See TracBrowser for help on using the repository browser.