3 <TITLE>Compilation and Installation
</TITLE>
5 <link rel=
"stylesheet" type=
"text/css" href=
"mesa.css"></head>
10 <H1>Compilation and Installation
</H1>
13 <li><a href=
"#unix-x11">Unix / X11
</a>
14 <li><a href=
"#windows">Windows
</a>
15 <li><a href=
"#vms">VMS
</a>
16 <li><a href=
"#other">Other
</a>
22 <H2>1. Unix/X11 Compilation and Installation
</H1>
24 <h3>1.1 Compilation
</h3>
27 Mesa may be compiled in several different ways:
30 <li><b><em>Stand-alone/Xlib mode
</em></b> - Mesa is compiled as
31 a software renderer using Xlib to do all rendering.
32 libGL.so is a self-contained rendering library.
34 To compile stand-alone Mesa type
<b>make
</b> in the top-level directory.
35 You'll see a list of supported system configurations.
36 Choose one from the list (such as linux-x86), and type:
41 <p>This will produce libGL.so and several other libraries
</p>
44 <li><b><em>DRI/accelerated
</em></b> - The DRI hardware drivers (for ATI,
45 Intel, Matrox, etc) are built.
46 libGL.so implements the GLX extension and dynamically loads the DRI drivers.
48 To build the DRI drivers you'll first need to have the DRM (Direct
49 Rendering Manager) kernel drivers and header files.
50 They're available from the
<a href=
"http://dri.sf.net/" target=
"_parent">DRI
</a> project.
53 Your distribution should already have both the kernel modules and support
54 library already installed. If not, you can get them from CVS by doing:
56 cvs -z3 -d:pserver:anonymous@anoncvs.freedesktop.org:/cvs/dri co drm
59 See the
<a href=
"http://dri.freedesktop.org/wiki/Building" target=
"_parent">
60 DRI Building Instructions
</a> for the steps to build the DRM modules. Mesa
61 6.5 requires at least libdrm
2.0.1 or greater.
64 Build Mesa and the DRI drivers by running
70 There are also
<code>linux-dri-x86
</code>,
<code>linux-dri-x86-
64</code>,
71 and
<code>linux-ppc
</code> configurations, optimized for those architectures.
75 Finally, you'll need a DRI-enabled X server from
76 <a href=
"http://freedesktop.org/wiki/Software_2fXserver" target=
"_parent">
77 X.org
</a> or
<a href=
"http://www.xfree86.org" target=
"_parent">XFree86
</a>.
78 Visit those projects' home pages for more information.
86 Later, if you want to rebuild for a different configuration run
87 <code>make realclean
</code> before rebuilding.
91 <h3>1.2 The libraries
</h3>
94 When compilation has finished, look in the top-level
<code>lib/
</code>
96 You'll see a set of library files similar to this:
99 lrwxrwxrwx
1 brian users
10 Mar
26 07:
53 libGL.so -
> libGL.so
.1*
100 lrwxrwxrwx
1 brian users
19 Mar
26 07:
53 libGL.so
.1 -
> libGL.so
.1.5.060100*
101 -rwxr-xr-x
1 brian users
3375861 Mar
26 07:
53 libGL.so
.1.5.060100*
102 lrwxrwxrwx
1 brian users
11 Mar
26 07:
53 libGLU.so -
> libGLU.so
.1*
103 lrwxrwxrwx
1 brian users
20 Mar
26 07:
53 libGLU.so
.1 -
> libGLU.so
.1.3.060100*
104 -rwxr-xr-x
1 brian users
549269 Mar
26 07:
53 libGLU.so
.1.3.060100*
105 lrwxrwxrwx
1 brian users
12 Mar
26 07:
53 libglut.so -
> libglut.so
.3*
106 lrwxrwxrwx
1 brian users
16 Mar
26 07:
53 libglut.so
.3 -
> libglut.so
.3.7.1*
107 -rwxr-xr-x
1 brian users
597754 Mar
26 07:
53 libglut.so
.3.7.1*
108 lrwxrwxrwx
1 brian users
11 Mar
26 08:
04 libGLw.so -
> libGLw.so
.1*
109 lrwxrwxrwx
1 brian users
15 Mar
26 08:
04 libGLw.so
.1 -
> libGLw.so
.1.0.0*
110 -rwxr-xr-x
1 brian users
20750 Mar
26 08:
04 libGLw.so
.1.0.0*
111 lrwxrwxrwx
1 brian users
14 Mar
26 07:
53 libOSMesa.so -
> libOSMesa.so
.6*
112 lrwxrwxrwx
1 brian users
23 Mar
26 07:
53 libOSMesa.so
.6 -
> libOSMesa.so
.6.1.060100*
113 -rwxr-xr-x
1 brian users
23871 Mar
26 07:
53 libOSMesa.so
.6.1.060100*
117 <b>libGL
</b> is the main OpenGL library (i.e. Mesa).
119 <b>libGLU
</b> is the OpenGL Utility library.
121 <b>libglut
</b> is the GLUT library.
123 <b>libGLw
</b> is the Xt/Motif OpenGL drawing area widget library.
125 <b>libOSMesa
</b> is the OSMesa (Off-Screen) interface library.
129 If you built the DRI hardware drivers, you'll also see the DRI drivers:
132 -rwxr-xr-x
1 brian users
11320803 Jul
21 12:
11 mach64_dri.so
133 -rwxr-xr-x
1 brian users
11418014 Jul
21 12:
12 mga_dri.so
134 -rwxr-xr-x
1 brian users
11064426 Jul
21 12:
12 r128_dri.so
135 -rwxr-xr-x
1 brian users
11849858 Jul
21 12:
12 r200_dri.so
136 -rwxr-xr-x
1 brian users
11757388 Jul
21 12:
12 radeon_dri.so
137 -rwxr-xr-x
1 brian users
11232304 Jul
21 12:
13 s3v_dri.so
138 -rwxr-xr-x
1 brian users
11062970 Jul
21 12:
13 savage_dri.so
139 -rwxr-xr-x
1 brian users
11214212 Jul
21 12:
13 sis_dri.so
140 -rwxr-xr-x
1 brian users
11368736 Jul
21 12:
13 tdfx_dri.so
141 -rwxr-xr-x
1 brian users
10598868 Jul
21 12:
13 trident_dri.so
142 -rwxr-xr-x
1 brian users
10997120 Jul
21 12:
13 unichrome_dri.so
146 <h3>1.3 Running the demos
</h3>
149 If you downloaded/unpacked the MesaDemos-x.y.z.tar.gz archive or
150 obtained Mesa from CVS, the
<b>progs/
</b> directory will contain a
151 bunch of demonstration programs.
155 Before running a demo, you may have to set an environment variable
156 (such as
<b>LD_LIBRARY_PATH
</b> on Linux) to indicate where the
157 libraries are located. For example:
160 <b>cd
</b> into the Mesa
<b>lib/
</b> directory.
162 <b>setenv LD_LIBRARY_PATH ${cwd}
</b> (if using csh or tcsh shell)
166 <b>export LD_LIBRARY_PATH=${PWD}
</b> (if using bash or sh shell)
170 Next, change to the Mesa/demos/ directory:
173 <b>cd ../progs/demos
</b>
177 Run a demo such as gears:
184 If this doesn't work, try the
<b>Mesa/progs/xdemos/glxinfo
</b> program
185 and see that it prints the expected Mesa version number.
189 If you're using Linux or a similar OS, verify that the demo program is
190 being linked with the proper library files:
197 You should see something like this:
200 libglut.so
.3 =
> /home/brian/Mesa/lib/libglut.so
.3 (
0x40013000)
201 libGLU.so
.1 =
> /home/brian/Mesa/lib/libGLU.so
.1 (
0x40051000)
202 libGL.so
.1 =
> /home/brian/Mesa/lib/libGL.so
.1 (
0x400e0000)
203 libc.so
.6 =
> /lib/i686/libc.so
.6 (
0x42000000)
204 libm.so
.6 =
> /lib/i686/libm.so
.6 (
0x403da000)
205 libX11.so
.6 =
> /usr/X11R6/lib/libX11.so
.6 (
0x403fc000)
206 libXmu.so
.6 =
> /usr/X11R6/lib/libXmu.so
.6 (
0x404da000)
207 libXt.so
.6 =
> /usr/X11R6/lib/libXt.so
.6 (
0x404f1000)
208 libXi.so
.6 =
> /usr/X11R6/lib/libXi.so
.6 (
0x40543000)
209 libstdc++.so
.5 =
> /usr/lib/libstdc++.so
.5 (
0x4054b000)
210 libgcc_s.so
.1 =
> /lib/libgcc_s.so
.1 (
0x405fd000)
211 libXext.so
.6 =
> /usr/X11R6/lib/libXext.so
.6 (
0x40605000)
212 libpthread.so
.0 =
> /lib/i686/libpthread.so
.0 (
0x40613000)
213 /lib/ld-linux.so
.2 =
> /lib/ld-linux.so
.2 (
0x40000000)
214 libdl.so
.2 =
> /lib/libdl.so
.2 (
0x40644000)
215 libSM.so
.6 =
> /usr/X11R6/lib/libSM.so
.6 (
0x40647000)
216 libICE.so
.6 =
> /usr/X11R6/lib/libICE.so
.6 (
0x40650000)
220 Retrace your steps if this doesn't look right.
224 <H3>1.4 Installing the header and library files
</H3>
227 The standard location for the OpenGL header files on Unix-type systems is
228 in
<code>/usr/include/GL/
</code>.
229 The standard location for the libraries is
<code>/usr/lib/
</code>.
230 For more information see, the
231 <a href=
"http://oss.sgi.com/projects/ogl-sample/ABI/" target=
"_parent">
232 Linux/OpenGL ABI specification
</a>.
236 If you'd like Mesa to co-exist with another implementation of OpenGL that's
237 already installed, you'll have to choose different directories, like
238 <code>/usr/local/include/GL/
</code> and
<code>/usr/local/lib/
</code>.
242 To install Mesa's headers and libraries, run
<code>make install
</code>
243 You'll be prompted to enter alternative directories for the headers
248 Note: at runtime, you can set the LD_LIBRARY_PATH (on Linux) to switch
249 between the Mesa libs and another vendor libs whenever you want.
250 This is a handy way to compare multiple OpenGL implementations.
256 <H2>2. Windows Compilation and Installation
</H1>
259 Please see the
<a href=
"README.WIN32">README.WIN32
</a> file.
266 <H2>3. VMS Compilation and Installation
</H1>
269 Please see the
<a href=
"README.VMS">README.VMS
</a> file.
276 <H2>4. Other systems
</H1>
279 Documentation for other environments (some may be very out of date):
283 <LI><A HREF=
"README.GGI">README.GGI
</A> - GGI
284 <LI><A HREF=
"README.3DFX">README
.3DFX
</A> -
3Dfx/Glide driver
285 <LI><A HREF=
"README.AMIWIN">README.AMIWIN
</A> - Amiga Amiwin
286 <LI><A HREF=
"README.BEOS">README.BEOS
</A> - BeOS
287 <LI><A HREF=
"README.D3D">README.D3D
</A> - Direct3D driver
288 <LI><A HREF=
"README.DJ">README.DJ
</A> - DJGPP
289 <LI><A HREF=
"README.LYNXOS">README.LYNXOS
</A> - LynxOS
290 <LI><A HREF=
"README.MINGW32">README.MINGW32
</A> - Mingw32
291 <LI><A HREF=
"README.NeXT">README.NeXT
</A> - NeXT
292 <LI><A HREF=
"README.OpenStep">README.OpenStep
</A> - OpenStep
293 <LI><A HREF=
"README.OS2">README.OS2
</A> - OS/
2
294 <LI><A HREF=
"README.WINDML">README.WINDML
</A> - WindML