source: x/installing/mesalib-systemd.xml@ 7d511f08

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

Update to cmake-3.3.0
Update to graphite2-1.3.0
Update to harfbuzz-1.0.1
Update to xproto-7.0.28.
Update to mesa-10.6.3
Update to polkit-0.113
Update to libdrm-2.4.62
Update to libepoxy-1.3.1
Update to gdk-pixbuf-2.31.5
Update to librsvg-2.40.10
Update to gtk+-3.16.6
Update to adwaita-icon-theme-3.16.2.1
Update wpa_supplicant instructions to reflect that the services cannot both be enabled at the same time
Remove FTP URLs for some Mozilla packages
Fix a build problem with xf86-video-intel
Fix URLs in MariaDB and SDL pages
Typo fix in the Linux-PAM-1.2.0 page
Clarify that libjpeg-turbo is required for the libtiff test suite
Typo fix in the xorg-server-1.17.2 page

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16335 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 13.1 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 "553e525d2f20ed48fca8f1ec3176fd83">
10 <!ENTITY mesalib-size "6.8 MB">
11 <!ENTITY mesalib-buildsize "302 MB">
12 <!ENTITY mesalib-time "9 SBU">
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 libwayland-egl.so,
277 libxatracker.so,
278 libXvMCnouveau.so, and
279 libXvMCr600.so
280 </seg>
281 <seg>
282 /usr/include/{EGL,GL,GLES},
283 /usr/include/{GLES2,GLES3,KHR},
284 /usr/lib/dri,
285 /usr/lib/vdpau, and
286 /usr/share/doc/mesa-&mesalib-version;
287 </seg>
288 </seglistitem>
289 </segmentedlist>
290
291 <variablelist>
292 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
293 <?dbfo list-presentation="list"?>
294 <?dbhtml list-presentation="table"?>
295
296 <varlistentry id="glxgears">
297 <term><command>glxgears</command></term>
298 <listitem>
299 <para>
300 is a GL demo useful for troubleshooting graphics
301 problems.
302 </para>
303 <indexterm zone="mesalib glxgears">
304 <primary sortas="b-glxgears">glxgears</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="glxinfo">
310 <term><command>glxinfo</command></term>
311 <listitem>
312 <para>
313 is a diagnostic program that displays information about the
314 graphics hardware and installed GL libraries.
315 </para>
316 <indexterm zone="mesalib glxinfo">
317 <primary sortas="b-glxinfo">glxinfo</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="libEGL">
323 <term><filename class="libraryfile">libEGL.so</filename></term>
324 <listitem>
325 <para>
326 provides a native platform graphics interface as
327 defined by the EGL-1.4 specification.
328 </para>
329 <indexterm zone="mesalib libEGL">
330 <primary sortas="c-libGL">libEGL.so</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="libgbm">
336 <term><filename class="libraryfile">libgbm.so</filename></term>
337 <listitem>
338 <para>
339 is the <application>Mesa</application> Graphics Buffer
340 Manager library.
341 </para>
342 <indexterm zone="mesalib libgbm">
343 <primary sortas="c-libgbm">libgbm.so</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="libGLESv1_CM">
349 <term><filename class="libraryfile">libGLESv1_CM.so</filename></term>
350 <listitem>
351 <para>
352 is the <application>Mesa</application> OpenGL ES 1.1 library.
353 </para>
354 <indexterm zone="mesalib libGLESv1_CM">
355 <primary sortas="c-libGLESv1_CM">libGLESv1_CM.so</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 <varlistentry id="libGLES2">
361 <term><filename class="libraryfile">libGLES2.so</filename></term>
362 <listitem>
363 <para>
364 is the <application>Mesa</application> OpenGL ES 2.0 library.
365 </para>
366 <indexterm zone="mesalib libGLES2">
367 <primary sortas="c-libGLES2">libGLES2.so</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="libGL">
373 <term><filename class="libraryfile">libGL.so</filename></term>
374 <listitem>
375 <para>
376 is the main <application>Mesa</application> OpenGL library.
377 </para>
378 <indexterm zone="mesalib libGL">
379 <primary sortas="c-libGL">libGL.so</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="libwayland-egl">
385 <term><filename class="libraryfile">libwayland-egl.so</filename></term>
386 <listitem>
387 <para>
388 is the <application>Wayland</application> specific EGL library.
389 </para>
390 <indexterm zone="mesalib libwayland-egl">
391 <primary sortas="c-libwayland-egl">libwayland-egl.so</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="libxatracker">
397 <term><filename class="libraryfile">libxatracker.so</filename></term>
398 <listitem>
399 <para>
400 is the Xorg Gallium3D acceleration library.
401 </para>
402 <indexterm zone="mesalib libxatracker">
403 <primary sortas="c-libxatracker">libxatracker.so</primary>
404 </indexterm>
405 </listitem>
406 </varlistentry>
407 </variablelist>
408
409 </sect2>
410
411</sect1>
Note: See TracBrowser for help on using the repository browser.