install.html revision c548192cafdf7dfab4cf7e0a0734417ee16f1c94
1<HTML> 2 3<TITLE>Compiling and Installing</TITLE> 4 5<link rel="stylesheet" type="text/css" href="mesa.css"></head> 6 7<BODY> 8 9 10<H1>Compiling and Installing</H1> 11 12<ol> 13<li><a href="#unix-x11">Unix / X11</a> 14 <ul> 15 <li><a href="#prereq-general">General prerequisites for building</a> 16 <li><a href="#prereq-dri">Prerequisites for DRI and hardware acceleration</a> 17 <li><a href="#autoconf">Building with autoconf</a> 18 <li><a href="#traditional">Building with traditional Makefiles</a> 19 <li><a href="#libs">The Libraries</a> 20 <li><a href="#install">Installing the header and library files 21 <li><a href="#pkg-config">Building OpenGL programs with pkg-config 22 </ul> 23<li><a href="#windows">Windows</a> 24<li><a href="#scons">Building with SCons</a> 25<li><a href="#other">Other</a> 26</ol> 27<br> 28 29 30<a name="unix-x11"> 31<H2>1. Unix/X11 Compilation and Installation</H1> 32 33 34<a name="prereq-general"> 35<h3>1.1 General prerequisites for building</h3> 36 37<ul> 38<li>lex / yacc - for building the GLSL compiler. 39On Linux systems, flex and bison are used. 40Versions 2.5.35 and 2.4.1, respectively, (or later) should work. 41</li> 42<li>python - Python is needed for building the Gallium components. 43Version 2.6.4 or later should work. 44</li> 45</ul> 46 47 48<a name="prereq-dri"> 49<h3>1.2 Prerequisites for DRI and hardware acceleration</h3> 50 51<p> 52The following are required for DRI-based hardware acceleration with Mesa: 53</p> 54 55<ul> 56<li><a href="http://xorg.freedesktop.org/releases/individual/proto/">dri2proto</a> version 1.99.3 or later 57<li>Linux 2.6.28 58<li><a href="http://dri.freedesktop.org/libdrm/" target="_parent">libDRM</a> 59version 2.4.15 or later 60<li>Xorg server version 1.5 or later 61</ul> 62</p> 63 64 65<a name="autoconf"> 66<h3>1.3 Building with Autoconf</h3> 67 68<p> 69Mesa may be <a href="autoconf.html">built using autoconf</a>. 70This should work well on most GNU-based systems. 71If that fails the traditional Mesa build system is available. 72 73 74 75<a name="traditional"> 76<h3>1.4 Building with traditional Makefiles</h3> 77 78<p> 79The traditional Mesa build system is based on a collection of pre-defined 80system configurations. 81</p> 82<p> 83To see the list of configurations, just type <code>make</code>. 84Then choose a configuration from the list and type <code>make</code> 85<em>configname</em>. 86</p> 87 88<p> 89Mesa may be built in several different ways using the predefined configurations: 90</p> 91<ul> 92<li><b><em>Stand-alone/Xlib mode</em></b> - Mesa will be compiled as 93a software renderer using Xlib to do all rendering. 94The libGL.so library will be a self-contained rendering library that will 95allow you to run OpenGL/GLX applications on any X server (regardless of 96whether it supports the GLX X server extension). 97You will <em>not</em> be able to use hardware 3D acceleration. 98<p> 99To compile stand-alone Mesa type <code>make</code> in the top-level directory. 100You'll see a list of supported system configurations. 101Choose one from the list (such as linux-x86), and type: 102</p> 103<pre> 104 make linux-x86 105</pre> 106<p>This will produce libGL.so and several other libraries</p> 107</li> 108 109<li><b><em>DRI/accelerated</em></b> - The DRI hardware drivers for 110accelerated OpenGL rendering (for ATI, Intel, Matrox, etc) will be built. 111The libGL.so library will support the GLX extension and will load/use 112the DRI hardware drivers. 113 114 115<p> 116Build Mesa and the DRI hardware drivers by running 117</p> 118<pre> 119 make linux-dri 120</pre> 121<p> 122There are also <code>linux-dri-x86</code>, <code>linux-dri-x86-64</code>, 123and <code>linux-ppc</code> configurations which are optimized for those 124architectures. 125</p> 126<p> 127Make sure you have the prerequisite versions of DRM and Xserver mentioned 128above. 129</p> 130 131</li> 132 133</ul> 134 135 136<p> 137Later, if you want to rebuild for a different configuration run 138<code>make realclean</code> before rebuilding. 139</p> 140 141 142<a name="libs"> 143<h3>1.5 The libraries</h3> 144 145<p> 146When compilation has finished, look in the top-level <code>lib/</code> 147(or <code>lib64/</code>) directory. 148You'll see a set of library files similar to this: 149</p> 150<pre> 151lrwxrwxrwx 1 brian users 10 Mar 26 07:53 libGL.so -> libGL.so.1* 152lrwxrwxrwx 1 brian users 19 Mar 26 07:53 libGL.so.1 -> libGL.so.1.5.060100* 153-rwxr-xr-x 1 brian users 3375861 Mar 26 07:53 libGL.so.1.5.060100* 154lrwxrwxrwx 1 brian users 11 Mar 26 07:53 libGLU.so -> libGLU.so.1* 155lrwxrwxrwx 1 brian users 20 Mar 26 07:53 libGLU.so.1 -> libGLU.so.1.3.060100* 156-rwxr-xr-x 1 brian users 549269 Mar 26 07:53 libGLU.so.1.3.060100* 157lrwxrwxrwx 1 brian users 12 Mar 26 07:53 libglut.so -> libglut.so.3* 158lrwxrwxrwx 1 brian users 16 Mar 26 07:53 libglut.so.3 -> libglut.so.3.7.1* 159-rwxr-xr-x 1 brian users 597754 Mar 26 07:53 libglut.so.3.7.1* 160lrwxrwxrwx 1 brian users 14 Mar 26 07:53 libOSMesa.so -> libOSMesa.so.6* 161lrwxrwxrwx 1 brian users 23 Mar 26 07:53 libOSMesa.so.6 -> libOSMesa.so.6.1.060100* 162-rwxr-xr-x 1 brian users 23871 Mar 26 07:53 libOSMesa.so.6.1.060100* 163</pre> 164 165<p> 166<b>libGL</b> is the main OpenGL library (i.e. Mesa). 167<br> 168<b>libGLU</b> is the OpenGL Utility library. 169<br> 170<b>libglut</b> is the GLUT library. 171<br> 172<b>libOSMesa</b> is the OSMesa (Off-Screen) interface library. 173</p> 174 175<p> 176If you built the DRI hardware drivers, you'll also see the DRI drivers: 177</p> 178<pre> 179-rwxr-xr-x 1 brian users 15607851 Jul 21 12:11 ffb_dri.so 180-rwxr-xr-x 1 brian users 15148747 Jul 21 12:11 i810_dri.so 181-rwxr-xr-x 1 brian users 14497814 Jul 21 12:11 i830_dri.so 182-rwxr-xr-x 1 brian users 16895413 Jul 21 12:11 i915_dri.so 183-rwxr-xr-x 1 brian users 11320803 Jul 21 12:11 mach64_dri.so 184-rwxr-xr-x 1 brian users 11418014 Jul 21 12:12 mga_dri.so 185-rwxr-xr-x 1 brian users 11064426 Jul 21 12:12 r128_dri.so 186-rwxr-xr-x 1 brian users 11849858 Jul 21 12:12 r200_dri.so 187-rwxr-xr-x 1 brian users 16050488 Jul 21 12:11 r300_dri.so 188-rwxr-xr-x 1 brian users 11757388 Jul 21 12:12 radeon_dri.so 189-rwxr-xr-x 1 brian users 11232304 Jul 21 12:13 s3v_dri.so 190-rwxr-xr-x 1 brian users 11062970 Jul 21 12:13 savage_dri.so 191-rwxr-xr-x 1 brian users 11214212 Jul 21 12:13 sis_dri.so 192-rwxr-xr-x 1 brian users 11368736 Jul 21 12:13 tdfx_dri.so 193-rwxr-xr-x 1 brian users 10598868 Jul 21 12:13 trident_dri.so 194-rwxr-xr-x 1 brian users 10997120 Jul 21 12:13 unichrome_dri.so 195</pre> 196 197<p> 198If you built with Gallium support, look in lib/gallium/ for Gallium-based 199versions of libGL and device drivers. 200</p> 201 202 203 204<a name="install"> 205<H3>1.6 Installing the header and library files</H3> 206 207<p> 208The standard location for the OpenGL header files on Unix-type systems is 209in <code>/usr/include/GL/</code>. 210The standard location for the libraries is <code>/usr/lib/</code>. 211For more information see, the 212<a href="http://oss.sgi.com/projects/ogl-sample/ABI/" target="_parent"> 213Linux/OpenGL ABI specification</a>. 214</p> 215 216<p> 217If you'd like Mesa to co-exist with another implementation of OpenGL that's 218already installed, you'll have to choose different directories, like 219<code>/usr/local/include/GL/</code> and <code>/usr/local/lib/</code>. 220</p> 221 222<p> 223To install Mesa's headers and libraries, run <code>make install</code>. 224But first, check the Mesa/configs/default file and examine the values 225of the <b>INSTALL_DIR</b> and <b>DRI_DRIVER_INSTALL_DIR</b> variables. 226Change them if needed, then run <code>make install</code>. 227</p> 228 229<p> 230The variable 231<b>DESTDIR</b> may also be used to install the contents to a temporary 232staging directory. 233This can be useful for package management. 234For example: <code>make install DESTDIR=/somepath/</code> 235</p> 236 237<p> 238Note: at runtime you can use the LD_LIBRARY_PATH environment variable 239(on Linux at least) to switch 240between the Mesa libraries and other vendor's libraries whenever you want. 241This is a handy way to compare multiple OpenGL implementations. 242</p> 243 244 245<a name="pkg-config"> 246<H3>1.7 Building OpenGL programs with pkg-config</H3> 247 248<p> 249Running <code>make install</code> will install package configuration files 250for the pkg-config utility. 251</p> 252 253<p> 254When compiling your OpenGL application you can use pkg-config to determine 255the proper compiler and linker flags. 256</p> 257 258<p> 259For example, compiling and linking a GLUT application can be done with: 260</p> 261<pre> 262 gcc `pkg-config --cflags --libs glut` mydemo.c -o mydemo 263</pre> 264 265<br> 266 267<a name="windows"> 268<H2>2. Windows Compilation and Installation</H1> 269 270<p> 271Please see the <a href="#scons">instructions on building with SCons</a>. 272</p> 273 274 275 276<a name="scons"> 277<H2>3. Building with SCons</H1> 278 279<p> 280To build Mesa with SCons on Linux or Windows do 281</p> 282<pre> 283 scons 284</pre> 285<p> 286The build output will be placed in 287build/<i>platform</i>-<i>machine</i>-<i>debug</i>/..., where <i>platform</i> is for 288example linux or windows, <i>machine</i> is x86 or x86_64, optionally followed 289by -debug for debug builds. 290</p> 291 292<p> 293To build Mesa with SCons for Windows on Linux using the MinGW crosscompiler toolchain do 294</p> 295<pre> 296 scons platform=windows toolchain=crossmingw machine=x86 statetrackers=mesa drivers=softpipe,trace winsys=gdi 297</pre> 298<p> 299This will create: 300</p> 301<ul> 302<li>build/windows-x86-debug/gallium/targets/libgl-gdi/opengl32.dll — Mesa + Gallium + softpipe, binary compatible with Windows's opengl32.dll 303<li>build/windows-x86-debug/glut/glx/glut32.dll 304<li>progs/build/windows-x86-debug/wgl/wglinfo.exe 305<li>progs/build/windows-x86-debug/trivial/tri.exe 306<li>and many other samples in progs/build/windows-x86-debug/... 307</ul> 308<p> 309Put them all in the same directory to test them. 310</p> 311 312 313<a name="other"> 314<H2>4. Other systems</H1> 315 316<p> 317Documentation for other environments (some may be very out of date): 318</p> 319 320<UL> 321<li><A HREF="README.VMS">README.VMS</A> - VMS 322<LI><A HREF="README.GGI">README.GGI</A> - GGI 323<LI><A HREF="README.3DFX">README.3DFX</A> - 3Dfx/Glide driver 324<LI><A HREF="README.AMIWIN">README.AMIWIN</A> - Amiga Amiwin 325<LI><A HREF="README.BEOS">README.BEOS</A> - BeOS 326<LI><A HREF="README.D3D">README.D3D</A> - Direct3D driver 327<LI><A HREF="README.DJ">README.DJ</A> - DJGPP 328<LI><A HREF="README.LYNXOS">README.LYNXOS</A> - LynxOS 329<LI><A HREF="README.MINGW32">README.MINGW32</A> - Mingw32 330<LI><A HREF="README.NeXT">README.NeXT</A> - NeXT 331<LI><A HREF="README.OpenStep">README.OpenStep</A> - OpenStep 332<LI><A HREF="README.OS2">README.OS2</A> - OS/2 333<LI><A HREF="README.WINDML">README.WINDML</A> - WindML 334</UL> 335 336 337 338 339</body> 340</html> 341