source: x/installing/mesa.xml@ 2b9eb80

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 2b9eb80 was 2b9eb80, checked in by Bruce Dubbs <bdubbs@…>, 15 months ago

Update to mesa-22.3.4.
  • 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 "edc8d2b824403aebc83d2c23b6c1dba0">
10 <!ENTITY mesa-size "16 MB">
11 <!ENTITY mesa-buildsize "372 MB (with docs, add 203 MB for tests)">
12 <!ENTITY mesa-time "2.2 SBU (Using parallelism=4; with docs, add 0.6 SBU for tests)">
13]>
14
15<sect1 id="mesa" xreflabel="Mesa-&mesa-version;">
16 <?dbhtml filename="mesa.html"?>
17
18
19 <title>Mesa-&mesa-version;</title>
20
21 <indexterm zone="mesa">
22 <primary sortas="a-Mesa">Mesa</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Mesa</title>
27
28 <para>
29 <application>Mesa</application> is an OpenGL compatible 3D graphics
30 library.
31 </para>
32
33 <note>
34 <para>
35 <application>Mesa</application> is updated relatively often. You may
36 want to use the latest available &mesa-major-minor;.x mesa version.
37 </para>
38 </note>
39
40 &lfs112_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&mesa-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&mesa-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &mesa-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &mesa-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &mesa-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &mesa-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
77 <itemizedlist spacing="compact">
78 <listitem>
79 <para>
80 Recommended patch:
81 <ulink url="&patch-root;/mesa-&mesa-version;-add_xdemos-1.patch"/>
82 (installs 2 demo programs for testing Mesa - not needed if you
83 install the <ulink url="https://archive.mesa3d.org/demos/">
84 mesa-demos</ulink> package)
85 </para>
86 </listitem>
87 </itemizedlist>
88
89 <bridgehead renderas="sect3">Mesa Dependencies</bridgehead>
90
91 <bridgehead renderas="sect4">Required</bridgehead>
92 <para role="required">
93 <xref linkend="xorg7-lib"/>,
94 <xref linkend="libdrm"/>, and
95 <xref linkend="Mako"/>
96 </para>
97
98 <bridgehead renderas="sect4">Recommended</bridgehead>
99 <para role="recommended">
100
101 <xref role="first" linkend="libva"/> (to provide VA-API support for some
102 gallium drivers, 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>),
105
106 <xref linkend="libvdpau"/> (to build VDPAU drivers),
107
108 <xref linkend="llvm"/> (required for Gallium3D, nouveau, and radeonsi
109 drivers and for swrast, the software rasterizer which is sometimes referred
110 to as llvmpipe. See <ulink role="nodep"
111 url="https://docs.mesa3d.org/systems.html"/> for more information), and
112
113 <xref linkend="wayland-protocols"/> (required for
114 <xref role="nodep" linkend='plasma5-build'/>,
115 GNOME, and recommended for <xref role="nodep" linkend='gtk3'/>)
116 </para>
117
118 <bridgehead renderas="sect4">Optional</bridgehead>
119 <para role="optional">
120 <xref linkend="libgcrypt"/>,
121 <xref linkend="libunwind"/>,
122 <xref linkend="lm_sensors"/> <!-- for libsensors according to Meson -->,
123 <xref linkend="nettle"/>,
124 <xref linkend="valgrind"/>,
125 <ulink url="https://archive.mesa3d.org/demos/">mesa-demos</ulink>
126 (provides more than 300 extra demos to test
127 <application>Mesa</application>; this includes the same programs added by
128 the patch above),
129 <ulink url="http://omxil.sourceforge.net/">Bellagio OpenMAX Integration
130 Layer</ulink> (for mobile platforms),
131 <ulink url="https://github.com/KhronosGroup/glslang">glslang</ulink>
132 (for vulkan drivers),
133 <ulink url="https://github.com/tizonia/tizonia-openmax-il/wiki/Tizonia-OpenMAX-IL/">
134 libtizonia</ulink>, and
135 <ulink url="https://www.vulkan.org/">libvulkan</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;/mesalib"/>
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 <note>
172 <para>
173 The measurements above, and the Contents below, are for a full build.
174 Many people will not wish to install drivers they cannot use, so the
175 following paragraphs explain how to limit the drivers, and give an
176 example which can be be reduced or amended as necessary.
177 </para>
178 </note>
179
180 <para>
181 Now, select the drivers you wish to install. For the X86 architecture, the
182 available gallium drivers are auto (<emphasis>in 21.2.1 this does not select
183 crocus </emphasis>), <emphasis>or alternatively a choice from</emphasis>
184 crocus, i915, iris, nouveau, r300, r600, radeonsi, svga, swrast, and virgl.
185 The latter can provide acceleration in <xref linkend="qemu"/> if that has
186 been linked against
187 <ulink url="https://gitlab.freedesktop.org/virgl/virglrenderer/~/releases/">virglrenderer</ulink>
188 (you will need a freedesktop.org account to get to that page, you can
189 download the 0.9.1 release without an account from
190 <ulink url="https://gitlab.freedesktop.org/virgl/virglrenderer/-/archive/0.9.1/virglrenderer-0.9.1.tar.bz2">virglrenderer-0.9.1</ulink>).-->
191
192<!-- If you wish to build all available gallium drivers,
193 use 'auto'. FIXME : does not build crocus in 21.2.1 -->
194
195 <!-- crocus was added to the default x86/x86_64 drivers for meson in the
196 master branch on 2021-08-31, at some point it will appear in a stable release
197 </para>
198-->
199<!--
200 <para>
201 The (non-gallium) DRI drivers available in X86 are auto, <emphasis>or
202 alternatively a choice from</emphasis> i915, i965, nouveau, r100, r200,
203 and swrast. Use 'auto' to build all available DRI drivers, or use an
204 empty string (DRI_DRIVERS="") if you wish to only build gallium drivers.
205 </para>
206
207 <para>
208 The platforms ("window systems") available for X86 linux are x11, wayland,
209 drm, and surfaceless. By not specifying anything, the meson
210 build-system will build for all these platforms if you have the
211 dependencies, identical to if you had specified '-Dplatforms=auto'.
212 </para>
213
214 <para>
215 Modify the commands below for your desired drivers. The drivers listed
216 below will cover most modern video cards and virtual machines. For help in
217 selecting drivers see <ulink url="https://docs.mesa3d.org/systems.html"/>.
218-->
219 <!-- these two don't seem to be mentioned in that mesa link -->
220<!--
221 For intel drivers, specify crocus for i965 gen 4 through to haswell, iris
222 for broadwell and later.
223 </para>
224
225 <note>
226 <para>
227 Although the nouveau drivers can be built for both gallium and dri, the
228 i915 driver can only be built for one or the other.
229 </para>
230 </note>
231
232<screen><userinput>GALLIUM_DRV="crocus,i915,iris,nouveau,r600,radeonsi,svga,swrast,virgl"
233DRI_DRIVERS="i965,nouveau"</userinput></screen>
234-->
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 setup \
245 --prefix=$XORG_PREFIX \
246 --buildtype=release \
247 -Dplatforms=x11,wayland \
248 -Dgallium-drivers=auto \
249 -Dvulkan-drivers="" \
250 -Dvalgrind=disabled \
251 -Dlibunwind=disabled \
252 .. &amp;&amp;
253
254ninja</userinput></screen>
255
256 <para>
257 If you built the tests (see 'Command Explanations'), to run them issue:
258 <command>ninja test</command>.
259 </para>
260<!-- All 88 tests passed for me for 22.3.3 [pierre]
261-->
262
263 <para>
264 Now, as the <systemitem class="username">root</systemitem> user:
265 </para>
266
267<screen role="root"><userinput>ninja install</userinput></screen>
268
269 <para>
270 If desired, install the optional documentation by running
271 the following commands as the
272 <systemitem class="username">root</systemitem> user:
273 </para>
274
275<screen role="root"
276 remap="doc"><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>--buildtype=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>-Dgallium-drivers="..."</parameter>: This parameter
293 controls which Gallium3D drivers should be built.
294 </para>
295<!--
296 <para>
297 <parameter>-Dosmesa=true</parameter>: This switch enables building
298 the <filename class="libraryfile">libOSMesa</filename> library and
299 provides Gallium3D support in it. It requires the swrast gallium driver.
300 </para>
301-->
302
303 <para>
304 <parameter>-Dplatforms="..."</parameter>: This parameter
305 controls which windowing systems will be supported. Available
306 linux platforms are x11 and wayland.
307 </para>
308
309 <para>
310 <parameter>-Dvulkan-drivers=""</parameter>: This switch allows choosing
311 which Vulkan drivers are built. The default is auto, but this requires
312 the optional dependency <filename>glslang</filename>. So it is better
313 to pass an empty list, in order to remove the need for that
314 dependency. Nothing in BLFS uses Vulkan anyway.
315 </para>
316
317 <para>
318 <parameter>-Dvalgrind=disabled</parameter>: This parameter disables
319 the usage of Valgrind during the build process. Remove this parameter
320 if you have Valgrind installed, and wish to check for memory leaks.
321 </para>
322
323 <para>
324 <parameter>-Dlibunwind=disabled</parameter>: This parameter disables
325 the usage of libunwind.
326 </para>
327
328 <para>
329 <option>-Dbuild-tests=true</option>: This switch will cause the test code
330 to be enabled.
331 </para>
332
333 <para>
334 <option>-Degl-native-platform="..."</option>: This parameter
335 controls which Embedded Graphics Library support will be built. Available
336 linux options are auto (default), x11, wayland, surfaceless, and drm.
337 </para>
338
339 </sect2>
340
341 <sect2 role="content">
342 <title>Contents</title>
343
344 <segmentedlist>
345 <segtitle>Installed Programs</segtitle>
346 <segtitle>Installed Libraries</segtitle><!-- in /usr/lib -->
347 <segtitle>Installed Drivers</segtitle><!-- in /usr/lib/<subdir> -->
348 <segtitle>Installed Directories</segtitle>
349
350 <seglistitem>
351 <seg>
352 glxgears and glxinfo
353 </seg>
354 <seg>
355 libEGL.so,
356 libGL.so,
357 libGLESv1_CM.so,
358 libGLESv2.so,
359<!-- libXvMCnouveau.so,
360 libXvMCr600.so,-->
361 libgbm.so,
362 libglapi.so, and
363 libxatracker.so
364 </seg>
365 <seg>
366 <!-- Begin gallium DRI drivers : this is the full set -->
367<!-- d3dadapter9.so (optional), For Windows games. This is DirectX's
368 Direct3D -->
369 crocus_dri.so,
370 i915_dri.so,
371 iris_dri.so,
372 kms_swrast_dri.so,
373 nouveau_dri.so,
374 nouveau_drv_video.so,
375 r300_dri.so,
376 r600_dri.so,
377 r600_drv_video.so,
378 radeonsi_dri.so,
379 radeonsi_drv_video.so,
380 swrast_dri.so,
381 virtio_gpu_dri.so,
382 virtio_gpu_drv_video.so,
383 vmwgfx_dri.so,
384 <!-- End DRI Drivers -->
385 <!-- Begin VDPAU drivers -->
386 libvdpau_nouveau.so,
387 libvdpau_r300.so
388 libvdpau_r600.so, and
389 libvdpau_radeonsi.so
390 libvdpau_virtio_gpu.so
391 <!-- End VDPAU drivers -->
392 (Many of these drivers are hard-linked).
393 </seg>
394 <seg>
395 <!-- $XORG_PREFIX/include/GL is installed by xorg-protos -->
396 $XORG_PREFIX/{include/{EGL,GLES,GLES2,GLES3,KHR},
397 $XORG_PREFIX/lib/{dri,vdpau}},
398 $XORG_PREFIX/share/drirc.d (contains workarounds for various applications,
399 particularly browsers and games),
400 and /usr/share/doc/mesa-&mesa-version;
401 </seg>
402 </seglistitem>
403 </segmentedlist>
404
405 <variablelist>
406 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
407 <?dbfo list-presentation="list"?>
408 <?dbhtml list-presentation="table"?>
409
410 <varlistentry id="glxgears">
411 <term><command>glxgears</command></term>
412 <listitem>
413 <para>
414 is a GL demo useful for troubleshooting graphics
415 problems
416 </para>
417 <indexterm zone="mesa glxgears">
418 <primary sortas="b-glxgears">glxgears</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 <varlistentry id="glxinfo">
424 <term><command>glxinfo</command></term>
425 <listitem>
426 <para>
427 is a diagnostic program that displays information about the
428 graphics hardware and installed GL libraries
429 </para>
430 <indexterm zone="mesa glxinfo">
431 <primary sortas="b-glxinfo">glxinfo</primary>
432 </indexterm>
433 </listitem>
434 </varlistentry>
435
436 <varlistentry id="libEGL">
437 <term><filename class="libraryfile">libEGL.so</filename></term>
438 <listitem>
439 <para>
440 provides a native platform graphics interface as
441 defined by the EGL-1.4 specification
442 </para>
443 <indexterm zone="mesa libEGL">
444 <primary sortas="c-libGL">libEGL.so</primary>
445 </indexterm>
446 </listitem>
447 </varlistentry>
448
449 <varlistentry id="libgbm">
450 <term><filename class="libraryfile">libgbm.so</filename></term>
451 <listitem>
452 <para>
453 is the <application>Mesa</application> Graphics Buffer
454 Manager library
455 </para>
456 <indexterm zone="mesa libgbm">
457 <primary sortas="c-libgbm">libgbm.so</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461
462 <varlistentry id="libGLESv1_CM">
463 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
464 <listitem>
465 <para>
466 is the <application>Mesa</application> OpenGL ES 1.1 library
467 </para>
468 <indexterm zone="mesa libGLESv1_CM">
469 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
470 </indexterm>
471 </listitem>
472 </varlistentry>
473
474 <varlistentry id="libGLES2">
475 <term><filename class="libraryfile">libGLES2.so</filename></term>
476 <listitem>
477 <para>
478 is the <application>Mesa</application> OpenGL ES 2.0 library
479 </para>
480 <indexterm zone="mesa libGLES2">
481 <primary sortas="c-libGLES2">libGLES2.so</primary>
482 </indexterm>
483 </listitem>
484 </varlistentry>
485
486 <varlistentry id="libGL">
487 <term><filename class="libraryfile">libGL.so</filename></term>
488 <listitem>
489 <para>
490 is the main <application>Mesa</application> OpenGL library
491 </para>
492 <indexterm zone="mesa libGL">
493 <primary sortas="c-libGL">libGL.so</primary>
494 </indexterm>
495 </listitem>
496 </varlistentry>
497
498 </variablelist>
499
500 </sect2>
501
502</sect1>
Note: See TracBrowser for help on using the repository browser.