source: x/installing/mesa.xml@ 370aa28

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 xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 370aa28 was 370aa28, checked in by Douglas R. Reno <renodr@…>, 19 months ago

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