source: x/installing/mesa.xml@ c28df1a

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since c28df1a was c28df1a, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to mesa-17.2.3.
Update to libXfont 1.5.3.
Update to libinput-1.9.0.
Update to harfbuzz-1.6.0.

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

  • Property mode set to 100644
File size: 15.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 mesa-download-http "https://mesa.freedesktop.org/archive/mesa-&mesa-version;.tar.xz">
8 <!ENTITY mesa-download-ftp "ftp://ftp.freedesktop.org/pub/mesa/mesa-&mesa-version;.tar.xz">
9 <!ENTITY mesa-md5sum "a7dca71afbc7294cb7d505067fd44ef6">
10 <!ENTITY mesa-size "9.9 MB">
11 <!ENTITY mesa-buildsize "348 MB (with demos and docs, add 53 MB for tests)">
12 <!ENTITY mesa-time "3.7 SBU (with parallelism=4, demos, and docs; add 0.7 SBU for tests)">
13]>
14
15<sect1 id="mesa" xreflabel="Mesa-&mesa-version;">
16 <?dbhtml filename="mesa.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Mesa-&mesa-version;</title>
24
25 <indexterm zone="mesa">
26 <primary sortas="a-Mesa">Mesa</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Mesa</title>
31
32 <para>
33 <application>Mesa</application> is an OpenGL compatible 3D graphics
34 library.
35 </para>
36
37 &lfs81_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&mesa-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&mesa-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &mesa-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &mesa-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &mesa-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &mesa-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
74 <itemizedlist spacing="compact">
75 <listitem>
76 <para>
77 Recommended patch:
78 <ulink
79 url="&patch-root;/mesa-&mesa-version;-add_xdemos-1.patch"/>
80 (installs 2 demo programs for testing Mesa - not needed if you
81 install the <ulink url="ftp://ftp.freedesktop.org/pub/mesa/demos/">
82 mesa-demos</ulink> package)
83 </para>
84 </listitem>
85 </itemizedlist>
86
87 <bridgehead renderas="sect3">Mesa Dependencies</bridgehead>
88
89 <bridgehead renderas="sect4">Required</bridgehead>
90 <para role="required">
91 <xref linkend="xorg7-lib"/>,
92 <xref linkend="libdrm"/>,
93 <xref linkend="Mako"/>, and
94 <xref linkend="python2"/>
95 </para>
96
97 <bridgehead renderas="sect4">Recommended</bridgehead>
98 <para role="recommended">
99 <xref linkend="elfutils"/> (required for the radeonsi driver),
100
101 <phrase revision="systemd"><xref linkend="libva"/> (to build drivers for
102 supported hardware, note that there is a circular dependency. You must
103 build <application>libva</application> first without EGL and GLX support,
104 install this package, and rebuild <application>libva</application>.),</phrase>
105
106 <xref linkend="libvdpau"/> (to build VDPAU drivers),
107
108 <xref linkend="llvm"/> (required for Gallium3D, r300, and radeonsi
109 drivers and for the llvmpipe software rasterizer. See <ulink role="nodep"
110 url="http://www.mesa3d.org/systems.html"/> for more information)<phrase
111 revision="systemd">, and
112 <xref linkend="wayland"/> (required for <xref role="nodep"
113 linkend='plasma5-build'/>,
114 <xref role="nodep" linkend='lxqt'/>, and GNOME)</phrase>
115 </para>
116
117 <bridgehead renderas="sect4">Optional</bridgehead>
118 <para role="optional">
119 <xref linkend="libgcrypt"/>,
120 <xref linkend="nettle"/>,
121 <phrase revision="sysv"><xref linkend="wayland"/> (required for
122 <xref role="nodep" linkend='plasma5-build'/> and
123 <xref role="nodep" linkend='lxqt'/>),</phrase>
124 <ulink url="ftp://ftp.freedesktop.org/pub/mesa/demos/">mesa-demos</ulink>
125 (provides more than 300 extra demos to test
126 <application>Mesa</application>; this includes the same programs added by
127 the patch above), and
128 <ulink url="http://omxil.sourceforge.net/">Bellagio OpenMAX Integration
129 Layer</ulink> (for mobile platforms)
130 </para>
131
132 <note>
133 <para>
134 The instructions below assume that <application>elfutils</application>
135 and <application>LLVM</application> with the r600/amdgpu and host
136 backends are installed. You will need to modify the instructions if you
137 choose not to install them. For an explanation of Gallium3D see
138 <ulink url="https://en.wikipedia.org/wiki/Gallium3D"/>.
139 </para>
140 </note>
141
142 <para condition="html" role="usernotes">User Notes:
143 <ulink url="&blfs-wiki;/mesa"/>
144 </para>
145 </sect2>
146
147 <sect2 role="installation">
148 <title>Installation of Mesa</title>
149
150 <para>
151 If you have downloaded the xdemos patch (needed if testing the Xorg
152 installation per BLFS instructions), apply it by running the following
153 command:
154 </para>
155
156<screen><userinput>patch -Np1 -i ../mesa-&mesa-version;-add_xdemos-1.patch</userinput></screen>
157
158 <!-- Note that freedreno, vc4, and virgl all need special support from
159 libdrm - renodr -->
160 <para>Now, select the drivers you wish to install. The available drivers
161 are i915, nouveau, r300, r600, radeonsi, freedreno, svga, swrast, vc4,
162 and virgl. If the Gallium drivers are not specified, the default is
163 'r300,r600,svga,swrast'. Modify the command below for any desired drivers.
164 The listed drivers below will cover most modern video cards. For help in
165 selecting drivers see
166 <ulink url='http://www.mesa3d.org/systems.html'/>.</para>
167
168<screen><userinput>GLL_DRV="i915,r600,nouveau,radeonsi,svga,swrast"</userinput></screen>
169
170 <para>
171 Install <application>Mesa</application> by running the following
172 commands:
173 </para>
174
175 <note revision="sysv">
176 <para>
177 Add wayland to the <parameter>--with-platforms</parameter> switch
178 below if you plan on building
179 <xref linkend='plasma5-build'/> or <xref linkend='lxqt'/>.
180 </para>
181 </note>
182
183<screen revision="sysv"><userinput>./configure CFLAGS='-O2' CXXFLAGS='-O2' \
184 --prefix=$XORG_PREFIX \
185 --sysconfdir=/etc \
186 --enable-texture-float \
187 --enable-osmesa \
188 --enable-xa \
189 --enable-glx-tls \
190 --with-platforms="drm,x11" \
191 --with-gallium-drivers=$GLL_DRV &amp;&amp;
192
193unset GLL_DRV &amp;&amp;
194
195make</userinput></screen>
196<screen revision="systemd"><userinput>./configure CFLAGS='-O2' CXXFLAGS='-O2' \
197 --prefix=$XORG_PREFIX \
198 --sysconfdir=/etc \
199 --enable-texture-float \
200 --enable-osmesa \
201 --enable-xa \
202 --enable-glx-tls \
203 --with-platforms="drm,x11,wayland" \
204 --with-gallium-drivers=$GLL_DRV &amp;&amp;
205
206unset GLL_DRV &amp;&amp;
207
208make</userinput></screen>
209
210 <para>
211 If you have applied the xdemos patch, build the demo programs by
212 running the following command:
213 </para>
214
215<screen><userinput>make -C xdemos DEMOS_PREFIX=$XORG_PREFIX</userinput></screen>
216
217 <para>
218 To test the results, issue: <command>make check</command>.
219 </para>
220
221 <para>
222 Now, as the <systemitem class="username">root</systemitem> user:
223 </para>
224
225<screen role="root"><userinput>make install</userinput></screen>
226
227 <para>
228 If you have built the demo programs, install them by running the
229 following command as the
230 <systemitem class="username">root</systemitem> user:
231 </para>
232
233<screen role="root"><userinput>make -C xdemos DEMOS_PREFIX=$XORG_PREFIX install</userinput></screen>
234
235 <para>
236 If desired, install the optional documentation by running
237 the following commands as the
238 <systemitem class="username">root</systemitem> user:
239 </para>
240
241<screen role="root"><userinput>install -v -dm755 /usr/share/doc/mesa-&mesa-version; &amp;&amp;
242cp -rfv docs/* /usr/share/doc/mesa-&mesa-version;</userinput></screen>
243
244 </sect2>
245
246 <sect2 role="commands">
247 <title>Command Explanations</title>
248
249 <para>
250 <parameter>CFLAGS="-O2" CXXFLAGS="-O2"</parameter>: By default,
251 <application>Autoconf</application> sets CFLAGS and CXXFLAGS to
252 "-g -O2". That results in binaries and libraries being built with
253 debugging symbols which make them bigger. Override the default
254 flags to omit the -g compiler flag so the final libraries are smaller.
255 </para>
256
257 <para>
258 <parameter>--enable-texture-float</parameter>: This switch enables
259 floating-point textures and render buffers. Please consult
260 <filename>docs/patents.txt</filename> to see if there are
261 any legal issues if you use this feature.
262 </para>
263
264 <para>
265 <parameter>--enable-osmesa</parameter>: This switch enables building
266 the <filename class="libraryfile">libOSMesa</filename> library.
267 </para>
268
269 <para>
270 <parameter>--enable-xa</parameter>: This switch enables building the
271 XA X Acceleration API (Required for VMware 3D Driver).
272 </para>
273
274 <para>
275 <parameter>--enable-gbm</parameter>: This switch enables building the
276 <application>Mesa</application> Graphics Buffer Manager library.
277 </para>
278
279 <para>
280 <parameter>--enable-glx-tls</parameter>: This switch enables TLS (Thread Local
281 Storage) support in GLX.
282 </para>
283
284 <para>
285 <parameter>--with-platforms="..."</parameter>: This parameter
286 controls which platforms EGL will be built for. Available
287 platforms are drm, x11 and wayland.
288 </para>
289
290 <para>
291 <parameter>--with-gallium-drivers="..."</parameter>: This parameter
292 controls which Gallium3D drivers should be built.
293 </para>
294
295 <para revision="sysv">
296 <option>--enable-sysfs</option>: Use this switch to enable simple PCI
297 identification method, required for building DRI on systems without udev.
298 </para>
299
300 </sect2>
301
302 <sect2 role="content">
303 <title>Contents</title>
304
305 <segmentedlist>
306 <segtitle>Installed Programs</segtitle>
307 <segtitle>Installed Libraries</segtitle>
308 <segtitle>Installed Directories</segtitle>
309
310 <seglistitem>
311 <seg>
312 glxgears and glxinfo
313 </seg>
314 <seg>
315 libEGL.so,
316 libgbm.so,
317 libglapi.so,
318 libGLESv1_CM.so,
319 libGLESv2.so,
320 libGL.so,
321 libOSMesa.so,
322<!-- Those libraries are associated with the "swr" gallium driver,
323 which has been removed at r17757. Keeping as a comment in case we
324 reintroduce that driver.
325 libswrAVX.so,
326 libswrAVX2.so,-->
327 libwayland-egl.so (if built with <application>Wayland</application>)
328 libxatracker.so,
329 libXvMCnouveau.so,
330 and libXvMCr600.so
331 </seg>
332 <seg>
333 $XORG_PREFIX/{include/{EGL,GL,GLES,GLES2,GLES3,KHR},lib/{dri,vdpau}}
334 and
335 /usr/share/doc/mesa-&mesa-version; (optional)
336 </seg>
337 </seglistitem>
338 </segmentedlist>
339
340 <variablelist>
341 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
342 <?dbfo list-presentation="list"?>
343 <?dbhtml list-presentation="table"?>
344
345 <varlistentry id="glxgears">
346 <term><command>glxgears</command></term>
347 <listitem>
348 <para>
349 is a GL demo useful for troubleshooting graphics
350 problems.
351 </para>
352 <indexterm zone="mesa glxgears">
353 <primary sortas="b-glxgears">glxgears</primary>
354 </indexterm>
355 </listitem>
356 </varlistentry>
357
358 <varlistentry id="glxinfo">
359 <term><command>glxinfo</command></term>
360 <listitem>
361 <para>
362 is a diagnostic program that displays information about the
363 graphics hardware and installed GL libraries.
364 </para>
365 <indexterm zone="mesa glxinfo">
366 <primary sortas="b-glxinfo">glxinfo</primary>
367 </indexterm>
368 </listitem>
369 </varlistentry>
370
371 <varlistentry id="libEGL">
372 <term><filename class="libraryfile">libEGL.so</filename></term>
373 <listitem>
374 <para>
375 provides a native platform graphics interface as
376 defined by the EGL-1.4 specification.
377 </para>
378 <indexterm zone="mesa libEGL">
379 <primary sortas="c-libGL">libEGL.so</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="libgbm">
385 <term><filename class="libraryfile">libgbm.so</filename></term>
386 <listitem>
387 <para>
388 is the <application>Mesa</application> Graphics Buffer
389 Manager library.
390 </para>
391 <indexterm zone="mesa libgbm">
392 <primary sortas="c-libgbm">libgbm.so</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="libGLESv1_CM">
398 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
399 <listitem>
400 <para>
401 is the <application>Mesa</application> OpenGL ES 1.1 library.
402 </para>
403 <indexterm zone="mesa libGLESv1_CM">
404 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="libGLES2">
410 <term><filename class="libraryfile">libGLES2.so</filename></term>
411 <listitem>
412 <para>
413 is the <application>Mesa</application> OpenGL ES 2.0 library.
414 </para>
415 <indexterm zone="mesa libGLES2">
416 <primary sortas="c-libGLES2">libGLES2.so</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 <varlistentry id="libGL">
422 <term><filename class="libraryfile">libGL.so</filename></term>
423 <listitem>
424 <para>
425 is the main <application>Mesa</application> OpenGL library.
426 </para>
427 <indexterm zone="mesa libGL">
428 <primary sortas="c-libGL">libGL.so</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 <varlistentry id="libOSMesa">
434 <term><filename class="libraryfile">libOSMesa.so</filename></term>
435 <listitem>
436 <para>
437 is the <application>Mesa</application> Off-screen Rendering library.
438 </para>
439 <indexterm zone="mesa libOSMesa">
440 <primary sortas="c-libOSMesa">libOSMesa.so</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="libxatracker">
446 <term><filename class="libraryfile">libxatracker.so</filename></term>
447 <listitem>
448 <para>
449 is the Xorg Gallium3D acceleration library.
450 </para>
451 <indexterm zone="mesa libxatracker">
452 <primary sortas="c-libxatracker">libxatracker.so</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456 </variablelist>
457
458 </sect2>
459
460</sect1>
Note: See TracBrowser for help on using the repository browser.