source: x/installing/mesa.xml@ 796bc663

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 796bc663 was 796bc663, checked in by Bruce Dubbs <bdubbs@…>, 6 years ago

Update to xterm-335.
Update to mesa-18.1.6.
Update to harfbuzz-1.8.8.
Tag Xorg (some drivers left untagged)

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@20327 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 14.8 KB
RevLine 
[868c7c2]1<?xml version="1.0" encoding="ISO-8859-1"?>
[6732c094]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[868c7c2]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[c0a8c0dc]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">
[796bc663]9 <!ENTITY mesa-md5sum "f798814c0b93ca3c1cf395bb936db3e0">
[a6542da]10 <!ENTITY mesa-size "11 MB">
[796bc663]11 <!ENTITY mesa-buildsize "382 MB (with demos and docs, add 40 MB for tests)">
[a6542da]12 <!ENTITY mesa-time "3.5 SBU (with parallelism=4, demos, and docs; add 1.0 SBU for tests)">
[868c7c2]13]>
14
[7a395d1]15<sect1 id="mesa" xreflabel="Mesa-&mesa-version;">
16 <?dbhtml filename="mesa.html"?>
[868c7c2]17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
[7a395d1]23 <title>Mesa-&mesa-version;</title>
[868c7c2]24
[7a395d1]25 <indexterm zone="mesa">
26 <primary sortas="a-Mesa">Mesa</primary>
[868c7c2]27 </indexterm>
28
29 <sect2 role="package">
[7a395d1]30 <title>Introduction to Mesa</title>
[868c7c2]31
[eb425b4]32 <para>
33 <application>Mesa</application> is an OpenGL compatible 3D graphics
34 library.
35 </para>
[868c7c2]36
[fdcf97c7]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
[796bc663]44 &lfs83_checked;
[ca0c29cc]45
[868c7c2]46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
[de938a4e]49 <para>
[7a395d1]50 Download (HTTP): <ulink url="&mesa-download-http;"/>
[de938a4e]51 </para>
[868c7c2]52 </listitem>
53 <listitem>
[de938a4e]54 <para>
[7a395d1]55 Download (FTP): <ulink url="&mesa-download-ftp;"/>
[de938a4e]56 </para>
[868c7c2]57 </listitem>
58 <listitem>
[de938a4e]59 <para>
[7a395d1]60 Download MD5 sum: &mesa-md5sum;
[de938a4e]61 </para>
[868c7c2]62 </listitem>
63 <listitem>
[de938a4e]64 <para>
[7a395d1]65 Download size: &mesa-size;
[de938a4e]66 </para>
[868c7c2]67 </listitem>
68 <listitem>
[de938a4e]69 <para>
[7a395d1]70 Estimated disk space required: &mesa-buildsize;
[de938a4e]71 </para>
[868c7c2]72 </listitem>
73 <listitem>
[de938a4e]74 <para>
[7a395d1]75 Estimated build time: &mesa-time;
[de938a4e]76 </para>
[868c7c2]77 </listitem>
78 </itemizedlist>
79
[625079b6]80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
[a07e9eb]81 <itemizedlist spacing="compact">
82 <listitem>
[eb425b4]83 <para>
84 Recommended patch:
[39dd48b]85 <ulink
[27747668]86 url="&patch-root;/mesa-&mesa-version;-add_xdemos-1.patch"/>
[7a395d1]87 (installs 2 demo programs for testing Mesa - not needed if you
[39dd48b]88 install the <ulink url="ftp://ftp.freedesktop.org/pub/mesa/demos/">
89 mesa-demos</ulink> package)
[ace536a]90 </para>
[eeb29511]91 </listitem>
92 </itemizedlist>
93
[7a395d1]94 <bridgehead renderas="sect3">Mesa Dependencies</bridgehead>
[868c7c2]95
96 <bridgehead renderas="sect4">Required</bridgehead>
[7b74537e]97 <para role="required">
[df343952]98 <xref linkend="xorg7-lib"/>,
[0499056]99 <xref linkend="libdrm"/>,
100 <xref linkend="Mako"/>, and
[df343952]101 <xref linkend="python2"/>
[eb425b4]102 </para>
[868c7c2]103
[606dfd4]104 <bridgehead renderas="sect4">Recommended</bridgehead>
[eb425b4]105 <para role="recommended">
[3867d8ee]106 <!-- <xref linkend="elfutils"/> (required for the radeonsi driver), -->
[973dabe9]107
[df343952]108 <phrase revision="systemd"><xref linkend="libva"/> (to build drivers for
109 supported hardware, note that there is a circular dependency. You must
110 build <application>libva</application> first without EGL and GLX support,
111 install this package, and rebuild <application>libva</application>.),</phrase>
[973dabe9]112
[9065a56b]113 <xref linkend="libvdpau"/> (to build VDPAU drivers),
[973dabe9]114
[8a154834]115 <xref linkend="llvm"/> (required for Gallium3D, r300, and radeonsi
[383eaf9]116 drivers and for the llvmpipe software rasterizer. See <ulink role="nodep"
[fdcf97c7]117 url="http://www.mesa3d.org/systems.html"/> for more information), and
[8e17e54]118 <xref linkend="wayland-protocols"/> (required for
119 <xref role="nodep" linkend='plasma5-build'/>,
120 <!-- <xref role="nodep" linkend='lxqt'/>, -->
121 GNOME, and
122 recommended for <xref role="nodep" linkend='gtk3'/>)
[606dfd4]123 </para>
[60bcf481]124
[07584d8]125 <bridgehead renderas="sect4">Optional</bridgehead>
126 <para role="optional">
[57bcce9]127 <xref linkend="libgcrypt"/>,
128 <xref linkend="nettle"/>,
[58720a7b]129 <ulink url="ftp://ftp.freedesktop.org/pub/mesa/demos/">mesa-demos</ulink>
[1cdb1f7]130 (provides more than 300 extra demos to test
[973dabe9]131 <application>Mesa</application>; this includes the same programs added by
132 the patch above), and
[c18b8f23]133 <ulink url="http://omxil.sourceforge.net/">Bellagio OpenMAX Integration
[f3429309]134 Layer</ulink> (for mobile platforms)
[07584d8]135 </para>
136
[9065a56b]137 <note>
[fd2f9a2]138 <para>
[3867d8ee]139 The instructions below assume that <!-- <application>elfutils</application>
140 and --> <application>LLVM</application> with the r600/amdgpu and host
[df343952]141 backends are installed. You will need to modify the instructions if you
[3867d8ee]142 choose not to install it. For an explanation of Gallium3D see
[e83a3bb]143 <ulink url="https://en.wikipedia.org/wiki/Gallium3D"/>.
[fd2f9a2]144 </para>
[9065a56b]145 </note>
[fd2f9a2]146
[c5c2654]147 <para condition="html" role="usernotes">User Notes:
[7a395d1]148 <ulink url="&blfs-wiki;/mesa"/>
[2993b2f]149 </para>
[868c7c2]150 </sect2>
151
152 <sect2 role="installation">
[7a395d1]153 <title>Installation of Mesa</title>
[868c7c2]154
[a07e9eb]155 <para>
[51c08f3]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:
[a07e9eb]159 </para>
160
[27747668]161<screen><userinput>patch -Np1 -i ../mesa-&mesa-version;-add_xdemos-1.patch</userinput></screen>
[a07e9eb]162
[054e926]163 <!-- Note that freedreno, vc4, and virgl all need special support from
164 libdrm - renodr -->
[f9f0ea92]165 <para>Now, select the drivers you wish to install. The available drivers
[d95f8916]166 are i915, nouveau, r300, r600, radeonsi, freedreno, svga, swrast, vc4,
[f9f0ea92]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>
[973dabe9]172
[f2afe02]173<screen><userinput>GLL_DRV="i915,r600,nouveau,radeonsi,svga,swrast"</userinput></screen>
[973dabe9]174
[eb425b4]175 <para>
[7a395d1]176 Install <application>Mesa</application> by running the following
[eb425b4]177 commands:
178 </para>
[868c7c2]179
[b642036d]180<screen><userinput>./configure CFLAGS='-O2' CXXFLAGS='-O2' LDFLAGS=-lLLVM \
[b4fc57d]181 --prefix=$XORG_PREFIX \
182 --sysconfdir=/etc \
183 --enable-texture-float \
184 --enable-osmesa \
185 --enable-xa \
186 --enable-glx-tls \
[d95f8916]187 --with-platforms="drm,x11,wayland" \
[b4fc57d]188 --with-gallium-drivers=$GLL_DRV &amp;&amp;
[a85e5ce]189
190unset GLL_DRV &amp;&amp;
191
[1199613]192make</userinput></screen>
[868c7c2]193
[a07e9eb]194 <para>
[7dd7061]195 If you have applied the xdemos patch, build the demo programs by
[a07e9eb]196 running the following command:
197 </para>
198
[5f26d66f]199<screen><userinput>make -C xdemos DEMOS_PREFIX=$XORG_PREFIX</userinput></screen>
[a07e9eb]200
[eb425b4]201 <para>
[21da3b5]202 To test the results, issue: <command>make -k check</command>.
[eb425b4]203 </para>
[ff55539b]204
[eb425b4]205 <para>
206 Now, as the <systemitem class="username">root</systemitem> user:
207 </para>
[ff55539b]208
[dae25ca5]209<screen role="root"><userinput>make install</userinput></screen>
[a07e9eb]210
211 <para>
[5f91dfd]212 If you have built the demo programs, install them by running the
[a07e9eb]213 following command as the
214 <systemitem class="username">root</systemitem> user:
215 </para>
216
[5f26d66f]217<screen role="root"><userinput>make -C xdemos DEMOS_PREFIX=$XORG_PREFIX install</userinput></screen>
[a07e9eb]218
[eb425b4]219 <para>
[a07e9eb]220 If desired, install the optional documentation by running
221 the following commands as the
[eb425b4]222 <systemitem class="username">root</systemitem> user:
223 </para>
[91859cf]224
[7a395d1]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>
[5a883bc4]227
[868c7c2]228 </sect2>
229
[a07e9eb]230 <sect2 role="commands">
231 <title>Command Explanations</title>
232
[95e8211]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
[fd2f9a2]237 debugging symbols which make them bigger. Override the default
[8b5a6f57]238 flags to omit the -g compiler flag so the final libraries are smaller.
[95e8211]239 </para>
240
[b642036d]241 <para>
242 <parameter>LDFLAGS=-lLLVM</parameter>: This environment variable
243 specifies the LLVM libraries that are not automatically included
244 for some of the package components.
245 </para>
246
[eb425b4]247 <para>
[6825eb89]248 <parameter>--enable-texture-float</parameter>: This switch enables
[a07e9eb]249 floating-point textures and render buffers. Please consult
[eb425b4]250 <filename>docs/patents.txt</filename> to see if there are
251 any legal issues if you use this feature.
252 </para>
253
[2993b2f]254 <para>
[df343952]255 <parameter>--enable-osmesa</parameter>: This switch enables building
[abdc2e6]256 the <filename class="libraryfile">libOSMesa</filename> library.
[2993b2f]257 </para>
258
[eb425b4]259 <para>
[8b5a6f57]260 <parameter>--enable-xa</parameter>: This switch enables building the
[eb425b4]261 XA X Acceleration API (Required for VMware 3D Driver).
262 </para>
263
264 <para>
[8b5a6f57]265 <parameter>--enable-gbm</parameter>: This switch enables building the
[a07e9eb]266 <application>Mesa</application> Graphics Buffer Manager library.
267 </para>
268
[eb425b4]269 <para>
[6825eb89]270 <parameter>--enable-glx-tls</parameter>: This switch enables TLS (Thread Local
[4d92247]271 Storage) support in GLX.
[eb425b4]272 </para>
273
[a07e9eb]274 <para>
[d95f8916]275 <parameter>--with-platforms="..."</parameter>: This parameter
[e56f38b]276 controls which platforms EGL will be built for. Available
[a07e9eb]277 platforms are drm, x11 and wayland.
278 </para>
279
[eb425b4]280 <para>
281 <parameter>--with-gallium-drivers="..."</parameter>: This parameter
[973dabe9]282 controls which Gallium3D drivers should be built.
[1f44775e]283 </para>
284
[df343952]285 <para revision="sysv">
[625079b6]286 <option>--enable-sysfs</option>: Use this switch to enable simple PCI
287 identification method, required for building DRI on systems without udev.
288 </para>
289
[371ff30]290 </sect2>
291
[868c7c2]292 <sect2 role="content">
293 <title>Contents</title>
294
295 <segmentedlist>
[1263ab1e]296 <segtitle>Installed Programs</segtitle>
[868c7c2]297 <segtitle>Installed Libraries</segtitle>
[ba2ac60]298 <segtitle>Installed Directories</segtitle>
[868c7c2]299
300 <seglistitem>
[eb425b4]301 <seg>
302 glxgears and glxinfo
303 </seg>
304 <seg>
[ed6d075]305 libEGL.so,
[c5f6157a]306 libgbm.so,
307 libglapi.so,
[ed6d075]308 libGLESv1_CM.so,
[5a14a19]309 libGLESv2.so,
[c5f6157a]310 libGL.so,
[a640d58]311 libOSMesa.so,
[464f030]312<!-- Those libraries are associated with the "swr" gallium driver,
313 which has been removed at r17757. Keeping as a comment in case we
[2f59d11]314 reintroduce that driver. AVX libs are restored in version 18.0.1 -->
[df343952]315 libswrAVX.so,
[2f59d11]316 libswrAVX2.so,
[8b5a6f57]317 libwayland-egl.so (if built with <application>Wayland</application>)
[b3be1cd]318 libxatracker.so,
[a640d58]319 libXvMCnouveau.so,
320 and libXvMCr600.so
[eb425b4]321 </seg>
322 <seg>
[880727e]323 $XORG_PREFIX/{include/{EGL,GL,GLES,GLES2,GLES3,KHR},lib/{dri,vdpau}}
324 and
[7a395d1]325 /usr/share/doc/mesa-&mesa-version; (optional)
[eb425b4]326 </seg>
[868c7c2]327 </seglistitem>
328 </segmentedlist>
[d3ef1e4]329
[4437f63]330 <variablelist>
331 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
332 <?dbfo list-presentation="list"?>
333 <?dbhtml list-presentation="table"?>
334
335 <varlistentry id="glxgears">
[eb50ddde]336 <term><command>glxgears</command></term>
[4437f63]337 <listitem>
[eb425b4]338 <para>
339 is a GL demo useful for troubleshooting graphics
340 problems.
341 </para>
[7a395d1]342 <indexterm zone="mesa glxgears">
[4437f63]343 <primary sortas="b-glxgears">glxgears</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="glxinfo">
[eb50ddde]349 <term><command>glxinfo</command></term>
[4437f63]350 <listitem>
[eb425b4]351 <para>
352 is a diagnostic program that displays information about the
353 graphics hardware and installed GL libraries.
354 </para>
[7a395d1]355 <indexterm zone="mesa glxinfo">
[4437f63]356 <primary sortas="b-glxinfo">glxinfo</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
[25f6d94]361 <varlistentry id="libEGL">
[a07e9eb]362 <term><filename class="libraryfile">libEGL.so</filename></term>
[25f6d94]363 <listitem>
[eb425b4]364 <para>
[a07e9eb]365 provides a native platform graphics interface as
366 defined by the EGL-1.4 specification.
[eb425b4]367 </para>
[7a395d1]368 <indexterm zone="mesa libEGL">
[25f6d94]369 <primary sortas="c-libGL">libEGL.so</primary>
370 </indexterm>
371 </listitem>
372 </varlistentry>
373
[a07e9eb]374 <varlistentry id="libgbm">
375 <term><filename class="libraryfile">libgbm.so</filename></term>
376 <listitem>
377 <para>
378 is the <application>Mesa</application> Graphics Buffer
[0d7900a]379 Manager library.
[a07e9eb]380 </para>
[7a395d1]381 <indexterm zone="mesa libgbm">
[a07e9eb]382 <primary sortas="c-libgbm">libgbm.so</primary>
383 </indexterm>
384 </listitem>
385 </varlistentry>
386
387 <varlistentry id="libGLESv1_CM">
388 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
389 <listitem>
390 <para>
391 is the <application>Mesa</application> OpenGL ES 1.1 library.
392 </para>
[7a395d1]393 <indexterm zone="mesa libGLESv1_CM">
[a07e9eb]394 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
395 </indexterm>
396 </listitem>
397 </varlistentry>
398
399 <varlistentry id="libGLES2">
400 <term><filename class="libraryfile">libGLES2.so</filename></term>
401 <listitem>
402 <para>
403 is the <application>Mesa</application> OpenGL ES 2.0 library.
404 </para>
[7a395d1]405 <indexterm zone="mesa libGLES2">
[a07e9eb]406 <primary sortas="c-libGLES2">libGLES2.so</primary>
407 </indexterm>
408 </listitem>
409 </varlistentry>
410
[ba2ac60]411 <varlistentry id="libGL">
[a07e9eb]412 <term><filename class="libraryfile">libGL.so</filename></term>
[ba2ac60]413 <listitem>
[eb425b4]414 <para>
[a07e9eb]415 is the main <application>Mesa</application> OpenGL library.
[eb425b4]416 </para>
[7a395d1]417 <indexterm zone="mesa libGL">
[ba2ac60]418 <primary sortas="c-libGL">libGL.so</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
[2993b2f]423 <varlistentry id="libOSMesa">
424 <term><filename class="libraryfile">libOSMesa.so</filename></term>
425 <listitem>
426 <para>
427 is the <application>Mesa</application> Off-screen Rendering library.
428 </para>
[7a395d1]429 <indexterm zone="mesa libOSMesa">
[2993b2f]430 <primary sortas="c-libOSMesa">libOSMesa.so</primary>
431 </indexterm>
432 </listitem>
433 </varlistentry>
434
[bad6be19]435 <varlistentry id="libxatracker">
[a07e9eb]436 <term><filename class="libraryfile">libxatracker.so</filename></term>
[ba2ac60]437 <listitem>
[eb425b4]438 <para>
[a07e9eb]439 is the Xorg Gallium3D acceleration library.
[eb425b4]440 </para>
[7a395d1]441 <indexterm zone="mesa libxatracker">
[bad6be19]442 <primary sortas="c-libxatracker">libxatracker.so</primary>
[ba2ac60]443 </indexterm>
444 </listitem>
445 </varlistentry>
[4437f63]446 </variablelist>
447
[868c7c2]448 </sect2>
[d3ef1e4]449
[868c7c2]450</sect1>
Note: See TracBrowser for help on using the repository browser.