source: x/lib/mesalib.xml@ 25a6c5c

10.0 10.1 11.0 11.1 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 25a6c5c was 25a6c5c, checked in by Randy McMurchy <randy@…>, 15 years ago

Removed the obsolete and unmaintained Xorg-6.9 package

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

  • Property mode set to 100644
File size: 9.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY mesalib-download-http "http://downloads.sourceforge.net/mesa3d/MesaLib-&mesalib-version;.tar.bz2">
8 <!ENTITY mesalib-download-ftp " ">
9 <!ENTITY mesalib-md5sum "61beda590bfc5b4a12e979d5f2d70d7a">
10 <!ENTITY mesalib-size "3.3 MB">
11 <!ENTITY mesalib-buildsize "823 MB">
12 <!ENTITY mesalib-time "1.7 SBU">
13]>
14
15<sect1 id="mesalib" xreflabel="MesaLib-&mesalib-version;">
16 <?dbhtml filename="mesalib.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>MesaLib-&mesalib-version;</title>
24
25 <indexterm zone="mesalib">
26 <primary sortas="a-MesaLib">MesaLib</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to MesaLib</title>
31
32 <para><application>Mesa</application> is an OpenGL compatible 3-D graphics
33 library.</para>
34
35 <bridgehead renderas="sect3">Package Information</bridgehead>
36 <itemizedlist spacing="compact">
37 <listitem>
38 <para>Download (HTTP): <ulink url="&mesalib-download-http;"/></para>
39 </listitem>
40 <listitem>
41 <para>Download (FTP): <ulink url="&mesalib-download-ftp;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download MD5 sum: &mesalib-md5sum;</para>
45 </listitem>
46 <listitem>
47 <para>Download size (including recommended download):
48 &mesalib-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required (including recommended download):
52 &mesalib-buildsize;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated build time (including recommended download):
56 &mesalib-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">MesaLib Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Required</bridgehead>
63 <para role="required"><xref linkend="xorg7-lib"/>,
64 <xref linkend="xorg7-util"/>, and
65 <xref linkend="libdrm"/></para>
66
67 <note>
68 <para>It is not recommended to build a newer version of
69 <application>Mesa</application> with <xref linkend="xfree86"/>.</para>
70 </note>
71
72 <bridgehead renderas="sect3">Recommended Download</bridgehead>
73 <para><ulink
74 url="http://downloads.sourceforge.net/mesa3d/MesaDemos-&mesalib-version;.tar.bz2">MesaDemos-&mesalib-version;</ulink>
75 provides a demo and a diagnostic program to verify that GL is working
76 properly.</para>
77
78 <bridgehead renderas="sect3">Optional Download</bridgehead>
79 <para><ulink
80 url="http://downloads.sourceforge.net/mesa3d/MesaGLUT-&mesalib-version;.tar.bz2">MesaGLUT-&mesalib-version;</ulink>
81 provides a working <filename class='libraryfile'>libglut</filename>.</para>
82
83 <note>
84 <para>You should extract all three tarballs from the same toplevel
85 directory. All three files will extract to the
86 <filename class="directory">Mesa-&mesalib-version;</filename>
87 directory.</para>
88 </note>
89
90 <para condition="html" role="usernotes">User Notes:
91 <ulink url="&blfs-wiki;/mesalib"/></para>
92
93 </sect2>
94
95 <sect2 role="installation">
96 <title>Installation of MesaLib</title>
97
98 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
99 href="../../xincludes/xorg7-only.xml"/>
100
101 <para>You will need to adjust the commands below to reflect the
102 installation prefix of the X Window System. First, correct several
103 hard coded directories in the source files with the following
104 commands:</para>
105
106<screen><userinput>find . -type f -exec sed -i "s@/usr/X11R6@$XORG_PREFIX@g" {} \; &amp;&amp;
107sed -i 's@lib/modules@lib/X11/modules@' src/glx/x11/dri_glx.c &amp;&amp;
108sed -i 's@lib/modules@lib/X11/modules@' \
109 src/mesa/drivers/dri/Makefile.template</userinput></screen>
110
111 <para>Fix an error with output redirection if <command>/bin/sh</command>
112 is not the <application>Bash</application> shell on your system:</para>
113
114<screen><userinput>sed -i 's%&gt;&amp; /dev/null%&gt;/dev/null%' src/mesa/drivers/dri/Makefile.template</userinput></screen>
115
116 <para>Build <application>MesaLib</application>
117 by running the following command:</para>
118
119<screen><userinput>make OPT_FLAGS="-O2 -fno-strict-aliasing" linux-dri-x86</userinput></screen>
120
121 <para>This package does not come with a test suite.</para>
122
123 <para>Now, as the <systemitem class="username">root</systemitem> user,
124 issue the following commands to install
125 <application>MesaLib</application>:</para>
126
127<screen role="root"><userinput>bin/installmesa $XORG_PREFIX</userinput></screen>
128
129 <para>While still the root user, install the modules for
130 Xorg-&xorg7-version; with the following commands.</para>
131
132<screen role="root"><userinput>mkdir -v -p $XORG_PREFIX/lib/X11/modules/dri &amp;&amp;
133install -v -m755 lib/*dri* $XORG_PREFIX/lib/X11/modules/dri</userinput></screen>
134
135 <para>If you've extracted the Demos package as well, then
136 build the test programs with the following commands:</para>
137
138<screen><userinput>sed -i 's@-l$(GLUT_LIB)@@g' configs/default &amp;&amp;
139cd progs/xdemos &amp;&amp;
140make PROGS='glxinfo glxgears'</userinput></screen>
141
142 <para>Install the demos as the
143 <systemitem class="username">root</systemitem> user:</para>
144
145<screen role="root"><userinput>install -v -m755 glxinfo glxgears $XORG_PREFIX/bin</userinput></screen>
146
147 <note>
148 <para>Do not remove the Mesa source tree yet, it will be required to
149 build the <xref linkend="xorg7-server"/>.</para>
150 </note>
151
152 <para>Finally, if installing to any prefix other than
153 <filename class="directory">/usr</filename>, you should create symlinks
154 to the GL headers in <filename class="directory">/usr/include</filename>.
155 Execute the following command as the
156 <systemitem class="username">root</systemitem> user:</para>
157
158<screen role="root"><userinput>ln -s -v $XORG_PREFIX/include/GL /usr/include</userinput></screen>
159
160 </sect2>
161
162 <sect2 role="commands">
163 <title>Command Explanations</title>
164
165 <para><command>find...sed -i
166 "s@/usr/X11R6@$XORG_PREFIX@"...</command>:
167 This command corrects several hard coded references to the X11R6 default
168 installation path.</para>
169
170 <para><command>sed -i 's@lib/modules@lib/X11/modules@'
171 src/glx/x11/dri_glx.c</command>: This command corrects a hard coded
172 reference to the module directory.</para>
173
174 <para><command>make OPT_FLAGS=... linux-dri-x86</command>: A bug where
175 OpenGL applications are shifted to the left by 50% can be worked around
176 by adding <option>-fno-strict-aliasing</option> to the compiler flags.
177 Also, the <option>linux-dri-x86</option> target is specified to use a
178 few other helpful flags in addition to the defaults. See the other
179 targets in the <filename class="directory">configs</filename> directory
180 if your architecture is not x86.</para>
181
182 <para><command>bin/installmesa</command>: Mesa uses a custom installation
183 script as opposed to the normal <parameter>install</parameter> make
184 target.</para>
185
186 <para><command>install -v -m755 lib/*dri*
187 $XORG_PREFIX/lib/X11/modules/dri</command>:
188 installs the DRI modules.</para>
189
190 <para><command>sed -i 's@-l$(GLUT_LIB)@@g' configs/default</command>:
191 disables linking against GLUT libraries for the demo programs.</para>
192
193 <para><command>make PROGS='glxinfo glxgears'</command>: build only
194 the glxinfo and glxgears programs.</para>
195
196 <para><command>install -v -m755 glxinfo glxgears
197 $XORG_PREFIX/bin</command>:
198 Installs only the glxinfo and glxgears programs.</para>
199
200 </sect2>
201
202 <sect2 role="content">
203 <title>Contents</title>
204
205 <segmentedlist>
206 <segtitle>Installed Programs</segtitle>
207 <segtitle>Installed Libraries</segtitle>
208 <segtitle>Installed Directories</segtitle>
209
210 <seglistitem>
211 <seg>glxgears and glxinfo</seg>
212 <seg>libGL.{so,a}, libGLU.{so,a}, libGLw.{so,a}, libglut.{so,a} and
213 *_dri.so</seg>
214 <seg>$XORG_PREFIX/lib/modules/dri</seg>
215 </seglistitem>
216 </segmentedlist>
217
218 <variablelist>
219 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
220 <?dbfo list-presentation="list"?>
221 <?dbhtml list-presentation="table"?>
222
223 <varlistentry id="glxgears">
224 <term><filename>glxgears</filename></term>
225 <listitem>
226 <para>a GL demo useful for troubleshooting graphics problems.</para>
227 <indexterm zone="mesalib glxgears">
228 <primary sortas="b-glxgears">glxgears</primary>
229 </indexterm>
230 </listitem>
231 </varlistentry>
232
233 <varlistentry id="glxinfo">
234 <term><filename>glxinfo</filename></term>
235 <listitem>
236 <para>a diagnostic program that displays information about the
237 graphics hardware and installed GL libraries.</para>
238 <indexterm zone="mesalib glxinfo">
239 <primary sortas="b-glxinfo">glxinfo</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 </variablelist>
245
246 </sect2>
247
248</sect1>
Note: See TracBrowser for help on using the repository browser.