source: x/installing/mesa.xml@ 1fe05eb

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/soup3 xry111/xf86-video-removal
Last change on this file since 1fe05eb was 1fe05eb, checked in by Pierre Labastie <pierre.labastie@…>, 20 months ago

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