X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Finstall.html;h=08081944cfcc0fc10762f9b1429396fab3170abd;hb=11e92889aa0476ea39c5f0c46864d0960dc7354b;hp=2ba7cb8677b34058c44c19923d80bb560c9267fd;hpb=7103a18c1242af7d3ec36a947841fa52e7f86bed;p=mesa.git diff --git a/docs/install.html b/docs/install.html index 2ba7cb8677b..08081944cfc 100644 --- a/docs/install.html +++ b/docs/install.html @@ -1,13 +1,20 @@ - + + + + + Compiling and Installing + + + -Compiling and Installing +
+

The Mesa 3D Graphics Library

+
- + +
- - - -

Compiling and Installing

+

Compiling and Installing

  1. Prerequisites for building @@ -16,66 +23,96 @@
  2. For DRI and hardware acceleration
  3. Building with autoconf (Linux/Unix/X11) -
  4. Building with SCons (Windows) -
  5. Building with legacy Makefiles (deprecated) -
  6. Building for other systems +
  7. Building with SCons (Windows/Linux) +
  8. Building with AOSP (Android)
  9. Library Information -
  10. Building OpenGL programs with pkg-config +
  11. Building OpenGL programs with pkg-config
- -

1. Prerequisites for building

+

1. Prerequisites for building

1.1 General

+ +

+Build system. +

+ - -

1.2 For DRI and hardware acceleration

+

+The following compilers are known to work, if you know of others or you're +willing to maintain support for other compiler get in touch. +

+ + +

-The following are required for DRI-based hardware acceleration with Mesa: +Third party/extra tools. +
+Note: These should not be required, when building from a release tarball. If +you think you've spotted a bug let developers know by filing a +bug report.

+ +

Note: Some versions can be buggy (eg. flex 2.6.2) so do try others if things fail.

+ + +

1.2 Requirements

+ +

+The requirements depends on the features selected at configure stage. +Check/install the respective -devel package as prompted by the configure error +message.

+

-If you're using a fedora distro the following command should install all -the needed dependencies: +Here are some common ways to retrieve most/all of the dependencies based on +the packaging tool used by your distro. +

+ 
-  sudo yum install flex bison imake libtool xorg-x11-proto-devel libdrm-devel \
-  gcc-c++ xorg-x11-server-devel libXi-devel libXmu-devel libXdamage-devel git \
-  expat-devel llvm-devel
+  zypper source-install --build-deps-only Mesa # openSUSE/SLED/SLES
+  yum-builddep mesa # yum Fedora, OpenSuse(?)
+  dnf builddep mesa # dnf Fedora
+  apt-get build-dep mesa # Debian and derivatives
+  ... # others
- - -

2. Building with autoconf (Linux/Unix/X11)

+

2. Building with autoconf (Linux/Unix/X11)

The primary method to build Mesa on Unix systems is with autoconf. @@ -83,19 +120,20 @@ The primary method to build Mesa on Unix systems is with autoconf.

The general approach is the standard: +

   ./configure
   make
   sudo make install
+

But please read the detailed autoconf instructions for more details.

- -

3. Building with SCons (Windows)

+

3. Building with SCons (Windows/Linux)

To build Mesa with SCons on Linux or Windows do @@ -114,148 +152,43 @@ by -debug for debug builds. To build Mesa with SCons for Windows on Linux using the MinGW crosscompiler toolchain do 

-    scons platform=windows toolchain=crossmingw machine=x86 mesagdi libgl-gdi
+    scons platform=windows toolchain=crossmingw machine=x86 libgl-gdi

This will create:

Put them all in the same directory to test them. -

- +Additional information is available in README.WIN32. - -

4. Building with legacy Makefiles (deprecated)

- -

-The legacy Mesa build system is based on a collection of pre-defined -system configurations. -Some of these might work for older systems not supported by autoconf. -

-

-To see the list of configurations, just type make. -Then choose a configuration from the list and type make -configname.

-

-Mesa may be built in several different ways using the predefined configurations: -

- - - -

-Later, if you want to rebuild for a different configuration run -make realclean before rebuilding. -

- - -

Installing the header and library files

+

4. Building with AOSP (Android)

-The standard location for the OpenGL header files on Unix-type systems is -in /usr/include/GL/. -The standard location for the libraries is /usr/lib/. -For more information see, the - -Linux/OpenGL ABI specification. +Currently one can build Mesa for Android as part of the AOSP project, yet +your experience might vary.

-If you'd like Mesa to co-exist with another implementation of OpenGL that's -already installed, you'll have to choose different directories, like -/usr/local/include/GL/ and /usr/local/lib/. +In order to achieve that one should update their local manifest to point to the +upstream repo, set the appropriate BOARD_GPU_DRIVERS and build the +libGLES_mesa library.

-To install Mesa's headers and libraries, run make install. -But first, check the Mesa/configs/default file and examine the values -of the INSTALL_DIR and DRI_DRIVER_INSTALL_DIR variables. -Change them if needed, then run make install. +FINISHME: Improve on the instructions add references to Rob H repos/Jenkins, +Android-x86 and/or other resources.

-

-The variable -DESTDIR may also be used to install the contents to a temporary -staging directory. -This can be useful for package management. -For example: make install DESTDIR=/somepath/ -

- -

-Note: at runtime you can use the LD_LIBRARY_PATH environment variable -(on Linux at least) to switch -between the Mesa libraries and other vendor's libraries whenever you want. -This is a handy way to compare multiple OpenGL implementations. -

- - - - -

5. Building for other systems

- -

-Documentation for other environments (some may be very out of date): -

- - - - - - -

6. Library Information

+

5. Library Information

When compilation has finished, look in the top-level lib/ @@ -266,9 +199,6 @@ You'll see a set of library files similar to this: lrwxrwxrwx 1 brian users 10 Mar 26 07:53 libGL.so -> libGL.so.1* lrwxrwxrwx 1 brian users 19 Mar 26 07:53 libGL.so.1 -> libGL.so.1.5.060100* -rwxr-xr-x 1 brian users 3375861 Mar 26 07:53 libGL.so.1.5.060100* -lrwxrwxrwx 1 brian users 11 Mar 26 07:53 libGLU.so -> libGLU.so.1* -lrwxrwxrwx 1 brian users 20 Mar 26 07:53 libGLU.so.1 -> libGLU.so.1.3.060100* --rwxr-xr-x 1 brian users 549269 Mar 26 07:53 libGLU.so.1.3.060100* lrwxrwxrwx 1 brian users 14 Mar 26 07:53 libOSMesa.so -> libOSMesa.so.6* lrwxrwxrwx 1 brian users 23 Mar 26 07:53 libOSMesa.so.6 -> libOSMesa.so.6.1.060100* -rwxr-xr-x 1 brian users 23871 Mar 26 07:53 libOSMesa.so.6.1.060100* @@ -277,8 +207,6 @@ lrwxrwxrwx 1 brian users 23 Mar 26 07:53 libOSMesa.so.6 -> libOSM

libGL is the main OpenGL library (i.e. Mesa).
-libGLU is the OpenGL Utility library. -
libOSMesa is the OSMesa (Off-Screen) interface library.

@@ -289,7 +217,6 @@ If you built the DRI hardware drivers, you'll also see the DRI drivers: -rwxr-xr-x 1 brian users 16895413 Jul 21 12:11 i915_dri.so -rwxr-xr-x 1 brian users 16895413 Jul 21 12:11 i965_dri.so -rwxr-xr-x 1 brian users 11849858 Jul 21 12:12 r200_dri.so --rwxr-xr-x 1 brian users 16050488 Jul 21 12:11 r300_dri.so -rwxr-xr-x 1 brian users 11757388 Jul 21 12:12 radeon_dri.so @@ -299,8 +226,7 @@ versions of libGL and device drivers.

- -

7. Building OpenGL programs with pkg-config

+

6. Building OpenGL programs with pkg-config

Running make install will install package configuration files @@ -321,6 +247,6 @@ For example, compiling and linking a GLUT application can be done with:
- +