source: x/installing/mesa.xml@ b4c475d

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b4c475d was b4c475d, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Update to subversion-1.12.0.
Update to qca-2.2.1.
Update to mesa-19.0.3.
Update to cogl-1.22.4.
Update to qemu-4.0.0.
Update to cmake-3.14.3.

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

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