summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorBrian Paul <brian.paul@tungstengraphics.com>2003-09-05 14:47:07 +0000
committerBrian Paul <brian.paul@tungstengraphics.com>2003-09-05 14:47:07 +0000
commit5f37abfc436f6ee6aaf2a34d8798faea799c70c4 (patch)
tree7281856ec1ac1b8ce43e3628c15a2a79af9f2188 /docs
parentade4de9b5d338c7c8a031b7b713cf6dc700dfa94 (diff)
updated info for Mesa 5.1
Diffstat (limited to 'docs')
-rw-r--r--docs/install.html428
1 files changed, 165 insertions, 263 deletions
diff --git a/docs/install.html b/docs/install.html
index 3570eaf735..5e8b047f31 100644
--- a/docs/install.html
+++ b/docs/install.html
@@ -4,309 +4,168 @@
<BODY text="#000000" bgcolor="#55bbff" link="#111188">
-<H1>Compilation and Installation for Unix/X11</H1>
-<p>
-If you're not using a variant of Unix with X11, see the
-<a href="systems.html">Supported Systems and Drivers</a> section
-for instructions.
-</p>
+<H1>Compilation and Installation</H1>
-<p>
-There are two methods for building Mesa on Unix/X11 systems:
-</p>
+<ol>
+<li><a href="#unix-x11">Unix / X11</a>
+<li><a href="#windows">Windows</a>
+<li><a href="#vms">VMS</a>
+<li><a href="#other">Other</a>
+</ol>
-<dl>
-<dt><a href="#new">NEW-STYLE</a><dt>
-<dd>
-Basically, type "./configure" followed by "make"
-This <em>should</em> work on most Unix-like operating systems.
-Unfortunately, autoconf/automake seems to seldom work reliably on non-Linux
-systems. For that reason, the old-style make system is still supported
-(and is the preferred method of the Mesa developers).
-</dd>
-<br>
-<dt><a href="#old">OLD-STYLE</a><dt>
-<dd>
-Simply type <code>make</code> and you'll see a list of supported
-system configurations. Pick one and type <code>make</code> <em>config</em>.
-More details below.
-<br>
-</dd>
-</dl>
-<p>
-<B>NOTE</b>: The GLUT library and demonstrations programs are in the
-MesaDemos-x.y.z.tar.gz file. If you don't have GLUT or you want to
-run some demos, download the MesaDemos package too.
-</p>
+
+<a name="unix-x11">
+<H2>1. Unix/X11 Compilation and Installation</H1>
<p>
-In either case, building Mesa entails the following:
-<p>
+Mesa uses a rather conventional Makefile system.
+A GNU autoconf/automake system used to be included, but was discarded
+in Mesa 5.1 because:
+</p>
<ul>
-<li>Compiling libGL, the OpenGL-replacement library.
-<li>Compiling libGLU, the OpenGL Utility library.
-<li>Compiling libglut, the GLUT library (if you downloaded the Mesa demos
-package)
-<li>Compiling the demonstration programs in the directories:
-<code>demos, xdemos, samples</code> and <code>book</code>
-(if you downloaded the Mesa demos package.)
+<li>It seldom worked on IRIX, Solaris, AIX, etc.
+<li>It was very compilicated
+<li>Nobody maintained it
+<li>libtool was just too weird
</ul>
-
-
-<a name="new">
-<H2>NEW-STYLE compilation and installation</H2>
-
<p>
-<b> 0.</b> If you've downloaded Mesa via CVS there will not be a "configure"
- script. You'll have to run the "bootstrap" script first. This script
- may not work on any OS other than Linux. You'll need these programs
- to run the bootstrap script:
+If someone strongly feels that Mesa should have a autoconf/automake
+system and wants to contribute one and maintain it, we'll consider
+adding it again.
</p>
-<pre>
- autoconf 2.50
- automake 1.4-p2
- libtool 1.4
-</pre>
-<p>
-<b>1.</b> Run the configure script
-</p>
-
-<pre>
- ./configure [options]
-</pre>
+<h3>1.1 Compilation</h3>
<p>
-For Linux, it is recommended that you use:
+If you've obtained Mesa through CVS, do this to first:
</p>
<pre>
- ./configure --prefix=/usr
+ cd Mesa-newtree
+ cp Makefile.X11 Makefile
</pre>
-So that the headers and libs are located according to the Linux/OpenGL
-standard spec at http://oss.sgi.com/projects/ogl-sample/ABI/
-</p>
<p>
-For Red Hat 8.0, Mandrake 9.1 and other Linux distros, you may have to use
-the following:
+Now, just type <b>make</b>.
+You'll see a list of supported system configurations.
+Choose one from the list (such as linux-x86), and type:
</p>
<pre>
- export LDFLAGS="-lstdc++" ; ./configure --prefix=/usr
- or
- setenv LDFLAGS -lstdc++ ; ./configure --prefix=/usr
+ make linux-x86
</pre>
<p>
-This works around a problem when building the GLU library. It needs to
-be linked with the C++ runtime library, but libtool (for some reason)
-doesn't do this.
+That's it.
</p>
-<pre>
-Possible options are:
-
---prefix=DIR
- The toplevel directory of the hierachy in which Mesa
- will be installed (DIR/include,DIR/lib etc.).
- The default is "/usr/local".
-
---sysconfdir=DIR
- The directory where Mesa configuration files
- will be stored. The default is "$prefix/etc".
- You may want to overwrite the default with --sysconfdir=/etc.
-
---enable-static
- Enable building of static libraries.
- Static libraries are NOT built by default.
-
---disable-shared
- Disable building of shared libraries.
- Shared libraries are built by default.
-
---with-pic
---without-pic
- In normal operation, libtool will build shared libraries from
- PIC objects and static archives from non-PIC objects, except where one
- or the other is not provided by the target host. By specifying
- --with-pic you are asking libtool to build static archives from
- PIC objects, and similarly by specifying --without-pic you are asking
- libtool to build shared libraries from non-PIC objects.
- libtool will only honour this flag where it will produce a
- working library, otherwise it reverts to the default.
-
---enable-debug
- Enable debugging messages (disabled by default).
-
---enable-profile
- Enable profiling (disabled by default).
-
---disable-optimize
- Disable extra optimizations (enabled by default,
- i.e., optimize for maximum performance).
-
---enable-warn
- Enable extended compiler warnings (disabled by default).
-
---enable-x86[=ARG]
---disable-x86
- Enable/disable x86 assembler support to speed up Mesa
- (autodetected by default). You may set `on' or `off'.
-
---enable-3dnow[=ARG]
---disable-3dnow
- Enable/disable 3Dnow support to speed up Mesa
- (autodetected by default). You may set `on' or `off'.
-
---enable-mmx[=ARG]
---disable-mmx
- Enable/disable MMX support to speed up Mesa
- (autodetected by default). You may set `on' or `off'.
-
---enable-sse[=ARG]
---disable-sse
- Enable/disable SSE support to speed up Mesa
- (autodetected by default). You may set `on' or `off'.
- If you have a PentiumIII and want to use SSE make sure you have the
- PIII Linux kernel-patch installed or things will fail!
- You can get the patch from http://www.redhat.com/~dledford/linux_kernel.html
-
---with-glide[=DIR]
---without-glide
- Enable/disable support for Glide (disabled by default).
- DIR is the installation directory of Glide.
- If Glide cannot be found, the driver won't be built.
-
---with-glut[=DIR]
---without-glut
- Don't/use already-installed GLUT (autodetected by default).
- DIR is the installation directory of Glut.
- If GLUT cannot be found, the version shipped with Mesa will be built.
-
---with-ggi[=DIR]
---without-ggi
- Enable/disable support for GGI (autodetected by default).
- DIR is the installation directory of GGI.
- If GGI cannot be found, the driver won't be built.
-
---disable-ggi-fbdev
- Don't build the GGI fbdev target (autodetected by default).
-
---disable-ggi-genkgi
- Don't build the GGI generic KGI driver (autodetected by default).
-
---disable-ggi-savage4
- Don't build the GGI Savage4 KGI driver (autodetected by default).
-
---disable-osmesa
- Disable OSmesa (offscreen rendering) support (enabled by default).
-
---with-svga[=DIR]
---without-svga
- Enable/disable support for SVGALib (autodetected by default).
- DIR is the installation directory of SVGALib.
- If SVGALib cannot be found, the driver won't be built.
-
---x-includes=DIR
- Search for the X include files in DIR.
-
---x-libraries=DIR
- Search for the X library files in DIR.
-</pre>
-<p>
-User specific compiler options can be set using the shell variable
-CFLAGS. For instance,
-</p>
-<pre>
- CFLAGS="-g -O2" ./configure
-</pre>
-<p>
-(on some systems: env CFLAGS="-g -O2" ./configure)
-sets the compiler flags to "-g -O2".
-</p>
-<p>
-For more options run "./configure --help" and read INSTALL.GNU.
-</p>
+<h3>1.2 The libraries</h3>
<p>
-<b>2.</b> To build the Mesa libraries run:
+When compilation has finished, look in the top-level <b>lib/</b> directory.
+You'll see a set of library files similar to this:
</p>
<pre>
- make
+lrwxrwxrwx 1 brian users 10 Sep 4 17:55 libGL.so -> libGL.so.1*
+lrwxrwxrwx 1 brian users 19 Sep 4 17:55 libGL.so.1 -> libGL.so.1.4.050100*
+-rwxr-xr-x 1 brian users 13940317 Sep 4 17:55 libGL.so.1.4.050100*
+lrwxrwxrwx 1 brian users 11 Sep 4 17:54 libGLU.so -> libGLU.so.1*
+lrwxrwxrwx 1 brian users 20 Sep 4 17:54 libGLU.so.1 -> libGLU.so.1.3.050100*
+-rwxr-xr-x 1 brian users 324746 Sep 3 13:54 libGLU.so.1.1*
+-rwxr-xr-x 1 brian users 2830539 Sep 4 17:54 libGLU.so.1.3.050100*
+lrwxrwxrwx 1 brian users 12 Sep 4 17:53 libglut.so -> libglut.so.3*
+lrwxrwxrwx 1 brian users 16 Sep 4 17:53 libglut.so.3 -> libglut.so.3.7.1*
+-rwxr-xr-x 1 brian users 2426683 Sep 4 17:53 libglut.so.3.7.1*
</pre>
-<p>(on some systems you may need to run <code>gmake</code> or
-<code>gnumake</code> instead)
-</p>
+
<p>
-When finished, libGL.so will be in src/.libs/ and libGLU.so will be in
-si-glu/.libs/, etc.
+<b>libGL</b> is the main OpenGL library (i.e. Mesa).
+<br>
+<b>libGLU</b> is the OpenGL Utility library.
+<br>
+<b>libglut</b> is the GLUT library.
</p>
+
+
+<h3>1.3 Running the demos</h3>
+
<p>
-Optionally, you can strip the libraries using
+If you downloaded/unpacked the MesaDemos-x.y.z.tar.gz archive or
+obtained Mesa from CVS, the <b>progs/</b> directory will contain a
+bunch of demonstration programs.
</p>
-<pre>
- make strip
-</pre>
+
<p>
-Now make sure that you have the permissions to install Mesa in the
-specified directories, for example, by becoming super user ("su")
-Then run:
-</p>
-<pre>
- make install
-</pre>
+Before running a demo, you may have to set an environment variable
+(such as <b>LD_LIBRARY_PATH</b> on Linux) to indicate where the
+libraries are located. For example:
<p>
-Mesa is now installed.
-Please don't move the installed files but rerun all installation
-steps if you want to use other directories.
-</p>
+<blockquote>
+<b>cd</b> into the Mesa <b>lib/</b> directory.
+<br>
+<b>setenv LD_LIBRARY_PATH ${cwd}</b> (if using csh or tcsh shell)
+<br>
+or,
+<br>
+<b>export LD_LIBRARY_PATH=${PWD}</b> (if using bash or sh shell)
+</blockquote>
<p>
-<b>3.</b>To test whether Mesa works properly you might want to run the
-Mesa demos:
-</p>
-<pre>
- make check
-</pre>
-<p>
-Builds all demos.
+Next, change to the Mesa/demos/ directory:
</p>
-<pre>
- make exec
-</pre>
+<blockquote>
+<b>cd ../progs/demos</b>
+</blockquote>
+
<p>
-Builds and executes all demos.
+Run a demo such as gears:
</p>
-
-
-<a name="old">
-<H2>OLD-STYLE compilation and installation</H2>
+<blockquote>
+<b>./gears</b>
+</blockquote>
<p>
-This procedure usually works when <code>./configure ; make</code> fails.
+If this doesn't work, try the <b>Mesa/progs/xdemos/glxinfo</b> program
+and see that it prints the expected Mesa version number.
</p>
<p>
-<b>Note</b>: If you tried <code>./configure ; make</code> but it failed,
-first copy the top-level <code>Makefile.X11</code> file over
-<code>Makefile</code>.
+If you're using Linux or a similar OS, verify that the demo program is
+being linked with the proper library files:
</p>
+<blockquote>
+<b>ldd gears</b>
+</blockquote>
<p>
-<B>Also Note</B>: if you've obtained Mesa directly from CVS you'll have
-to copy the top-level Makefile.X11 to Makefile.
+You should see something like this:
</p>
+<pre>
+ libglut.so.3 => /home/brian/Mesa/lib/libglut.so.3 (0x40013000)
+ libGLU.so.1 => /home/brian/Mesa/lib/libGLU.so.1 (0x40051000)
+ libGL.so.1 => /home/brian/Mesa/lib/libGL.so.1 (0x400e0000)
+ libc.so.6 => /lib/i686/libc.so.6 (0x42000000)
+ libm.so.6 => /lib/i686/libm.so.6 (0x403da000)
+ libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x403fc000)
+ libXmu.so.6 => /usr/X11R6/lib/libXmu.so.6 (0x404da000)
+ libXt.so.6 => /usr/X11R6/lib/libXt.so.6 (0x404f1000)
+ libXi.so.6 => /usr/X11R6/lib/libXi.so.6 (0x40543000)
+ libstdc++.so.5 => /usr/lib/libstdc++.so.5 (0x4054b000)
+ libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x405fd000)
+ libXext.so.6 => /usr/X11R6/lib/libXext.so.6 (0x40605000)
+ libpthread.so.0 => /lib/i686/libpthread.so.0 (0x40613000)
+ /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
+ libdl.so.2 => /lib/libdl.so.2 (0x40644000)
+ libSM.so.6 => /usr/X11R6/lib/libSM.so.6 (0x40647000)
+ libICE.so.6 => /usr/X11R6/lib/libICE.so.6 (0x40650000)
+</pre>
<p>
-Just type <code>make</code> alone.
-You'll see a list of supported system configurations.
-Choose one and type <code>make</code> <em>config</em>
-(for example <code>make linux-x86</code>).
-The Mesa libraries and demo programs will be compiled.
+Retrace your steps if this doesn't look right.
</p>
-<H3>Header and library files</H3>
+
+<H3>1.4 Installing the header and library files</H3>
<p>
The standard location for the OpenGL header files on Unix-type systems is
@@ -325,29 +184,72 @@ already installed, you'll have to choose different directories, like
<p>
To install the Mesa headers, do this:
-<pre>
- cp -r include/GL /usr/include
-</pre>
+<blockquote>
+<b>cp -r include/GL /usr/include</b>
+</blockquote>
<p>
To install the Mesa libraries, do this:
</p>
-<pre>
- cp -pd lib/* /usr/lib
+<blockquote>
+<b>cp -pd lib/* /usr/lib</b>
+<br>
+(The -pd options preserve symbolic links)
+</blockquote>
+
+<p>
+If you install the libraries in a non-standard location you can use
+LD_LIBRARY_PATH (on Linux) to switch between the Mesa libs and another
+vendor libs whenever you want.
+This is a handy way to compare multiple OpenGL implementations.
+</p>
+
+
+
+<a name="windows">
+<H2>2. Windows Compilation and Installation</H1>
+
+<p>
+Please see the <a href="README.WIN32">README.WIN32</a> file.
+</p>
+
+
- (The -pd options preserve symbolic links)
-</pre>
-<H3>LD_LIBRARY_PATH</H3>
+<a name="vms">
+<H2>3. VMS Compilation and Installation</H1>
<p>
-On Linux and similar operating systems the <code>LD_LIBRARY_PATH</code>
-environment variable can be used to indicate a list of directories to
-search for shared libraries.
-If you don't install Mesa in <code>/usr/lib/</code> you may have to
-set the <code>LD_LIBRARY_PATH</code> variable in order to use the Mesa
-libraries.
+Please see the <a href="README.VMS">README.VMS</a> file.
</p>
+
+
+
+<a name="other">
+<H2>4. Other systems</H1>
+
+<p>
+Documentation for other environments (some may be very out of date):
+</p>
+
+<UL>
+<LI><A HREF="README.GGI">README.GGI</A> - GGI
+<LI><A HREF="README.3DFX">README.3DFX</A> - 3Dfx/Glide driver
+<LI><A HREF="README.AMIWIN">README.AMIWIN</A> - Amiga Amiwin
+<LI><A HREF="README.BEOS">README.BEOS</A> - BeOS
+<LI><A HREF="README.D3D">README.D3D</A> - Direct3D driver
+<LI><A HREF="README.DJ">README.DJ</A> - DJGPP
+<LI><A HREF="README.LYNXOS">README.LYNXOS</A> - LynxOS
+<LI><A HREF="README.MINGW32">README.MINGW32</A> - Mingw32
+<LI><A HREF="README.NeXT">README.NeXT</A> - NeXT
+<LI><A HREF="README.OpenStep">README.OpenStep</A> - OpenStep
+<LI><A HREF="README.OS2">README.OS2</A> - OS/2
+<LI><A HREF="README.WINDML">README.WINDML</A> - WindML
+</UL>
+
+
+
+
</body>
</html>