diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/contents.html | 1 | ||||
| -rw-r--r-- | docs/vmware-guest.html | 185 |
2 files changed, 186 insertions, 0 deletions
diff --git a/docs/contents.html b/docs/contents.html index e3cea2a7ce3..33c2191ee00 100644 --- a/docs/contents.html +++ b/docs/contents.html @@ -63,6 +63,7 @@ a:visited { <LI><A HREF="extensions.html" target="MainFrame">Mesa Extensions</A> <LI><A HREF="mangling.html" target="MainFrame">Function Name Mangling</A> <LI><A href="llvmpipe.html" target="MainFrame">Gallium llvmpipe driver</A> +<LI><A href="vmware-guest.html" target="MainFrame">VMware SVGA3D guest driver</a> <LI><A href="postprocess.html" target="MainFrame">Gallium post-processing</A> <LI><A href="viewperf.html" target="MainFrame">Viewperf Issues</A> </ul> diff --git a/docs/vmware-guest.html b/docs/vmware-guest.html new file mode 100644 index 00000000000..9295644c14f --- /dev/null +++ b/docs/vmware-guest.html @@ -0,0 +1,185 @@ +<html> + +<title>VMware guest GL driver</title> + +<link rel="stylesheet" type="text/css" href="mesa.css"></head> + +<body> + + +<h1>VMware guest GL driver</h1> + +<p> +This page describes how to build, install and use the VMware guest GL driver +(aka the SVGA or SVGA3D driver) for Linux using the latest source code. +This driver gives a Linux virtual machine access to the host's GPU for +hardware-accelerated 3D. +VMware Workstation running on Linux or Windows and VMware Fusion running on +MacOS are all supported. +</p> + +<p> +End users shouldn't have to go through all these steps once the driver is +included in newer Linux distributions. +</p> + + + +<h2>Components</h2> + +The components involved in this include: +<ul> +<li>Linux kernel module: vmwgfx +<li>X server 2D driver: xf86-video-vmware +<li>User-space libdrm library +<li>Mesa/gallium OpenGL driver: "svga" +</ul> + + +<h2>Prerequisites</h2> + +<ul> +<li>Kernel version at least 2.6.25 +<li>Xserver version at least 1.7 +<li>Ubuntu: For ubuntu you need to install a number of build dependencies. + <pre> + sudo apt-get install git-core + sudo apt-get install automake libtool libpthread-stubs0-dev + sudo apt-get install xserver-xorg-dev x11proto-xinerama-dev + sudo apt-get build-dep libgl1-mesa-dri libxcb-glx0-dev + </pre> +<li>Fedora: For Fedora you also need to install a number of build dependencies. + <pre> + sudo yum install mesa-libGL-devel xorg-x11-server-devel xorg-x11-util-macros + sudo yum install automake gcc libtool expat-devel kernel-devel git-core + </pre> +</ul> + +<p> +Depending on your Linux distro, other packages may be needed. +The configure scripts should tell you what's missing. +</p> + + + +<h2>Getting the Latest Source Code</h2> + +Begin by saving your current directory location: + <pre> + export TOP=$PWD + </pre> + +<ul> +<li>Mesa/Gallium master branch. This code is used to build libGL, and the direct rendering svga driver for libGL, vmwgfx_dri.so, and the X acceleration library libxatracker.so.x.x.x. + <pre> + git clone git://anongit.freedesktop.org/git/mesa/mesa + </pre> +<li>VMware Linux guest kernel module. Note that this repo contains the complete DRM and TTM code. The vmware-specific driver is really only the files prefixed with vmwgfx. + <pre> + git clone git://anongit.freedesktop.org/git/mesa/vmwgfx + </pre> + +<li>libdrm, A user-space library that interfaces with drm. Most distros ship with this driver. Safest bet is really to replace the system one. Optionally you can point LIBDRM_CFLAGS and LIBDRM_LIBS to the libdrm-2.4.22 package in toolchain. But here, we replace: + <pre> + git clone git://anongit.freedesktop.org/git/mesa/drm + </pre> +<li>xf86-video-vmware. The chainloading driver, vmware_drv.so, the legacy driver vmwlegacy_drv.so, and the vmwgfx driver vmwgfx_drv.so. + <pre> + git clone git://anongit.freedesktop.org/git/xorg/driver/xf86-video-vmware + </pre> +</ul> + + +<h2>Building the Code</h2> + +<ul> +<li>Build libdrm: If you're on a 32-bit system, you should skip the --libdir configure option. Note also the comment about toolchain libdrm above. + <pre> + cd $TOP/drm + ./autogen.sh --prefix=/usr --enable-vmwgfx-experimental-api --libdir=/usr/lib64 + make + sudo make install + </pre> +<li>Build Mesa and the vmwgfx_dri.so driver, the vmwgfx_drv.so xorg driver, the X acceleration library libxatracker. +The vmwgfx_dri.so is used by the OpenGL libraries during direct rendering, +and by the Xorg server during accelerated indirect GL rendering. +The libxatracker library is used exclusively by the X server to do render, +copy and video acceleration: +<br> +The following configure options doesn't build the EGL system. +<br> +As before, if you're on a 32-bit system, you should skip the --libdir +configure option. + <pre> + cd $TOP/mesa + ./autogen.sh --prefix=/usr --libdir=/usr/lib64 --with-gallium-drivers=svga --with-dri-drivers= --enable-xa + make + sudo make install + </pre> + +Note that you may have to install other packages that Mesa depends upon +if they're not installed in your system. You should be told what's missing. +<br> +<br> + +<li>xf86-video-vmware: Now, once libxatracker is installed, we proceed with building and replacing the current Xorg driver. First check if your system is 32- or 64-bit. If you're building for a 32-bit system, you will not be needing the --libdir=/usr/lib64 option to autogen. + <pre> + cd $TOP/xf86-video-vmware + ./autogen.sh --prefix=/usr --libdir=/usr/lib64 + make + sudo make install + </pre> +<li>vmwgfx kernel module. First make sure that any old version of this kernel module is removed from the system by issuing + <pre> + sudo rm /lib/modules/`uname -r`/kernel/drivers/gpu/drm/vmwgfx.ko* + </pre> +Then + <pre> + cd $TOP/vmwgfx + make + sudo make install + sudo cp 00-vmwgfx.rules /etc/udev/rules.d + sudo depmod -ae + </pre> +</ul> + + +Now try to load the kernel module by issuing + <pre> + sudo modprobe vmwgfx</pre> +Then type + <pre> + dmesg</pre> +to watch the debug output. It should contain a number of lines prefixed with "[vmwgfx]". + +<p> +Then restart the Xserver (or reboot). +The lines starting with "vmwlegacy" or "VMWARE" in the file /var/log/Xorg.0.log +should now have been replaced with lines starting with "vmwgfx", indicating that +the new Xorg driver is in use. +</p> + + +<h2>Running OpenGL Programs</h2> + +<p> +In a shell, run 'glxinfo' and look for the following to verify that the +driver is working: +</p> + +<pre> +OpenGL vendor string: VMware, Inc. +OpenGL renderer string: Gallium 0.4 on SVGA3D; build: RELEASE; +OpenGL version string: 2.1 Mesa 8.0 +</pre> + +If you don't see this, try setting this environment variable: + <pre> + export LIBGL_DEBUG=verbose</pre> +then rerun glxinfo and examine the output for error messages. +</p> + + + +</body> +</html> |