Introduction to MesaLib

Mesa is an OpenGL compatible 3-D graphics library.

Package Information

  • Download (HTTP):

  • Download (FTP):

  • Download MD5 sum: 61beda590bfc5b4a12e979d5f2d70d7a

  • Download size (including recommended download): 3.3 MB

  • Estimated disk space required (including recommended download): 157 MB

  • Estimated build time (including recommended download): 1.7 SBU

MesaLib Dependencies


Xorg Libraries, Xorg Utilities, and libdrm-2.0.1



This package should only be built if you are installing Xorg-7.1. If you have installed or will be installing Xorg-6.9.0 or XFree86, it is provided by those packages and should not be installed here. Ensure that you have the XORG_CONFIG and XORG_PREFIX variables set as described in the Xorg-7.1 page.

Recommended Download

Optional Download

User Notes:

Installation of MesaLib

Extract all three tarballs from the same top-level directory as they all will extract to the Mesa-6.5 directory.

Fix an error with output redirection if /bin/sh is not the Bash shell on your system:

sed -i 's%>& /dev/null%>/dev/null%' src/mesa/drivers/dri/Makefile.template

Install MesaLib by running the following commands:

find . -type f -exec sed -i "s@/usr/X11R6@$XORG_PREFIX@g" {} \; &&
sed -i 's@lib/modules@lib/X11/modules@' \
    src/glx/x11/dri_glx.c \
    src/mesa/drivers/dri/Makefile.template &&
make OPT_FLAGS="-O2 -fno-strict-aliasing" linux-dri-x86

If you downloaded and extracted the Demos package, build the programs with the following commands:

sed -i 's@-l$(GLUT_LIB)@@g' configs/default &&
make -C progs/xdemos PROGS='glxinfo glxgears'

This package does not come with a test suite.

Now, as the root user:

bin/installmesa $XORG_PREFIX &&
install -v -m755 -d $XORG_PREFIX/lib/X11/modules/dri &&
install -v -m755 lib/*dri* $XORG_PREFIX/lib/X11/modules/dri

If you built the demo programs, install them using the following command as the root user:

install -v -m755 progs/xdemos/glx{info,gears} $XORG_PREFIX/bin

Finally, if installing to any prefix other than /usr, you should create symlinks to the GL headers in /usr/include. Execute the following command as the root user:

ln -s -v $XORG_PREFIX/include/GL /usr/include


Do not remove the Mesa source tree yet, it will be required to build the Xorg-Server-1.1.1.

Command Explanations

find ... sed -i "s@/usr/X11R6@$XORG_PREFIX@" ...: This command corrects several hard coded references to the X11R6 default installation path.

sed -i 's@lib/modules@lib/X11/modules@' ...: This command corrects a hard coded reference to the module directory.

make OPT_FLAGS=... linux-dri-x86: A bug where OpenGL applications are shifted to the left by 50% can be worked around by adding -fno-strict-aliasing to the compiler flags. Also, the linux-dri-x86 target is specified to use a few other helpful flags in addition to the defaults. See the other targets in the configs directory if your architecture is not x86.

sed -i 's@-l$(GLUT_LIB)@@g' configs/default: Disables linking against the GLUT libraries for the demo programs, omit this command if you downloaded and extracted the GLUT tarball.

make ... PROGS='glxinfo glxgears': Only builds the glxinfo and glxgears programs.

bin/installmesa: Mesa uses a custom installation script as opposed to the normal install make target.

install -v -m755 lib/*dri* $XORG_PREFIX/lib/X11/modules/dri: installs the DRI modules.


Installed Programs (optional): glxgears and glxinfo
Installed Libraries: libGL.{so,a}, libGLU.{so,a}, libGLw.{so,a}, * and optionally, libglut.{so,a}
Installed Directory: $XORG_PREFIX/lib/modules/dri

Short Descriptions


is a GL demo useful for troubleshooting graphics problems.


is a diagnostic program that displays information about the graphics hardware and installed GL libraries.

Last updated on 2007-02-14 02:34:49 -0600