source: x/installing/mesa.xml@ 93817f4

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 93817f4 was c823c075, checked in by Douglas R. Reno <renodr@…>, 4 years ago

Update to libmypaint-1.6.0
Update to Mesa-20.0.6

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23053 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 "82e4166a52a1023aace2dcdf223d6c8e">
10 <!ENTITY mesa-size "12 MB">
11 <!ENTITY mesa-buildsize "541 MB (with demos and docs), add 262 MB for tests">
12 <!ENTITY mesa-time "2.6 SBU (with parallelism=4, demos, and docs), add 0.4 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 &lfs91_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 role="first" linkend="libva"/> (to provide VA-API support for some
107 gallium 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),
133 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>, and
134 <ulink url="https://github.com/tizonia/tizonia-openmax-il/wiki/Tizonia-OpenMAX-IL/">
135 libtizonia</ulink>
136 </para>
137
138 <note>
139 <para>
140 The instructions below assume that
141 <application>LLVM</application> with the r600/amdgpu and host backends
142 and run-time type information (RTTI - needed for nouveau) are installed.
143 You will need to modify the instructions if you
144 choose not to install all of these. For an explanation of Gallium3D see
145 <ulink url="https://en.wikipedia.org/wiki/Gallium3D"/>.
146 </para>
147 </note>
148
149 <para condition="html" role="usernotes">User Notes:
150 <ulink url="&blfs-wiki;/mesa"/>
151 </para>
152 </sect2>
153
154 <sect2 role="installation">
155 <title>Installation of Mesa</title>
156
157 <para>
158 If you have downloaded the xdemos patch (needed if testing the Xorg
159 installation per BLFS instructions), apply it by running the following
160 command:
161 </para>
162
163<screen><userinput>patch -Np1 -i ../mesa-&mesa-version;-add_xdemos-1.patch</userinput></screen>
164
165 <!-- Note that freedreno, vc4, and virgl all need special support from
166 libdrm - renodr
167 For me, libdrm does not mention virgl, but mesa accepts it. AFAICS
168 freedreno is for qualcom hardware, libdrm will build for it on suitable
169 systems. VC4 is for the Broadcom VC4 used in the raspberry pi - ken -->
170
171 <para>
172 If <xref linkend="python2"/> is not installed, adjust a script file
173 in test suite to use Python 3:
174 </para>
175
176<screen><userinput>sed '1s/python/&amp;3/' -i bin/symbols-check.py</userinput></screen>
177
178 <note>
179 <para>
180 The measurements above, and the Contents below, are for a full build.
181 Many people will not wish to install drivers they cannot use, so the
182 following paragraphs explain how to limit the drivers, and give an
183 example which can be be reduced or amended as necessary.
184 </para>
185 </note>
186
187 <para>
188 Now, select the drivers you wish to install. For the X86 architecture, the
189 available gallium drivers are auto, <emphasis>or alternatively a choice
190 from</emphasis> i915, nouveau, r300, r600, radeonsi, svga, swrast, and
191 virgl. The latter is recommended if you intend to run the system under
192 <xref linkend="qemu"/>. If you wish to build all available gallium drivers,
193 use 'auto'.
194 </para>
195
196 <para>
197 The (non-gallium) DRI drivers available in X86 are auto, <emphasis>or
198 alternatively a choice from</emphasis> i915, i965, nouveau, r100, r200,
199 and swrast. Use 'auto' to build all available DRI drivers, or use an
200 empty string (DRI_DRIVERS="") if you wish to only build gallium drivers.
201 </para>
202
203 <para>
204 The platforms ("window systems") available for X86 linux are x11, wayland,
205 drm, and surfaceless. By not specifying anything, the meson build-system
206 will build for all these platforms if you have the dependencies, identical
207 to if you had specified '-Dplatforms=auto'.
208 </para>
209
210 <para>
211 Modify the commands below for your desired drivers. The drivers listed
212 below will cover most modern video cards and virtual machines. For help in
213 selecting drivers see <ulink url='http://www.mesa3d.org/systems.html'/>.
214 </para>
215
216 <note>
217 <para>
218 Although the nouveau drivers can be built for both gallium and dri, the
219 i915 driver can only be built for one or the other.
220 </para>
221 </note>
222
223 <!-- The iris driver has been temporarily removed from the below line.
224 With mesa-20.0.5, it caused crashes and occasional system lockups.
225 Exporting MESA_LOADER_DRIVER_OVERRIDE=i965 was able to fix it on
226 my Skylake (i5-6600k) system, but that overrides the iris driver.
227 Let's revisit this at a later time, maybe in a few releases or when
228 the hardware is more accessible. See
229 http://lists.linuxfromscratch.org/pipermail/blfs-dev/2020-April/037385.html
230 For more information/context.-->
231 <!-- Let's revisit Iris at 20.0.7, it's now known upstream -->
232
233<screen><userinput>GALLIUM_DRV="i915,nouveau,r600,radeonsi,svga,swrast,virgl"
234DRI_DRIVERS="i965,nouveau"</userinput></screen>
235
236 <para>
237 Install <application>Mesa</application> by running the following
238 commands:
239 </para>
240
241<screen><userinput>mkdir build &amp;&amp;
242cd build &amp;&amp;
243
244meson --prefix=$XORG_PREFIX \
245 -Dbuildtype=release \
246 -Ddri-drivers=$DRI_DRIVERS \
247 -Dgallium-drivers=$GALLIUM_DRV \
248 -Dgallium-nine=false \
249 -Dglx=dri \
250 -Dosmesa=gallium \
251 -Dvalgrind=false \
252 -Dlibunwind=false \
253 .. &amp;&amp;
254
255unset GALLIUM_DRV DRI_DRIVERS &amp;&amp;
256
257ninja</userinput></screen>
258
259 <para>
260 If you built the tests (see 'Command Explanations'), to run them issue:
261 <command>ninja test</command>.
262 </para>
263
264 <para>
265 Now, as the <systemitem class="username">root</systemitem> user:
266 </para>
267
268<screen role="root"><userinput>ninja install</userinput></screen>
269
270 <para>
271 If desired, install the optional documentation by running
272 the following commands as the
273 <systemitem class="username">root</systemitem> user:
274 </para>
275
276<screen role="root"><userinput>install -v -dm755 /usr/share/doc/mesa-&mesa-version; &amp;&amp;
277cp -rfv ../docs/* /usr/share/doc/mesa-&mesa-version;</userinput></screen>
278
279 </sect2>
280
281 <sect2 role="commands">
282 <title>Command Explanations</title>
283
284 <para>
285 <parameter>-Dbuildtype=release</parameter>: This switch ensures a
286 fully-optimized build, and disables debug assertions which will
287 severely slow down the libraries in certain use-cases. Without this
288 switch, build sizes can span into the 2GB range.
289 </para>
290
291 <para>
292 <parameter>-Ddri-drivers="..."</parameter>: This parameter
293 controls which (non-gallium) dri drivers should be built.
294 </para>
295
296 <para>
297 <parameter>-Dgallium-drivers="..."</parameter>: This parameter
298 controls which Gallium3D drivers should be built.
299 </para>
300
301 <para>
302 <option>-Dgallium-nine=true</option>: Setting this option to true will
303 provide support for (MS Windows) games designed for DX9.
304 </para>
305
306 <para>
307 <parameter>-Dosmesa=gallium</parameter>: This switch enables building
308 the <filename class="libraryfile">libOSMesa</filename> library and
309 provides Gallium3D support in it. It requires the swrast gallium driver.
310 </para>
311<!--
312 <para>
313 <parameter>-Dplatforms="..."</parameter>: This parameter
314 controls which platforms EGL will be built for. Available
315 linux X86 platforms are drm, x11, wayland, and surfaceless.
316 </para>
317-->
318 <para>
319 <parameter>-Dvalgrind=false</parameter>: This parameter disables
320 the usage of Valgrind during the build process. Remove this parameter
321 if you have Valgrind installed, and wish to check for memory leaks.
322 </para>
323
324<!--
325 <para>
326 <parameter>- -enable-xa</parameter>: This switch enables building the
327 XA X Acceleration API (Required for VMware 3D Driver).
328 </para>
329
330 <para>
331 <parameter>- -enable-gbm</parameter>: This switch enables building the
332 <application>Mesa</application> Graphics Buffer Manager library.
333 </para>
334 These two seem to be automatic in 19.0 - ken
335
336 <para>
337 <parameter>- -enable-glx-tls</parameter>: This switch enables TLS (Thread Local
338 Storage) support in GLX.
339 </para>
340-->
341 <para>
342 <option>-Dbuild-tests=true</option>: This option will cause the test code
343 to be enabled.
344 </para>
345
346 </sect2>
347
348 <sect2 role="content">
349 <title>Contents</title>
350
351 <segmentedlist>
352 <segtitle>Installed Programs</segtitle>
353 <segtitle>Installed Libraries</segtitle>
354 <segtitle>Installed Directories</segtitle>
355
356 <seglistitem>
357 <seg>
358 glxgears and glxinfo
359 </seg>
360 <seg>
361 <!-- Begin DRI drivers : this is the full set from auto -->
362 d3dadapter9.so, <!-- For Windows games. This is DirectX's Direct3D -->
363 i915_dri.so,
364 i965_dri.so,
365 kms_swrast_dri.so,
366 nouveau_dri.so,
367 nouveau_drv_video.so,
368 nouveau_vieux_dri.so,
369 r200_dri.so,
370 r300_dri.so,
371 r600_dri.so,
372 r600_drv_video.so,
373 radeon_dri.so,
374 radeonsi_dri.so,
375 radeonsi_drv_video.so,
376 swrast_dri.so,
377 virtio_gpu_dri.so,
378 vmwgfx_dri.so,
379 <!-- End DRI Drivers -->
380 libEGL.so,
381 libGL.so,
382 libGLESv1_CM.so,
383 libGLESv2.so,
384 libOSMesa.so,
385 libXvMCnouveau.so,
386 libXvMCr600.so,
387 libgbm.so,
388 libglapi.so,
389 <!-- Begin Vulkan drivers -->
390 libvulkan_intel.so,
391 libvulkan_radeon.so,
392 <!-- End Vulkan drivers -->
393 libxatracker.so,
394 <!-- Begin VDPAU drivers -->
395 libvdpau_nouveau.so,
396 libvdpau_r300.so,
397 libvdpau_r600.so, and
398 libvdpau_radeonsi.so
399 <!-- End VDPAU drivers -->
400 </seg>
401 <seg>
402 $XORG_PREFIX/{include/{d3dapater,EGL,GL,GLES,GLES2,GLES3,KHR,vulkan},lib/{d3d,dri,vdpau}}
403 $XORG_PREFIX/share/drirc.d (contains workarounds for various applications,
404 particularly browsers and games)
405 $XORG_PREFIX/share/vulkan/icd.d,
406 and
407 /usr/share/doc/mesa-&mesa-version; (optional)
408 </seg>
409 </seglistitem>
410 </segmentedlist>
411
412 <variablelist>
413 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
414 <?dbfo list-presentation="list"?>
415 <?dbhtml list-presentation="table"?>
416
417 <varlistentry id="glxgears">
418 <term><command>glxgears</command></term>
419 <listitem>
420 <para>
421 is a GL demo useful for troubleshooting graphics
422 problems.
423 </para>
424 <indexterm zone="mesa glxgears">
425 <primary sortas="b-glxgears">glxgears</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 <varlistentry id="glxinfo">
431 <term><command>glxinfo</command></term>
432 <listitem>
433 <para>
434 is a diagnostic program that displays information about the
435 graphics hardware and installed GL libraries.
436 </para>
437 <indexterm zone="mesa glxinfo">
438 <primary sortas="b-glxinfo">glxinfo</primary>
439 </indexterm>
440 </listitem>
441 </varlistentry>
442
443 <varlistentry id="libEGL">
444 <term><filename class="libraryfile">libEGL.so</filename></term>
445 <listitem>
446 <para>
447 provides a native platform graphics interface as
448 defined by the EGL-1.4 specification.
449 </para>
450 <indexterm zone="mesa libEGL">
451 <primary sortas="c-libGL">libEGL.so</primary>
452 </indexterm>
453 </listitem>
454 </varlistentry>
455
456 <varlistentry id="libgbm">
457 <term><filename class="libraryfile">libgbm.so</filename></term>
458 <listitem>
459 <para>
460 is the <application>Mesa</application> Graphics Buffer
461 Manager library.
462 </para>
463 <indexterm zone="mesa libgbm">
464 <primary sortas="c-libgbm">libgbm.so</primary>
465 </indexterm>
466 </listitem>
467 </varlistentry>
468
469 <varlistentry id="libGLESv1_CM">
470 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
471 <listitem>
472 <para>
473 is the <application>Mesa</application> OpenGL ES 1.1 library.
474 </para>
475 <indexterm zone="mesa libGLESv1_CM">
476 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 <varlistentry id="libGLES2">
482 <term><filename class="libraryfile">libGLES2.so</filename></term>
483 <listitem>
484 <para>
485 is the <application>Mesa</application> OpenGL ES 2.0 library.
486 </para>
487 <indexterm zone="mesa libGLES2">
488 <primary sortas="c-libGLES2">libGLES2.so</primary>
489 </indexterm>
490 </listitem>
491 </varlistentry>
492
493 <varlistentry id="libGL">
494 <term><filename class="libraryfile">libGL.so</filename></term>
495 <listitem>
496 <para>
497 is the main <application>Mesa</application> OpenGL library.
498 </para>
499 <indexterm zone="mesa libGL">
500 <primary sortas="c-libGL">libGL.so</primary>
501 </indexterm>
502 </listitem>
503 </varlistentry>
504
505 <varlistentry id="libOSMesa">
506 <term><filename class="libraryfile">libOSMesa.so</filename></term>
507 <listitem>
508 <para>
509 is the <application>Mesa</application> Off-screen Rendering library.
510 </para>
511 <indexterm zone="mesa libOSMesa">
512 <primary sortas="c-libOSMesa">libOSMesa.so</primary>
513 </indexterm>
514 </listitem>
515 </varlistentry>
516
517 </variablelist>
518
519 </sect2>
520
521</sect1>
Note: See TracBrowser for help on using the repository browser.