source: x/installing/mesa.xml@ 581077c0

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 9.0 9.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 581077c0 was 38489aa0, checked in by Pierre Labastie <pieere@…>, 5 years ago

Tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21156 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 15.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 "e9d1a24dbd5ca20efa75b9a29eb4566f">
10 <!ENTITY mesa-size "11 MB">
11 <!ENTITY mesa-buildsize "361 MB (with demos and docs, add 89 MB for tests)">
12 <!ENTITY mesa-time "2.3 SBU (with parallelism=4, demos, and docs; add 1.1 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 &lfs84_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 <phrase revision="systemd"><xref linkend="libva"/> (to build drivers for
107 supported hardware, 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>.),</phrase>
110
111 <xref linkend="libvdpau"/> (to build VDPAU drivers),
112
113 <xref linkend="llvm"/> (required for Gallium3D, r300, and radeonsi
114 drivers and for the llvmpipe software rasterizer. See <ulink role="nodep"
115 url="http://www.mesa3d.org/systems.html"/> for more information), and
116 <xref linkend="wayland-protocols"/> (required for
117 <xref role="nodep" linkend='plasma5-build'/>,
118 <!-- <xref role="nodep" linkend='lxqt'/>, -->
119 GNOME, and
120 recommended for <xref role="nodep" linkend='gtk3'/>)
121 </para>
122
123 <bridgehead renderas="sect4">Optional</bridgehead>
124 <para role="optional">
125 <xref linkend="libgcrypt"/>,
126 <xref linkend="nettle"/>,
127 <xref linkend="python2"/> (not used if Python3 is present),
128 <ulink url="ftp://ftp.freedesktop.org/pub/mesa/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), and
132 <ulink url="http://omxil.sourceforge.net/">Bellagio OpenMAX Integration
133 Layer</ulink> (for mobile platforms)
134 </para>
135
136 <note>
137 <para>
138 The instructions below assume that <!-- <application>elfutils</application>
139 and --> <application>LLVM</application> with the r600/amdgpu and host
140 backends are installed. You will need to modify the instructions if you
141 choose not to install it. For an explanation of Gallium3D see
142 <ulink url="https://en.wikipedia.org/wiki/Gallium3D"/>.
143 </para>
144 </note>
145
146 <para condition="html" role="usernotes">User Notes:
147 <ulink url="&blfs-wiki;/mesa"/>
148 </para>
149 </sect2>
150
151 <sect2 role="installation">
152 <title>Installation of Mesa</title>
153
154 <para>
155 If you have downloaded the xdemos patch (needed if testing the Xorg
156 installation per BLFS instructions), apply it by running the following
157 command:
158 </para>
159
160<screen><userinput>patch -Np1 -i ../mesa-&mesa-version;-add_xdemos-1.patch</userinput></screen>
161
162 <!-- Note that freedreno, vc4, and virgl all need special support from
163 libdrm - renodr -->
164
165 <para>Now, select the drivers you wish to install. The available drivers
166 are i915, nouveau, r300, r600, radeonsi, freedreno, pl111, svga, swrast,
167 swr, tegra, v3d, vc4, virgl, etnaviv, and imx. If the Gallium drivers are
168 not specified, the default is 'r300,r600,svga,swrast'. Modify the command
169 below for any desired drivers. The listed drivers below will cover most
170 modern video cards. For help in selecting drivers see <ulink
171 url='http://www.mesa3d.org/systems.html'/>.</para>
172
173<screen><userinput>GLL_DRV="i915,nouveau,radeonsi,svga,swrast"</userinput></screen>
174
175 <para>
176 Install <application>Mesa</application> by running the following
177 commands:
178 </para>
179
180<screen><userinput>./configure CFLAGS='-O2' CXXFLAGS='-O2' LDFLAGS=-lLLVM \
181 --prefix=$XORG_PREFIX \
182 --sysconfdir=/etc \
183 --enable-osmesa \
184 --enable-xa \
185 --enable-glx-tls \
186 --with-platforms="drm,x11,wayland" \
187 --with-gallium-drivers=$GLL_DRV &amp;&amp;
188
189unset GLL_DRV &amp;&amp;
190
191make</userinput></screen>
192
193 <para>
194 If you have applied the xdemos patch, build the demo programs by
195 running the following command:
196 </para>
197
198<screen><userinput>make -C xdemos DEMOS_PREFIX=$XORG_PREFIX</userinput></screen>
199
200 <para>
201 To test the results, issue: <command>make -k check</command>.
202 </para>
203
204 <para>
205 Now, as the <systemitem class="username">root</systemitem> user:
206 </para>
207
208<screen role="root"><userinput>make install</userinput></screen>
209
210 <para>
211 If you have built the demo programs, install them by running the
212 following command as the
213 <systemitem class="username">root</systemitem> user:
214 </para>
215
216<screen role="root"><userinput>make -C xdemos DEMOS_PREFIX=$XORG_PREFIX install</userinput></screen>
217
218 <para>
219 If desired, install the optional documentation by running
220 the following commands as the
221 <systemitem class="username">root</systemitem> user:
222 </para>
223
224<screen role="root"><userinput>install -v -dm755 /usr/share/doc/mesa-&mesa-version; &amp;&amp;
225cp -rfv docs/* /usr/share/doc/mesa-&mesa-version;</userinput></screen>
226
227 </sect2>
228
229 <sect2 role="commands">
230 <title>Command Explanations</title>
231
232 <para>
233 <parameter>CFLAGS="-O2" CXXFLAGS="-O2"</parameter>: By default,
234 <application>Autoconf</application> sets CFLAGS and CXXFLAGS to
235 "-g -O2". That results in binaries and libraries being built with
236 debugging symbols which make them bigger. Override the default
237 flags to omit the -g compiler flag so the final libraries are smaller.
238 </para>
239
240 <para>
241 <parameter>LDFLAGS=-lLLVM</parameter>: This environment variable
242 specifies the LLVM libraries that are not automatically included
243 for some of the package components.
244 </para>
245<!--
246 <para>
247 <parameter>- -enable-texture-float</parameter>: This switch enables
248 floating-point textures and render buffers. Please consult
249 <filename>docs/patents.txt</filename> to see if there are
250 any legal issues if you use this feature.
251 </para>
252 Removed in 18.2.0
253-->
254
255 <para>
256 <parameter>--enable-osmesa</parameter>: This switch enables building
257 the <filename class="libraryfile">libOSMesa</filename> library.
258 </para>
259
260 <para>
261 <parameter>--enable-xa</parameter>: This switch enables building the
262 XA X Acceleration API (Required for VMware 3D Driver).
263 </para>
264
265 <para>
266 <parameter>--enable-gbm</parameter>: This switch enables building the
267 <application>Mesa</application> Graphics Buffer Manager library.
268 </para>
269
270 <para>
271 <parameter>--enable-glx-tls</parameter>: This switch enables TLS (Thread Local
272 Storage) support in GLX.
273 </para>
274
275 <para>
276 <parameter>--with-platforms="..."</parameter>: This parameter
277 controls which platforms EGL will be built for. Available
278 platforms are drm, x11 and wayland.
279 </para>
280
281 <para>
282 <parameter>--with-gallium-drivers="..."</parameter>: This parameter
283 controls which Gallium3D drivers should be built.
284 </para>
285
286 <para revision="sysv">
287 <option>--enable-sysfs</option>: Use this switch to enable simple PCI
288 identification method, required for building DRI on systems without udev.
289 </para>
290
291 </sect2>
292
293 <sect2 role="content">
294 <title>Contents</title>
295
296 <segmentedlist>
297 <segtitle>Installed Programs</segtitle>
298 <segtitle>Installed Libraries</segtitle>
299 <segtitle>Installed Directories</segtitle>
300
301 <seglistitem>
302 <seg>
303 glxgears and glxinfo
304 </seg>
305 <seg>
306 libEGL.so,
307 libgbm.so,
308 libglapi.so,
309 libGLESv1_CM.so,
310 libGLESv2.so,
311 libGL.so,
312 libOSMesa.so,
313<!-- Those libraries are associated with the "swr" gallium driver,
314 which has been removed at r17757. Keeping as a comment in case we
315 reintroduce that driver. AVX libs are restored in version 18.0.1 -->
316<!-- libswrAVX.so,
317 libswrAVX2.so, -->
318 libwayland-egl.so (if built with <application>Wayland</application>)
319 <!-- Does not appear to be present even with Wayland installed in 18.2.2.
320 Further verification on a GNOME and Plasma system required. -->
321 libxatracker.so,
322 libXvMCnouveau.so,
323 and libXvMCr600.so
324 </seg>
325 <seg>
326 $XORG_PREFIX/{include/{EGL,GL,GLES,GLES2,GLES3,KHR},lib/{dri,vdpau}}
327 and
328 /usr/share/doc/mesa-&mesa-version; (optional)
329 </seg>
330 </seglistitem>
331 </segmentedlist>
332
333 <variablelist>
334 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
335 <?dbfo list-presentation="list"?>
336 <?dbhtml list-presentation="table"?>
337
338 <varlistentry id="glxgears">
339 <term><command>glxgears</command></term>
340 <listitem>
341 <para>
342 is a GL demo useful for troubleshooting graphics
343 problems.
344 </para>
345 <indexterm zone="mesa glxgears">
346 <primary sortas="b-glxgears">glxgears</primary>
347 </indexterm>
348 </listitem>
349 </varlistentry>
350
351 <varlistentry id="glxinfo">
352 <term><command>glxinfo</command></term>
353 <listitem>
354 <para>
355 is a diagnostic program that displays information about the
356 graphics hardware and installed GL libraries.
357 </para>
358 <indexterm zone="mesa glxinfo">
359 <primary sortas="b-glxinfo">glxinfo</primary>
360 </indexterm>
361 </listitem>
362 </varlistentry>
363
364 <varlistentry id="libEGL">
365 <term><filename class="libraryfile">libEGL.so</filename></term>
366 <listitem>
367 <para>
368 provides a native platform graphics interface as
369 defined by the EGL-1.4 specification.
370 </para>
371 <indexterm zone="mesa libEGL">
372 <primary sortas="c-libGL">libEGL.so</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 <varlistentry id="libgbm">
378 <term><filename class="libraryfile">libgbm.so</filename></term>
379 <listitem>
380 <para>
381 is the <application>Mesa</application> Graphics Buffer
382 Manager library.
383 </para>
384 <indexterm zone="mesa libgbm">
385 <primary sortas="c-libgbm">libgbm.so</primary>
386 </indexterm>
387 </listitem>
388 </varlistentry>
389
390 <varlistentry id="libGLESv1_CM">
391 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
392 <listitem>
393 <para>
394 is the <application>Mesa</application> OpenGL ES 1.1 library.
395 </para>
396 <indexterm zone="mesa libGLESv1_CM">
397 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
398 </indexterm>
399 </listitem>
400 </varlistentry>
401
402 <varlistentry id="libGLES2">
403 <term><filename class="libraryfile">libGLES2.so</filename></term>
404 <listitem>
405 <para>
406 is the <application>Mesa</application> OpenGL ES 2.0 library.
407 </para>
408 <indexterm zone="mesa libGLES2">
409 <primary sortas="c-libGLES2">libGLES2.so</primary>
410 </indexterm>
411 </listitem>
412 </varlistentry>
413
414 <varlistentry id="libGL">
415 <term><filename class="libraryfile">libGL.so</filename></term>
416 <listitem>
417 <para>
418 is the main <application>Mesa</application> OpenGL library.
419 </para>
420 <indexterm zone="mesa libGL">
421 <primary sortas="c-libGL">libGL.so</primary>
422 </indexterm>
423 </listitem>
424 </varlistentry>
425
426 <varlistentry id="libOSMesa">
427 <term><filename class="libraryfile">libOSMesa.so</filename></term>
428 <listitem>
429 <para>
430 is the <application>Mesa</application> Off-screen Rendering library.
431 </para>
432 <indexterm zone="mesa libOSMesa">
433 <primary sortas="c-libOSMesa">libOSMesa.so</primary>
434 </indexterm>
435 </listitem>
436 </varlistentry>
437
438 <varlistentry id="libxatracker">
439 <term><filename class="libraryfile">libxatracker.so</filename></term>
440 <listitem>
441 <para>
442 is the Xorg Gallium3D acceleration library.
443 </para>
444 <indexterm zone="mesa libxatracker">
445 <primary sortas="c-libxatracker">libxatracker.so</primary>
446 </indexterm>
447 </listitem>
448 </varlistentry>
449 </variablelist>
450
451 </sect2>
452
453</sect1>
Note: See TracBrowser for help on using the repository browser.