source: x/installing/mesalib-systemd.xml@ 0a2c1e6c

systemd-13485
Last change on this file since 0a2c1e6c was 8770a48, checked in by Douglas R. Reno <renodr@…>, 9 years ago

Update to doxygen-1.8.10
Update to OpenJDK-1.8.0.51
Update to check-0.10.0
Fix a build error in Valgrind using glibc-2.22
Update to GnuTLS-3.4.4.1
Update to acpid-2.0.25
Update to cURL-7.44.0
Update to libpng-1.6.18
Update to cmake-3.3.1
Update to harfbuzz-1.0.2
Update to libdrm-2.4.64
Update to Mesa-10.6.4 (will wait for 11.x release for next update)
Update to Linux-PAM-1.2.1
Update to xterm-319
Update to gdk-pixbuf-2.31.6
Update to vala-0.28.1
Update to LVM2-2.02.128
Update to openbox-3.6.1
Update to PIN-Entry-0.9.5
Update to GnuPG-2.1.7
Update to gcr-3.16.0
Fix URL for gsettings-desktop-schemas-3.16.1
Add some short descriptions by Denis.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16358 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 13.5 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 mesalib-download-http " ">
8 <!ENTITY mesalib-download-ftp "ftp://ftp.freedesktop.org/pub/mesa/&mesalib-version;/mesa-&mesalib-version;.tar.bz2">
9 <!ENTITY mesalib-md5sum "45092472f7abef40a7deab282d7954ba">
10 <!ENTITY mesalib-size "6.7 MB">
11 <!ENTITY mesalib-buildsize "296 MB">
12 <!ENTITY mesalib-time "9 SBU (with the test suite)">
13]>
14
15<sect1 id="mesalib" xreflabel="Mesa-&mesalib-version;">
16 <?dbhtml filename="mesalib.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Mesa-&mesalib-version;</title>
24
25 <indexterm zone="mesalib">
26 <primary sortas="a-MesaLib">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 &lfs77_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&mesalib-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&mesalib-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &mesalib-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &mesalib-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &mesalib-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &mesalib-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 url="&patch-root;/mesa-&mesalib-version;-add_xdemos-1.patch"/>
79 </para>
80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">Mesa Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required">
87 <xref linkend="libdrm"/> and
88 <xref linkend="xorg7-lib"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <xref linkend="elfutils"/> (required for Gallium3D radeonsi driver),
94 <xref linkend="libva"/> (to build VAAPI drivers for supported hardware),
95 <xref linkend="libvdpau"/> (to build VDPAU drivers for supported hardware),
96 <xref linkend="llvm"/> (required for Gallium3D r300 and radeonsi drivers and
97 also for llvmpipe which is intended to be the fastest of the three software
98 rasterizers, see <ulink url="http://www.mesa3d.org/faq.html#part3"></ulink>)
99 and <xref linkend="wayland"/> (required to build the
100 <filename>libwayland-egl</filename> library which is used by many packages
101 that use <application>Wayland</application>)
102 </para>
103
104 <bridgehead renderas="sect4">Optional</bridgehead>
105 <para role="optional">
106 <ulink url="http://libclc.llvm.org/">libclc</ulink>
107 (to build Radeon OpenCL library) and
108 <ulink url="http://omxil.sourceforge.net/">libomxil-bellagio</ulink>
109 (to build Radeon OpenMAX driver)
110 </para>
111
112 <note>
113 <para>
114 The instructions below assume that <application>elfutils</application>
115 and <application>LLVM</application> are installed. You will
116 need to modify the instructions if you choose not to install them.
117 Please note that <application>elfutils</application> and
118 <application>LLVM</application> are <emphasis>required</emphasis>
119 for Gallium3D r300 and radeonsi drivers. For an explanation of
120 Gallium3D please see
121 <ulink url="https://en.wikipedia.org/wiki/Gallium3D"></ulink>.
122 </para>
123 </note>
124
125 <para condition="html" role="usernotes">User Notes:
126 <ulink url="&blfs-wiki;/mesa"/>
127 </para>
128 </sect2>
129
130 <sect2 role="installation">
131 <title>Installation of Mesa</title>
132
133 <para>
134 If you have downloaded the xdemos patch (needed if testing the Xorg
135 installation per BLFS instructions), apply it by running the following
136 command:
137 </para>
138
139<screen><userinput>patch -Np1 -i ../mesa-&mesalib-version;-add_xdemos-1.patch</userinput></screen>
140
141 <para>
142 Install <application>Mesa</application> by running the following
143 commands:
144 </para>
145
146<screen><userinput>./configure CFLAGS="-O2" CXXFLAGS="-O2" \
147 --prefix=/usr \
148 --sysconfdir=/etc \
149 --enable-texture-float \
150 --enable-gles1 \
151 --enable-gles2 \
152 --enable-xa \
153 --enable-glx-tls \
154 --enable-osmesa \
155 --with-egl-platforms="drm,x11,wayland" \
156 --with-gallium-drivers="nouveau,r300,r600,radeonsi,svga,swrast" &amp;&amp;
157make</userinput></screen>
158
159 <para>
160 If you have applied the xdemos patch, build the demo programs by
161 running the following command:
162 </para>
163
164<screen><userinput>make -C xdemos DEMOS_PREFIX=/usr</userinput></screen>
165
166 <para>
167 To test the results, issue: <command>make check</command>.
168 </para>
169
170 <para>
171 Now, as the <systemitem class="username">root</systemitem> user:
172 </para>
173
174<screen role="root"><userinput>make install</userinput></screen>
175
176 <para>
177 If you have built the demo programs, install them by running the
178 following command as the
179 <systemitem class="username">root</systemitem> user:
180 </para>
181
182<screen role="root"><userinput>make -C xdemos DEMOS_PREFIX=/usr install</userinput></screen>
183
184 <para>
185 If desired, install the optional documentation by running
186 the following commands as the
187 <systemitem class="username">root</systemitem> user:
188 </para>
189
190<screen role="root"><userinput>install -v -dm755 /usr/share/doc/mesa-&mesalib-version; &amp;&amp;
191cp -rfv docs/* /usr/share/doc/mesa-&mesalib-version;</userinput></screen>
192
193 </sect2>
194
195 <sect2 role="commands">
196 <title>Command Explanations</title>
197
198 <para>
199 <parameter>CFLAGS="-O2" CXXFLAGS="-O2"</parameter>: By default,
200 <application>Autoconf</application> sets CFLAGS and CXXFLAGS to
201 "-g -O2". That results in binaries and libraries being built with
202 debugging symbols which make them bigger. Override the default
203 flags to omit -g compiler flag so the final libraries are smaller.
204 </para>
205
206 <para>
207 <parameter>--enable-texture-float</parameter>: This switch enables
208 floating-point textures and render buffers. Please consult
209 <filename>docs/patents.txt</filename> to see if there are
210 any legal issues if you use this feature.
211 </para>
212
213 <para>
214 <parameter>--enable-gles1</parameter>: This switch enables support for
215 OpenGL ES 1.x API.
216 </para>
217
218 <para>
219 <parameter>--enable-gles2</parameter>: This switch enables support for
220 OpenGL ES 2.x API.
221 </para>
222
223 <para>
224 <parameter>--enable-xa</parameter>: This switch enables building of the
225 XA X Acceleration API (Required for VMware 3D Driver).
226 </para>
227
228 <para>
229 <parameter>--enable-glx-tls</parameter>: This switch enables TLS (Thread
230 Local Storage) support in GLX.
231 </para>
232
233 <para>
234 <parameter>--enable-osmesa</parameter>: This switch enables building of
235 the libOSMesa library.
236 </para>
237
238 <para>
239 <parameter>--with-egl-platforms="..."</parameter>: This parameter
240 controls for which platforms EGL should be built. Available
241 platforms are drm, x11 and wayland. Remove <option>wayland</option>
242 from the list if you did not install
243 <application>Wayland</application>.
244 </para>
245
246 <para>
247 <parameter>--with-gallium-drivers="..."</parameter>: This parameter
248 controls which Gallium3D drivers should be built. Available drivers
249 are: i915, ilo, nouveau, r300, r600, radeonsi, svga and swrast. You
250 will need to remove r300 and radeonsi from the list if you did
251 not install <application>elfutils</application> and
252 <application>LLVM</application>.
253 </para>
254
255 </sect2>
256
257 <sect2 role="content">
258 <title>Contents</title>
259
260 <segmentedlist>
261 <segtitle>Installed Programs</segtitle>
262 <segtitle>Installed Libraries</segtitle>
263 <segtitle>Installed Directories</segtitle>
264
265 <seglistitem>
266 <seg>
267 glxgears and glxinfo
268 </seg>
269 <seg>
270 libEGL.so,
271 libgbm.so,
272 libglapi.so,
273 libGLESv1_CM.so,
274 libGLESv2.so,
275 libGL.so,
276 libOSMesa.so,
277 libwayland-egl.so,
278 libxatracker.so,
279 libXvMCnouveau.so, and
280 libXvMCr600.so
281 </seg>
282 <seg>
283 /usr/include/{EGL,GL,GLES},
284 /usr/include/{GLES2,GLES3,KHR},
285 /usr/lib/dri,
286 /usr/lib/vdpau, and
287 /usr/share/doc/mesa-&mesalib-version;
288 </seg>
289 </seglistitem>
290 </segmentedlist>
291
292 <variablelist>
293 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
294 <?dbfo list-presentation="list"?>
295 <?dbhtml list-presentation="table"?>
296
297 <varlistentry id="glxgears">
298 <term><command>glxgears</command></term>
299 <listitem>
300 <para>
301 is a GL demo useful for troubleshooting graphics
302 problems.
303 </para>
304 <indexterm zone="mesalib glxgears">
305 <primary sortas="b-glxgears">glxgears</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 <varlistentry id="glxinfo">
311 <term><command>glxinfo</command></term>
312 <listitem>
313 <para>
314 is a diagnostic program that displays information about the
315 graphics hardware and installed GL libraries.
316 </para>
317 <indexterm zone="mesalib glxinfo">
318 <primary sortas="b-glxinfo">glxinfo</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="libEGL">
324 <term><filename class="libraryfile">libEGL.so</filename></term>
325 <listitem>
326 <para>
327 provides a native platform graphics interface as
328 defined by the EGL-1.4 specification.
329 </para>
330 <indexterm zone="mesalib libEGL">
331 <primary sortas="c-libGL">libEGL.so</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="libgbm">
337 <term><filename class="libraryfile">libgbm.so</filename></term>
338 <listitem>
339 <para>
340 is the <application>Mesa</application> Graphics Buffer
341 Manager library.
342 </para>
343 <indexterm zone="mesalib libgbm">
344 <primary sortas="c-libgbm">libgbm.so</primary>
345 </indexterm>
346 </listitem>
347 </varlistentry>
348
349 <varlistentry id="libGLESv1_CM">
350 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
351 <listitem>
352 <para>
353 is the <application>Mesa</application> OpenGL ES 1.1 library.
354 </para>
355 <indexterm zone="mesalib libGLESv1_CM">
356 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
361 <varlistentry id="libGLES2">
362 <term><filename class="libraryfile">libGLES2.so</filename></term>
363 <listitem>
364 <para>
365 is the <application>Mesa</application> OpenGL ES 2.0 library.
366 </para>
367 <indexterm zone="mesalib libGLES2">
368 <primary sortas="c-libGLES2">libGLES2.so</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="libGL">
374 <term><filename class="libraryfile">libGL.so</filename></term>
375 <listitem>
376 <para>
377 is the main <application>Mesa</application> OpenGL library.
378 </para>
379 <indexterm zone="mesalib libGL">
380 <primary sortas="c-libGL">libGL.so</primary>
381 </indexterm>
382 </listitem>
383 </varlistentry>
384
385 <varlistentry id="libOSMesa">
386 <term><filename class="libraryfile">libOSMesa.so</filename></term>
387 <listitem>
388 <para>
389 is the Mesa off screen rendering library.
390 </para>
391 <indexterm zone="mesalib libOSMesa">
392 <primary sortas="c-libOSMesa">libOSMesa.so</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="libwayland-egl">
398 <term><filename class="libraryfile">libwayland-egl.so</filename></term>
399 <listitem>
400 <para>
401 is the <application>Wayland</application> specific EGL library.
402 </para>
403 <indexterm zone="mesalib libwayland-egl">
404 <primary sortas="c-libwayland-egl">libwayland-egl.so</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="libxatracker">
410 <term><filename class="libraryfile">libxatracker.so</filename></term>
411 <listitem>
412 <para>
413 is the Xorg Gallium3D acceleration library.
414 </para>
415 <indexterm zone="mesalib libxatracker">
416 <primary sortas="c-libxatracker">libxatracker.so</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420 </variablelist>
421
422 </sect2>
423
424</sect1>
Note: See TracBrowser for help on using the repository browser.