source: x/lib/libdrm.xml@ 6b063cc3

10.1 11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6b063cc3 was 6b063cc3, checked in by Bruce Dubbs <bdubbs@…>, 7 months ago

Tag xorg

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24250 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • 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 "6b23163def82f540e2b5e2873b1c4b92">
10 <!ENTITY libdrm-size "412 KB">
11 <!ENTITY libdrm-buildsize "12 MB (with tests)">
12 <!ENTITY libdrm-time "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 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>libdrm-&libdrm-version;</title>
25
26 <indexterm zone="libdrm">
27 <primary sortas="a-libdrm">libdrm</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to libdrm</title>
32
33 <para>
34 <application>libdrm</application> provides a user space library for
35 accessing the DRM, direct rendering manager, on operating systems that
36 support the ioctl interface. libdrm is a low-level library, typically used
37 by graphics drivers such as the Mesa DRI drivers, the X drivers, libva and
38 similar projects.
39 </para>
40
41 &lfs101_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&libdrm-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&libdrm-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &libdrm-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &libdrm-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &libdrm-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &libdrm-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">libdrm Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Recommended</bridgehead>
80 <para role="recommended">
81 <xref linkend="xorg7-lib"/> (for Intel KMS API support required by Mesa)
82 </para>
83
84 <bridgehead renderas="sect4">Optional</bridgehead>
85 <para role="optional">
86 <xref linkend="cairo"/> (for tests),
87 <xref linkend="cmake"/> (could be used to find dependencies without pkgconfig files),
88 <xref linkend="DocBook"/>,
89 <xref linkend="docbook-xsl"/> 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.