source: x/installing/mesa.xml@ 72f0b9c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.0 8.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 nosym 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 72f0b9c was 72f0b9c, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to mesa-13.0.0

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