source: x/lib/libdrm.xml@ 0f2a3eb

10.0 10.1 11.0 11.1 8.4 9.0 9.1 bdubbs/svn lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 0f2a3eb was 0f2a3eb, checked in by Douglas R. Reno <renodr@…>, 4 years ago

Update to vala-0.42.5
Update to libdrm-2.4.97

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

  • Property mode set to 100644
File size: 7.5 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.bz2">
8 <!ENTITY libdrm-download-ftp " ">
9 <!ENTITY libdrm-md5sum "acef22d0c62c89692348c2dd5591393e">
10 <!ENTITY libdrm-size "820 KB">
11 <!ENTITY libdrm-buildsize "13 MB (with tests)">
12 <!ENTITY libdrm-time "less than 0.1 SBU (add 0.8 SBU for tests)">
13]>
14
15<sect1 id="libdrm" xreflabel="libdrm-&libdrm-version;">
16 <?dbhtml filename="libdrm.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
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 &lfs83_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="DocBook"/>,
87 <xref linkend="docbook-xsl"/> and
88 <xref linkend="libxslt"/> (to build manual pages),
89 <xref linkend="valgrind"/>, and
90 <ulink url="http://cunit.sourceforge.net/">CUNIT</ulink> (for AMDGPU tests)
91 </para>
92
93 <para condition="html" role="usernotes">User Notes:
94 <ulink url="&blfs-wiki;/libdrm"/>
95 </para>
96 </sect2>
97
98 <sect2 role="installation">
99 <title>Installation of libdrm</title>
100
101 <para>
102 Install <application>libdrm</application> by running the following
103 commands:
104 </para>
105
106<screen><userinput>mkdir build &amp;&amp;
107cd build &amp;&amp;
108
109meson --prefix=$XORG_PREFIX -Dudev=true &amp;&amp;
110ninja</userinput></screen>
111
112 <para>
113 To check the results, issue <command>ninja test</command>. One test,
114 'threaded' in the nouveau subdirectory, is known to fail with a
115 30 second timeout.
116
117 <!-- Tests may hang
118 for unknown reasons. --><!-- If nouveau threaded test hangs, you can disable it
119 with
120 <command>sed -i 's/^TESTS/#&amp;/' tests/nouveau/Makefile.in</command>.
121
122 Now that tests are run with ninja, the test merely times out after 30 seconds.
123 -->
124 </para>
125
126 <para>
127 Now, as the <systemitem class="username">root</systemitem> user:
128 </para>
129
130<screen role="root"><userinput>ninja install</userinput></screen>
131
132 </sect2>
133
134 <sect2 role="commands">
135 <title>Command Explanations</title>
136
137 <para>
138 <parameter>-Dudev=true</parameter>: This parameter enables support for using
139 <application>Udev</application> instead of <command>mknod</command>.
140 </para>
141
142 </sect2>
143
144 <sect2 role="content">
145 <title>Contents</title>
146
147 <segmentedlist>
148 <segtitle>Installed Programs</segtitle>
149 <segtitle>Installed Libraries</segtitle>
150 <segtitle>Installed Directories</segtitle>
151
152 <seglistitem>
153 <seg>
154 None
155 </seg>
156 <seg>
157 libdrm_amdgpu.so, libdrm_intel.so, libdrm_nouveau.so,
158 libdrm_radeon.so, libdrm.so, and libkms.so
159 </seg>
160 <seg>
161 /usr/include/libdrm, /usr/include/libkms, and /usr/share/libdrm
162 </seg>
163 </seglistitem>
164 </segmentedlist>
165
166 <variablelist>
167 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
168 <?dbfo list-presentation="list"?>
169 <?dbhtml list-presentation="table"?>
170
171 <varlistentry id="libdrm_amdgpu">
172 <term><filename class="libraryfile">libdrm_amdgpu.so</filename></term>
173 <listitem>
174 <para>
175 contains the AMDGPU specific Direct Rendering Manager functions.
176 </para>
177 <indexterm zone="libdrm libdrm_amdgpu">
178 <primary sortas="c-libdrm_amdgpu">libdrm_amdgpu.so</primary>
179 </indexterm>
180 </listitem>
181 </varlistentry>
182
183 <varlistentry id="libdrm_intel">
184 <term><filename class="libraryfile">libdrm_intel.so</filename></term>
185 <listitem>
186 <para>
187 contains the Intel specific Direct Rendering Manager
188 functions.
189 </para>
190 <indexterm zone="libdrm libdrm_intel">
191 <primary sortas="c-libdrm_intel">libdrm_intel.so</primary>
192 </indexterm>
193 </listitem>
194 </varlistentry>
195
196 <varlistentry id="libdrm_nouveau">
197 <term><filename class="libraryfile">libdrm_nouveau.so</filename></term>
198 <listitem>
199 <para>
200 contains the open source nVidia (Nouveau) specific Direct
201 Rendering Manager functions.
202 </para>
203 <indexterm zone="libdrm libdrm_nouveau">
204 <primary sortas="c-libdrm_nouveau">libdrm_nouveau.so</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="libdrm_radeon">
210 <term><filename class="libraryfile">libdrm_radeon.so</filename></term>
211 <listitem>
212 <para>
213 contains the AMD Radeon specific Direct Rendering Manager
214 functions.
215 </para>
216 <indexterm zone="libdrm libdrm_radeon">
217 <primary sortas="c-libdrm_radeon">libdrm_radeon.so</primary>
218 </indexterm>
219 </listitem>
220 </varlistentry>
221
222 <varlistentry id="libdrm-lib">
223 <term><filename class="libraryfile">libdrm.so</filename></term>
224 <listitem>
225 <para>
226 contains the Direct Rendering Manager API functions.
227 </para>
228 <indexterm zone="libdrm libdrm-lib">
229 <primary sortas="c-libdrm">libdrm.so</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="libkms">
235 <term><filename class="libraryfile">libkms.so</filename></term>
236 <listitem>
237 <para>
238 contains API functions for kernel mode setting abstraction.
239 </para>
240 <indexterm zone="libdrm libkms">
241 <primary sortas="c-libkms">libkms.so</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 </variablelist>
247
248 </sect2>
249
250</sect1>
Note: See TracBrowser for help on using the repository browser.