source: x/installing/mesa.xml@ fdcf97c7

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules 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 fdcf97c7 was fdcf97c7, checked in by Pierre Labastie <pieere@…>, 6 years ago

Bump wayland to recommended for Mesa (SYSV book),
add a note telling to use the latest point version of mesa

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19585 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 14.6 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 "a7dca71afbc7294cb7d505067fd44ef6">
10 <!ENTITY mesa-size "9.9 MB">
11 <!ENTITY mesa-buildsize "348 MB (with demos and docs, add 53 MB for tests)">
12 <!ENTITY mesa-time "3.7 SBU (with parallelism=4, demos, and docs; add 0.7 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
45 &lfs81_checked;
46
47 <bridgehead renderas="sect3">Package Information</bridgehead>
48 <itemizedlist spacing="compact">
49 <listitem>
50 <para>
51 Download (HTTP): <ulink url="&mesa-download-http;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download (FTP): <ulink url="&mesa-download-ftp;"/>
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download MD5 sum: &mesa-md5sum;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Download size: &mesa-size;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated disk space required: &mesa-buildsize;
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Estimated build time: &mesa-time;
77 </para>
78 </listitem>
79 </itemizedlist>
80
81 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
82 <itemizedlist spacing="compact">
83 <listitem>
84 <para>
85 Recommended patch:
86 <ulink
87 url="&patch-root;/mesa-&mesa-version;-add_xdemos-1.patch"/>
88 (installs 2 demo programs for testing Mesa - not needed if you
89 install the <ulink url="ftp://ftp.freedesktop.org/pub/mesa/demos/">
90 mesa-demos</ulink> package)
91 </para>
92 </listitem>
93 </itemizedlist>
94
95 <bridgehead renderas="sect3">Mesa Dependencies</bridgehead>
96
97 <bridgehead renderas="sect4">Required</bridgehead>
98 <para role="required">
99 <xref linkend="xorg7-lib"/>,
100 <xref linkend="libdrm"/>,
101 <xref linkend="Mako"/>, and
102 <xref linkend="python2"/>
103 </para>
104
105 <bridgehead renderas="sect4">Recommended</bridgehead>
106 <para role="recommended">
107 <xref linkend="elfutils"/> (required for the radeonsi driver),
108
109 <phrase revision="systemd"><xref linkend="libva"/> (to build drivers for
110 supported hardware, note that there is a circular dependency. You must
111 build <application>libva</application> first without EGL and GLX support,
112 install this package, and rebuild <application>libva</application>.),</phrase>
113
114 <xref linkend="libvdpau"/> (to build VDPAU drivers),
115
116 <xref linkend="llvm"/> (required for Gallium3D, r300, and radeonsi
117 drivers and for the llvmpipe software rasterizer. See <ulink role="nodep"
118 url="http://www.mesa3d.org/systems.html"/> for more information), and
119 <xref linkend="wayland-protocols"/> (required for <xref role="nodep"
120 linkend='plasma5-build'/>,
121 <xref role="nodep" linkend='lxqt'/>, GNOME, and recommended for
122 <xref role="nodep" linkend='gtk3'/>)
123 </para>
124
125 <bridgehead renderas="sect4">Optional</bridgehead>
126 <para role="optional">
127 <xref linkend="libgcrypt"/>,
128 <xref linkend="nettle"/>,
129 <ulink url="ftp://ftp.freedesktop.org/pub/mesa/demos/">mesa-demos</ulink>
130 (provides more than 300 extra demos to test
131 <application>Mesa</application>; this includes the same programs added by
132 the patch above), and
133 <ulink url="http://omxil.sourceforge.net/">Bellagio OpenMAX Integration
134 Layer</ulink> (for mobile platforms)
135 </para>
136
137 <note>
138 <para>
139 The instructions below assume that <application>elfutils</application>
140 and <application>LLVM</application> with the r600/amdgpu and host
141 backends are installed. You will need to modify the instructions if you
142 choose not to install them. 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 <para>Now, select the drivers you wish to install. The available drivers
166 are i915, nouveau, r300, r600, radeonsi, freedreno, svga, swrast, vc4,
167 and virgl. If the Gallium drivers are not specified, the default is
168 'r300,r600,svga,swrast'. Modify the command below for any desired drivers.
169 The listed drivers below will cover most modern video cards. For help in
170 selecting drivers see
171 <ulink url='http://www.mesa3d.org/systems.html'/>.</para>
172
173<screen><userinput>GLL_DRV="i915,r600,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' \
181 --prefix=$XORG_PREFIX \
182 --sysconfdir=/etc \
183 --enable-texture-float \
184 --enable-osmesa \
185 --enable-xa \
186 --enable-glx-tls \
187 --with-platforms="drm,x11,wayland" \
188 --with-gallium-drivers=$GLL_DRV &amp;&amp;
189
190unset GLL_DRV &amp;&amp;
191
192make</userinput></screen>
193
194 <para>
195 If you have applied the xdemos patch, build the demo programs by
196 running the following command:
197 </para>
198
199<screen><userinput>make -C xdemos DEMOS_PREFIX=$XORG_PREFIX</userinput></screen>
200
201 <para>
202 To test the results, issue: <command>make check</command>.
203 </para>
204
205 <para>
206 Now, as the <systemitem class="username">root</systemitem> user:
207 </para>
208
209<screen role="root"><userinput>make install</userinput></screen>
210
211 <para>
212 If you have built the demo programs, install them by running the
213 following command as the
214 <systemitem class="username">root</systemitem> user:
215 </para>
216
217<screen role="root"><userinput>make -C xdemos DEMOS_PREFIX=$XORG_PREFIX install</userinput></screen>
218
219 <para>
220 If desired, install the optional documentation by running
221 the following commands as the
222 <systemitem class="username">root</systemitem> user:
223 </para>
224
225<screen role="root"><userinput>install -v -dm755 /usr/share/doc/mesa-&mesa-version; &amp;&amp;
226cp -rfv docs/* /usr/share/doc/mesa-&mesa-version;</userinput></screen>
227
228 </sect2>
229
230 <sect2 role="commands">
231 <title>Command Explanations</title>
232
233 <para>
234 <parameter>CFLAGS="-O2" CXXFLAGS="-O2"</parameter>: By default,
235 <application>Autoconf</application> sets CFLAGS and CXXFLAGS to
236 "-g -O2". That results in binaries and libraries being built with
237 debugging symbols which make them bigger. Override the default
238 flags to omit the -g compiler flag so the final libraries are smaller.
239 </para>
240
241 <para>
242 <parameter>--enable-texture-float</parameter>: This switch enables
243 floating-point textures and render buffers. Please consult
244 <filename>docs/patents.txt</filename> to see if there are
245 any legal issues if you use this feature.
246 </para>
247
248 <para>
249 <parameter>--enable-osmesa</parameter>: This switch enables building
250 the <filename class="libraryfile">libOSMesa</filename> library.
251 </para>
252
253 <para>
254 <parameter>--enable-xa</parameter>: This switch enables building the
255 XA X Acceleration API (Required for VMware 3D Driver).
256 </para>
257
258 <para>
259 <parameter>--enable-gbm</parameter>: This switch enables building the
260 <application>Mesa</application> Graphics Buffer Manager library.
261 </para>
262
263 <para>
264 <parameter>--enable-glx-tls</parameter>: This switch enables TLS (Thread Local
265 Storage) support in GLX.
266 </para>
267
268 <para>
269 <parameter>--with-platforms="..."</parameter>: This parameter
270 controls which platforms EGL will be built for. Available
271 platforms are drm, x11 and wayland.
272 </para>
273
274 <para>
275 <parameter>--with-gallium-drivers="..."</parameter>: This parameter
276 controls which Gallium3D drivers should be built.
277 </para>
278
279 <para revision="sysv">
280 <option>--enable-sysfs</option>: Use this switch to enable simple PCI
281 identification method, required for building DRI on systems without udev.
282 </para>
283
284 </sect2>
285
286 <sect2 role="content">
287 <title>Contents</title>
288
289 <segmentedlist>
290 <segtitle>Installed Programs</segtitle>
291 <segtitle>Installed Libraries</segtitle>
292 <segtitle>Installed Directories</segtitle>
293
294 <seglistitem>
295 <seg>
296 glxgears and glxinfo
297 </seg>
298 <seg>
299 libEGL.so,
300 libgbm.so,
301 libglapi.so,
302 libGLESv1_CM.so,
303 libGLESv2.so,
304 libGL.so,
305 libOSMesa.so,
306<!-- Those libraries are associated with the "swr" gallium driver,
307 which has been removed at r17757. Keeping as a comment in case we
308 reintroduce that driver.
309 libswrAVX.so,
310 libswrAVX2.so,-->
311 libwayland-egl.so (if built with <application>Wayland</application>)
312 libxatracker.so,
313 libXvMCnouveau.so,
314 and libXvMCr600.so
315 </seg>
316 <seg>
317 $XORG_PREFIX/{include/{EGL,GL,GLES,GLES2,GLES3,KHR},lib/{dri,vdpau}}
318 and
319 /usr/share/doc/mesa-&mesa-version; (optional)
320 </seg>
321 </seglistitem>
322 </segmentedlist>
323
324 <variablelist>
325 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
326 <?dbfo list-presentation="list"?>
327 <?dbhtml list-presentation="table"?>
328
329 <varlistentry id="glxgears">
330 <term><command>glxgears</command></term>
331 <listitem>
332 <para>
333 is a GL demo useful for troubleshooting graphics
334 problems.
335 </para>
336 <indexterm zone="mesa glxgears">
337 <primary sortas="b-glxgears">glxgears</primary>
338 </indexterm>
339 </listitem>
340 </varlistentry>
341
342 <varlistentry id="glxinfo">
343 <term><command>glxinfo</command></term>
344 <listitem>
345 <para>
346 is a diagnostic program that displays information about the
347 graphics hardware and installed GL libraries.
348 </para>
349 <indexterm zone="mesa glxinfo">
350 <primary sortas="b-glxinfo">glxinfo</primary>
351 </indexterm>
352 </listitem>
353 </varlistentry>
354
355 <varlistentry id="libEGL">
356 <term><filename class="libraryfile">libEGL.so</filename></term>
357 <listitem>
358 <para>
359 provides a native platform graphics interface as
360 defined by the EGL-1.4 specification.
361 </para>
362 <indexterm zone="mesa libEGL">
363 <primary sortas="c-libGL">libEGL.so</primary>
364 </indexterm>
365 </listitem>
366 </varlistentry>
367
368 <varlistentry id="libgbm">
369 <term><filename class="libraryfile">libgbm.so</filename></term>
370 <listitem>
371 <para>
372 is the <application>Mesa</application> Graphics Buffer
373 Manager library.
374 </para>
375 <indexterm zone="mesa libgbm">
376 <primary sortas="c-libgbm">libgbm.so</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="libGLESv1_CM">
382 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
383 <listitem>
384 <para>
385 is the <application>Mesa</application> OpenGL ES 1.1 library.
386 </para>
387 <indexterm zone="mesa libGLESv1_CM">
388 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
389 </indexterm>
390 </listitem>
391 </varlistentry>
392
393 <varlistentry id="libGLES2">
394 <term><filename class="libraryfile">libGLES2.so</filename></term>
395 <listitem>
396 <para>
397 is the <application>Mesa</application> OpenGL ES 2.0 library.
398 </para>
399 <indexterm zone="mesa libGLES2">
400 <primary sortas="c-libGLES2">libGLES2.so</primary>
401 </indexterm>
402 </listitem>
403 </varlistentry>
404
405 <varlistentry id="libGL">
406 <term><filename class="libraryfile">libGL.so</filename></term>
407 <listitem>
408 <para>
409 is the main <application>Mesa</application> OpenGL library.
410 </para>
411 <indexterm zone="mesa libGL">
412 <primary sortas="c-libGL">libGL.so</primary>
413 </indexterm>
414 </listitem>
415 </varlistentry>
416
417 <varlistentry id="libOSMesa">
418 <term><filename class="libraryfile">libOSMesa.so</filename></term>
419 <listitem>
420 <para>
421 is the <application>Mesa</application> Off-screen Rendering library.
422 </para>
423 <indexterm zone="mesa libOSMesa">
424 <primary sortas="c-libOSMesa">libOSMesa.so</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 <varlistentry id="libxatracker">
430 <term><filename class="libraryfile">libxatracker.so</filename></term>
431 <listitem>
432 <para>
433 is the Xorg Gallium3D acceleration library.
434 </para>
435 <indexterm zone="mesa libxatracker">
436 <primary sortas="c-libxatracker">libxatracker.so</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440 </variablelist>
441
442 </sect2>
443
444</sect1>
Note: See TracBrowser for help on using the repository browser.