source: x/installing/mesa.xml@ 45ab6c7

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 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 years ago

more SVN prop clean up

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