source: x/installing/mesa.xml@ 17ae4374

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 17ae4374 was 17ae4374, checked in by Douglas R. Reno <renodr@…>, 10 months ago

Update to WebKitGTK+-2.30.4

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

  • Property mode set to 100644
File size: 17.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 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 "e9242ee9a07a1d932bcf7b28284e2dcf">
10 <!ENTITY mesa-size "14 MB">
11 <!ENTITY mesa-buildsize "631 MB (with docs), add 317 MB for tests">
12 <!ENTITY mesa-time "2.7 SBU (with parallelism=4 and docs). Add 0.5 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 <note>
38 <para>
39 <application>Mesa</application> is updated relatively often. You may
40 want to use the latest available &mesa-major-minor;.x mesa version.
41 </para>
42 </note>
43
44 &lfs10_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&mesa-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&mesa-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &mesa-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &mesa-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &mesa-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &mesa-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
81 <itemizedlist spacing="compact">
82 <listitem>
83 <para>
84 Recommended patch:
85 <ulink url="&patch-root;/mesa-&mesa-version;-add_xdemos-1.patch"/>
86 (installs 2 demo programs for testing Mesa - not needed if you
87 install the <ulink url="ftp://ftp.freedesktop.org/pub/mesa/demos/">
88 mesa-demos</ulink> package)
89 </para>
90 </listitem>
91 </itemizedlist>
92
93 <bridgehead renderas="sect3">Mesa Dependencies</bridgehead>
94
95 <bridgehead renderas="sect4">Required</bridgehead>
96 <para role="required">
97 <xref linkend="xorg7-lib"/>,
98 <xref linkend="libdrm"/>, and
99 <xref linkend="Mako"/>
100 </para>
101
102 <bridgehead renderas="sect4">Recommended</bridgehead>
103 <para role="recommended">
104
105 <xref role="first" linkend="libva"/> (to provide VA-API support for some
106 gallium drivers, note that there is a circular dependency. You must
107 build <application>libva</application> first without EGL and GLX support,
108 install this package, and rebuild <application>libva</application>),
109 <xref linkend="libvdpau"/> (to build VDPAU drivers),
110 <xref linkend="llvm"/> (required for Gallium3D, nouveau, r300, and radeonsi
111 drivers and for swrast, the software rasterizer which is sometimes referred
112 to as llvmpipe. See <ulink role="nodep"
113 url="http://www.mesa3d.org/systems.html"/> for more information), and
114 <xref linkend="wayland-protocols"/> (required for
115 <xref role="nodep" linkend='plasma5-build'/>,
116 <!-- <xref role="nodep" linkend='lxqt'/>, -->
117 GNOME, and recommended for <xref role="nodep" linkend='gtk3'/>)
118 </para>
119
120 <bridgehead renderas="sect4">Optional</bridgehead>
121 <para role="optional">
122 <xref linkend="libgcrypt"/>,
123 <xref linkend="lm_sensors"/> <!-- for libsensors according to Meson -->,
124 <xref linkend="nettle"/>,
125 <xref linkend="valgrind"/>,
126 <ulink url="ftp://ftp.freedesktop.org/pub/mesa/demos/">mesa-demos</ulink>
127 (provides more than 300 extra demos to test
128 <application>Mesa</application>; this includes the same programs added by
129 the patch above),
130 <ulink url="http://omxil.sourceforge.net/">Bellagio OpenMAX Integration
131 Layer</ulink> (for mobile platforms),
132 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>, and
133 <ulink url="https://github.com/tizonia/tizonia-openmax-il/wiki/Tizonia-OpenMAX-IL/">
134 libtizonia</ulink>
135 </para>
136
137 <note>
138 <para>
139 The instructions below assume that
140 <application>LLVM</application> with the r600/amdgpu and host backends
141 and run-time type information (RTTI - needed for nouveau) are installed.
142 You will need to modify the instructions if you
143 choose not to install all of these. For an explanation of Gallium3D see
144 <ulink url="https://en.wikipedia.org/wiki/Gallium3D"/>.
145 </para>
146 </note>
147
148 <para condition="html" role="usernotes">User Notes:
149 <ulink url="&blfs-wiki;/mesa"/>
150 </para>
151 </sect2>
152
153 <sect2 role="installation">
154 <title>Installation of Mesa</title>
155
156 <para>
157 If you have downloaded the xdemos patch (needed if testing the Xorg
158 installation per BLFS instructions), apply it by running the following
159 command:
160 </para>
161
162<screen><userinput>patch -Np1 -i ../mesa-&mesa-version;-add_xdemos-1.patch</userinput></screen>
163
164 <!-- Note that freedreno, vc4, and virgl all need special support from
165 libdrm - renodr
166 For me, libdrm does not mention virgl, but mesa accepts it. AFAICS
167 freedreno is for qualcom hardware, libdrm will build for it on suitable
168 systems. VC4 is for the Broadcom VC4 used in the raspberry pi - ken -->
169
170 <para>
171 Adjust a script file in test suite to use Python 3, instead of the
172 obsolete Python 2:
173 </para>
174
175<screen><userinput>sed '1s/python/&amp;3/' -i bin/symbols-check.py</userinput></screen>
176
177 <note>
178 <para>
179 The measurements above, and the Contents below, are for a full build.
180 Many people will not wish to install drivers they cannot use, so the
181 following paragraphs explain how to limit the drivers, and give an
182 example which can be be reduced or amended as necessary.
183 </para>
184 </note>
185
186 <para>
187 Now, select the drivers you wish to install. For the X86 architecture, the
188 available gallium drivers are auto, <emphasis>or alternatively a choice
189 from</emphasis> i915, nouveau, r300, r600, radeonsi, svga, swrast, and
190 virgl. The latter is recommended if you intend to run the system under
191 <xref linkend="qemu"/>. If you wish to build all available gallium drivers,
192 use 'auto'.
193 </para>
194
195 <para>
196 The (non-gallium) DRI drivers available in X86 are auto, <emphasis>or
197 alternatively a choice from</emphasis> i915, i965, nouveau, r100, r200,
198 and swrast. Use 'auto' to build all available DRI drivers, or use an
199 empty string (DRI_DRIVERS="") if you wish to only build gallium drivers.
200 </para>
201
202 <para>
203 The platforms ("window systems") available for X86 linux are x11, wayland,
204 <!--drm,--> and surfaceless. By not specifying anything, the meson
205 build-system will build for all these platforms if you have the
206 dependencies, identical to if you had specified '-Dplatforms=auto'.
207 </para>
208
209 <para>
210 Modify the commands below for your desired drivers. The drivers listed
211 below will cover most modern video cards and virtual machines. For help in
212 selecting drivers see <ulink url='http://www.mesa3d.org/systems.html'/>.
213 </para>
214
215 <note>
216 <para>
217 Although the nouveau drivers can be built for both gallium and dri, the
218 i915 driver can only be built for one or the other.
219 </para>
220 </note>
221
222<screen><userinput>GALLIUM_DRV="i915,iris,nouveau,r600,radeonsi,svga,swrast,virgl"
223DRI_DRIVERS="i965,nouveau"</userinput></screen>
224
225 <para>
226 Install <application>Mesa</application> by running the following
227 commands:
228 </para>
229
230<screen><userinput>mkdir build &amp;&amp;
231cd build &amp;&amp;
232
233meson --prefix=$XORG_PREFIX \
234 -Dbuildtype=release \
235 -Ddri-drivers=$DRI_DRIVERS \
236 -Dgallium-drivers=$GALLIUM_DRV \
237 -Dgallium-nine=false \
238 -Dglx=dri \
239 -Dosmesa=gallium \
240 -Dvalgrind=false \
241 -Dlibunwind=false \
242 .. &amp;&amp;
243
244unset GALLIUM_DRV DRI_DRIVERS &amp;&amp;
245
246ninja</userinput></screen>
247
248 <para>
249 If you built the tests (see 'Command Explanations'), to run them issue:
250 <command>ninja test</command>.
251 Two tests in the llvmpipe suite are known to fail.
252 </para>
253
254 <para>
255 Now, as the <systemitem class="username">root</systemitem> user:
256 </para>
257
258<screen role="root"><userinput>ninja install</userinput></screen>
259
260 <para>
261 If desired, install the optional documentation by running
262 the following commands as the
263 <systemitem class="username">root</systemitem> user:
264 </para>
265
266<screen role="root"><userinput>install -v -dm755 /usr/share/doc/mesa-&mesa-version; &amp;&amp;
267cp -rfv ../docs/* /usr/share/doc/mesa-&mesa-version;</userinput></screen>
268
269 </sect2>
270
271 <sect2 role="commands">
272 <title>Command Explanations</title>
273
274 <para>
275 <parameter>-Dbuildtype=release</parameter>: This switch ensures a
276 fully-optimized build, and disables debug assertions which will
277 severely slow down the libraries in certain use-cases. Without this
278 switch, build sizes can span into the 2GB range.
279 </para>
280
281 <para>
282 <parameter>-Ddri-drivers="..."</parameter>: This parameter
283 controls which (non-gallium) dri drivers should be built.
284 </para>
285
286 <para>
287 <parameter>-Dgallium-drivers="..."</parameter>: This parameter
288 controls which Gallium3D drivers should be built.
289 </para>
290
291 <para>
292 <parameter>-Dgallium-nine=false</parameter>: Prevents building
293 support for (MS Windows) games designed for DX9. Set it to true if
294 this support is desired.
295 </para>
296
297 <para>
298 <parameter>-Dosmesa=gallium</parameter>: This switch enables building
299 the <filename class="libraryfile">libOSMesa</filename> library and
300 provides Gallium3D support in it. It requires the swrast gallium driver.
301 </para>
302<!--
303 <para>
304 <parameter>-Dplatforms="..."</parameter>: This parameter
305 controls which platforms EGL will be built for. Available
306 linux X86 platforms are drm, x11, wayland, and surfaceless.
307 </para>
308-->
309 <para>
310 <parameter>-Dvalgrind=false</parameter>: This parameter disables
311 the usage of Valgrind during the build process. Remove this parameter
312 if you have Valgrind installed, and wish to check for memory leaks.
313 </para>
314
315 <para>
316 <parameter>-Dlibunwind=false</parameter>: This parameter disables
317 the usage of libunwind.
318 </para>
319
320<!--
321 <para>
322 <parameter>- -enable-xa</parameter>: This switch enables building the
323 XA X Acceleration API (Required for VMware 3D Driver).
324 </para>
325
326 <para>
327 <parameter>- -enable-gbm</parameter>: This switch enables building the
328 <application>Mesa</application> Graphics Buffer Manager library.
329 </para>
330 These two seem to be automatic in 19.0 - ken
331
332 <para>
333 <parameter>- -enable-glx-tls</parameter>: This switch enables TLS (Thread Local
334 Storage) support in GLX.
335 </para>
336-->
337 <para>
338 <option>-Dbuild-tests=true</option>: This option will cause the test code
339 to be enabled.
340 </para>
341
342 </sect2>
343
344 <sect2 role="content">
345 <title>Contents</title>
346
347 <segmentedlist>
348 <segtitle>Installed Programs</segtitle>
349 <segtitle>Installed Libraries</segtitle><!-- in /usr/lib -->
350 <segtitle>Installed Drivers</segtitle><!-- in /usr/lib/<subdir> -->
351 <segtitle>Installed Directories</segtitle>
352
353 <seglistitem>
354 <seg>
355 glxgears and glxinfo
356 </seg>
357 <seg>
358 libEGL.so,
359 libGL.so,
360 libGLESv1_CM.so,
361 libGLESv2.so,
362 libOSMesa.so,
363 libXvMCnouveau.so,
364 libXvMCr600.so,
365 libgbm.so,
366 libglapi.so,
367 <!-- Begin Vulkan drivers -->
368 libvulkan_intel.so,
369 libvulkan_lvp.so,
370 libvulkan_radeon.so, and
371 <!-- End Vulkan drivers -->
372 libxatracker.so,
373 </seg>
374 <seg>
375 <!-- Begin DRI drivers : this is the full set from auto -->
376 d3dadapter9.so (optional), <!-- For Windows games. This is DirectX's
377 Direct3D -->
378 i915_dri.so,
379 i965_dri.so,
380 iris_dri.so,
381 kms_swrast_dri.so,
382 nouveau_dri.so,
383 nouveau_drv_video.so,
384 nouveau_vieux_dri.so,
385 r200_dri.so (optional),
386 r300_dri.so (optional),
387 r600_dri.so,
388 r600_drv_video.so,
389 radeon_dri.so,
390 radeonsi_dri.so,
391 radeonsi_drv_video.so,
392 swrast_dri.so,
393 virtio_gpu_dri.so,
394 vmwgfx_dri.so,
395 <!-- End DRI Drivers -->
396 <!-- Begin VDPAU drivers -->
397 libvdpau_nouveau.so,
398 libvdpau_r300.so (optional),
399 libvdpau_r600.so, and
400 libvdpau_radeonsi.so
401 <!-- End VDPAU drivers -->
402 </seg>
403 <seg>
404 $XORG_PREFIX/{include/{EGL,GL,GLES,GLES2,GLES3,KHR,vulkan},lib/{dri,vdpau}},
405 $XORG_PREFIX/include/d3adapter (optional),
406 $XORG_PREFIX/lib/d3d (optional),
407 $XORG_PREFIX/share/drirc.d (contains workarounds for various applications,
408 particularly browsers and games)
409 $XORG_PREFIX/share/vulkan/icd.d,
410 and
411 /usr/share/doc/mesa-&mesa-version; (optional)
412 </seg>
413 </seglistitem>
414 </segmentedlist>
415
416 <variablelist>
417 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
418 <?dbfo list-presentation="list"?>
419 <?dbhtml list-presentation="table"?>
420
421 <varlistentry id="glxgears">
422 <term><command>glxgears</command></term>
423 <listitem>
424 <para>
425 is a GL demo useful for troubleshooting graphics
426 problems.
427 </para>
428 <indexterm zone="mesa glxgears">
429 <primary sortas="b-glxgears">glxgears</primary>
430 </indexterm>
431 </listitem>
432 </varlistentry>
433
434 <varlistentry id="glxinfo">
435 <term><command>glxinfo</command></term>
436 <listitem>
437 <para>
438 is a diagnostic program that displays information about the
439 graphics hardware and installed GL libraries.
440 </para>
441 <indexterm zone="mesa glxinfo">
442 <primary sortas="b-glxinfo">glxinfo</primary>
443 </indexterm>
444 </listitem>
445 </varlistentry>
446
447 <varlistentry id="libEGL">
448 <term><filename class="libraryfile">libEGL.so</filename></term>
449 <listitem>
450 <para>
451 provides a native platform graphics interface as
452 defined by the EGL-1.4 specification.
453 </para>
454 <indexterm zone="mesa libEGL">
455 <primary sortas="c-libGL">libEGL.so</primary>
456 </indexterm>
457 </listitem>
458 </varlistentry>
459
460 <varlistentry id="libgbm">
461 <term><filename class="libraryfile">libgbm.so</filename></term>
462 <listitem>
463 <para>
464 is the <application>Mesa</application> Graphics Buffer
465 Manager library.
466 </para>
467 <indexterm zone="mesa libgbm">
468 <primary sortas="c-libgbm">libgbm.so</primary>
469 </indexterm>
470 </listitem>
471 </varlistentry>
472
473 <varlistentry id="libGLESv1_CM">
474 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
475 <listitem>
476 <para>
477 is the <application>Mesa</application> OpenGL ES 1.1 library.
478 </para>
479 <indexterm zone="mesa libGLESv1_CM">
480 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
481 </indexterm>
482 </listitem>
483 </varlistentry>
484
485 <varlistentry id="libGLES2">
486 <term><filename class="libraryfile">libGLES2.so</filename></term>
487 <listitem>
488 <para>
489 is the <application>Mesa</application> OpenGL ES 2.0 library.
490 </para>
491 <indexterm zone="mesa libGLES2">
492 <primary sortas="c-libGLES2">libGLES2.so</primary>
493 </indexterm>
494 </listitem>
495 </varlistentry>
496
497 <varlistentry id="libGL">
498 <term><filename class="libraryfile">libGL.so</filename></term>
499 <listitem>
500 <para>
501 is the main <application>Mesa</application> OpenGL library.
502 </para>
503 <indexterm zone="mesa libGL">
504 <primary sortas="c-libGL">libGL.so</primary>
505 </indexterm>
506 </listitem>
507 </varlistentry>
508
509 <varlistentry id="libOSMesa">
510 <term><filename class="libraryfile">libOSMesa.so</filename></term>
511 <listitem>
512 <para>
513 is the <application>Mesa</application> Off-screen Rendering library.
514 </para>
515 <indexterm zone="mesa libOSMesa">
516 <primary sortas="c-libOSMesa">libOSMesa.so</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520
521 </variablelist>
522
523 </sect2>
524
525</sect1>
Note: See TracBrowser for help on using the repository browser.