source: x/lib/mesalib.xml@ d9c80e1

10.0 10.1 11.0 11.1 11.2 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 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 plabs/python-mods qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since d9c80e1 was d9c80e1, checked in by Randy McMurchy <randy@…>, 17 years ago

Removed excess EOL whitespace from all package instructions in the 'x' chapters

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

  • Property mode set to 100644
File size: 7.4 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://prdownloads.sourceforge.net/mesa3d/MesaLib-&mesalib-version;.tar.bz2">
8 <!ENTITY mesalib-download-ftp " ">
9 <!ENTITY mesalib-md5sum "7674d2c603b5834259e4e5a820cefd5b">
10 <!ENTITY mesalib-size "3.9 MB">
11 <!ENTITY mesalib-buildsize "672 MB">
12 <!ENTITY mesalib-time "2.2 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 <keywordset>
22 <keyword role="package">MesaLib-&mesalib-version;.tar</keyword>
23 <keyword role="ftpdir">MesaLib</keyword>
24 </keywordset>
25 </sect1info>
26
27 <title>MesaLib-&mesalib-version;</title>
28
29 <indexterm zone="MesaLib">
30 <primary sortas="a-MesaLib">MesaLib</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to MesaLib</title>
35
36 <para><application>Mesa</application> is an OpenGL compatible 3-D graphics
37 library.</para>
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>Download (HTTP): <ulink url="&mesalib-download-http;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download (FTP): <ulink url="&mesalib-download-ftp;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download MD5 sum: &mesalib-md5sum;</para>
49 </listitem>
50 <listitem>
51 <para>Download size (including Recommended downloads):
52 &mesalib-size;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated disk space required (including Recommended downloads):
56 &mesalib-buildsize;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated build time (including Recommended downloads):
60 &mesalib-time;</para>
61 </listitem>
62 </itemizedlist>
63
64 <bridgehead renderas="sect3">MesaLib Dependencies</bridgehead>
65
66 <bridgehead renderas="sect4">Required</bridgehead>
67 <para>X (<xref linkend="xorg"/>, <xref linkend="xfree86"/>, or
68 <xref linkend="xorg7"/> Libs and Utilities), and
69 <xref linkend="libdrm"/></para>
70
71 <bridgehead renderas="sect3">Recommended Downloads</bridgehead>
72 <para><ulink
73 url="http://prdownloads.sourceforge.net/mesa3d/MesaGLUT-&mesalib-version;.tar.bz2"/>
74 provides a working <filename class='libraryfile'>libglut</filename>
75 (needed for the demos).</para>
76
77 <para><ulink
78 url="http://prdownloads.sourceforge.net/mesa3d/MesaDemos-&mesalib-version;.tar.bz2"/>
79 provides a demo and a diagnostic program to verify that GL is working
80 properly.</para>
81
82 <note>
83 <para>You should extract all three tarballs from the same toplevel
84 directory. All three files will extract to the
85 <filename class="directory">Mesa-&mesalib-version;</filename>
86 directory.</para>
87 </note>
88
89 </sect2>
90
91 <sect2 role="installation">
92 <title>Installation of MesaLib</title>
93
94 <para>If you've installed the X Window System into any prefix other than
95 <filename class="directory">/usr</filename>, then you'll need to adjust the
96 commands below for your system. Correct several hard coded directories
97 in the source files with the following commands:</para>
98
99<screen><userinput>find . -type f -exec sed -i 's@/usr/X11R6@/usr@g' {} \; &amp;&amp;
100sed -i 's@lib/modules@lib/X11/modules@' src/glx/x11/dri_glx.c</userinput></screen>
101
102 <para>Install <application>MesaLib</application>
103 by running the following command:</para>
104
105<screen><userinput>make linux-dri</userinput></screen>
106
107 <para>This package does not come with a test suite.</para>
108
109 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
110
111<screen role="root"><userinput>bin/installmesa /usr &amp;&amp;
112mkdir -v -p /usr/lib/X11/modules/dri &amp;&amp;
113install -v -m755 lib/*dri* /usr/lib/X11/modules/dri</userinput></screen>
114
115 <para>If you've extracted the GLUT and Demos packages as well, then
116 build the test programs with the following commands:</para>
117
118<screen><userinput>cd progs/xdemos &amp;&amp;
119make PROGS='glxinfo glxgears'</userinput></screen>
120
121 <para>Install the demos as the
122 <systemitem class="username">root</systemitem> user:</para>
123
124<screen role="root"><userinput>install -v -m755 glxinfo glxgears /usr/bin</userinput></screen>
125
126 <note>
127 <para>If building <xref linkend="xorg7"/>, do not
128 remove the Mesa source tree yet, it will be required to build the
129 X server.</para>
130 </note>
131
132 <para>Finally, if installing to any prefix other than
133 <filename class="directory">/usr</filename>, you should create symlinks
134 to the GL headers in <filename class="directory">/usr/include</filename>.
135 Execute the following command as the
136 <systemitem class="username">root</systemitem> user:</para>
137
138<screen><userinput role="root">ln -s -v <replaceable>[/usr/X11]</replaceable>/include/GL /usr/include</userinput></screen>
139
140 </sect2>
141
142 <sect2 role="commands">
143 <title>Command Explanations</title>
144
145 <para><command>find...sed -i 's@/usr/X11R6@/usr@'...</command>: This
146 command corrects several hard coded references to the X11R6 default
147 installation path.</para>
148
149 <para><command>sed -i 's@lib/modules@lib/X11/modules@'
150 src/glx/x11/dri_glx.c</command>: This command corrects a hard coded
151 reference to the module directory.</para>
152
153 <para><command>bin/installmesa</command>: Mesa uses a custom installation
154 script as opposed to the normal <parameter>install</parameter> make
155 target.</para>
156
157 <para><command>install -v -m755 lib/*dri*
158 /usr/lib/X11/modules/dri</command>: installs the DRI modules.</para>
159
160 <para><command>make PROGS='glxinfo glxgears'</command>: build only
161 the glxinfo and glxgears programs.</para>
162
163 <para><command>install -v -m755 glxinfo glxgears /usr/bin</command>:
164 Installs only the glxinfo and glxgears programs.</para>
165
166 </sect2>
167
168 <sect2 role="content">
169 <title>Contents</title>
170
171 <segmentedlist>
172 <segtitle>Installed Programs</segtitle>
173 <segtitle>Installed Libraries</segtitle>
174 <segtitle>Installed Directories</segtitle>
175
176 <seglistitem>
177 <seg>glxgears and glxinfo</seg>
178 <seg>libGL.[so,a], libGLU.[so,a], libGLw.[so,a], libglut.[so,a] and
179 *_dri.so</seg>
180 <seg>$XORG_PREFIX/lib/modules/dri</seg>
181 </seglistitem>
182 </segmentedlist>
183
184 <variablelist>
185 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
186 <?dbfo list-presentation="list"?>
187 <?dbhtml list-presentation="table"?>
188
189 <varlistentry id="glxgears">
190 <term><filename>glxgears</filename></term>
191 <listitem>
192 <para>a GL demo useful for troubleshooting graphics problems.</para>
193 <indexterm zone="MesaLib glxgears">
194 <primary sortas="b-glxgears">glxgears</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 <varlistentry id="glxinfo">
200 <term><filename>glxinfo</filename></term>
201 <listitem>
202 <para>a diagnostic program that displays information about the
203 graphics hardware and installed GL libraries.</para>
204 <indexterm zone="MesaLib glxinfo">
205 <primary sortas="b-glxinfo">glxinfo</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 </variablelist>
211
212 </sect2>
213
214</sect1>
Note: See TracBrowser for help on using the repository browser.