www/ Software/ gallium/ EGLReferenceDrivers/ linuxvmimage

This page is an experimental effort to create a virtual machine image that can be used as a basic reference build and test environment for Gallium3D. The resulting VM image is large, and is not yet hosted anywhere, but the step by step instruction for creating this reference image are hosted here while development of this reference image is taking place.

The motivation for creating a reference VM image is two fold:

  1. Developing graphics drivers in a VM environment is typically much more efficient than doing the same on a physical machine. The debugging tools and abstraction from the hardware makes driver developers much more productive.
  2. The potential for developing a Gallium3D drivers that utilizes the VMware SVGA II virtual GPU interface.

Here are the current set of steps used to build the Reference Gallium3D VM Image:

  1. Download VMplayer 3 (Registration Required)

  2. Install VMPlayer 3

     chmod +x VMware-Player-3.0.0*
 sudo ./VMware-Player-3.0.0*

  3. Get Ubuntu 9.04 Desktop Image from Chrysaor's Ubuntu page via Bittorrent

  4. Unpack Desktop Image

     tar xzvf ubuntu904desktop.tgz

  5. Launch VMPlayer

     vmplayer

  6. Launch Ubuntu Desktop from within VMPlayer

  7. Login to Ubuntu Desktop:

     User login: user
 User password: chrysaor.info

  8. Turn off automatic updates

    1. Launch Update Manager: "System"->"Administration"->"Update Manager"
    2. Access Settings Pane: "Settings..." button in lower left corner
    3. Select Updates Pane: "Updates" tab half way across top
    4. Turnoff updates: deselect all update options
    5. Close up Update Manager: select "Close" twice
  9. Start Terminal: "Applications"->"Accessories"->"Terminal"

  10. Change user password to gallium3d

     passwd
 chrysaor.info
 gallium3d
 gallium3d

  11. Install build tool packages

     sudo apt-get -y install autoconf automake1.9 libtool build-essential

  12. Clarify build dependencies

     sudo apt-get -y build-dep xorg mesa xserver-xorg-video-intel libdrm-dev

  13. Install more tools and libraries

     sudo apt-get -y install git-core libxmu-dev xorg-dev xorg-build-macros flex bison libtiff4-dev libglut-dev sawfish git-core gitk libxmu-dev libxi-dev x11proto-xf86dga-dev scons

  14. Install LLVM

     sudo apt-get -y install llvm-dev

  15. Install Python State Tracker

     sudo apt-get -y install python-dev swig python-imaging python-imaging-tk

  16. Install GTK for rbug-gui

     sudo apt-get -y install libgtk2.0-dev libgtkglext1-dev

  17. Create and change to Gallium3D build director

     mkdir Gallium3D
 cd Gallium3D

  18. Get latest Mesa3D repository. It's where Gallium3D is hosted right now

     git clone git://git.freedesktop.org/git/mesa/mesa

  19. Compile Mesa3D in a way that compiles Gallium3D and software driver

     cd mesa
 export GALLIUM=$PWD
 make linux-x86-debug

  20. Compile OpenVG

     cd src/gallium/state_trackers/vega
 make
 cd $GALLIUM

  21. Make sure that from now on all apps pick up newly compiled Gallium libs

     export LD_LIBRARY_PATH=$GALLIUM/lib/gallium:$GALLIUM/lib:$LD_LIBRARY_PATH

  22. Make sure Gallium's EGL implementation is using the software driver

     export EGL_DRIVER="egl_softpipe"

  23. Build and test OpenVG demos

     cd progs/openvg/demos
 make
 ./sp
 ./lion

  24. Get special version of udis86 for llvmpipe

     cd $GALLIUM/..
 git clone git://people.freedesktop.org/~jrfonseca/udis86
 cd udis86
 ./configure --with-pic
 make
 sudo make install

  25. Patch llvm header to fix typo

     --- /usr/include/llvm-c/Core.h.orig        2009-08-10 15:38:54.000000000 +0100
 +++ /usr/include/llvm-c/Core.h     2009-08-10 15:38:25.000000000 +0100
 @@ -831,7 +831,7 @@
    template<typename T>
    inline T **unwrap(LLVMValueRef *Vals, unsigned Length) {
      #if DEBUG
 -    for (LLVMValueRef *I = Vals, E = Vals + Length; I != E; ++I)
 +    for (LLVMValueRef *I = Vals, *E = Vals + Length; I != E; ++I)
        cast<T>(*I);
      #endif
      return reinterpret_cast<T**>(Vals);

  26. Build llvmpipe

     cd $GALLIUM
 scons debug=yes statetrackers=mesa drivers=llvmpipe winsys=xlib dri=false -k

  27. Test llvmpipe

     export LD_LIBRARY_PATH=$GALLIUM/build/linux-x86-debug/lib:$GALLIUM/build/linux-x86_64-debug:$LD_LIBRARY_PATH

  28. Build Python State Tracker

     cd $GALLIUM
 scons debug=yes statetrackers=python drivers=softpipe,trace winsys=none

  29. Test Python State Tracker

     export PYTHONPATH=$GALLIUM/build/linux-x86-debug/gallium/state_trackers/python
 python $GALLIUM/src/gallium/state_trackers/python/samples/tri.py

  30. Get rbug-gui source

     cd $GALLIUM/..
 git clone git://git.freedesktop.org/git/mesa/rbug-gui

  31. Build rbug-gui

     cd rbug-gui
 ./autogen.sh
 make