docs: add missing code-tags
[mesa.git] / docs / vmware-guest.html
index dce4fc275986df934b5838aed25275989aa45f7c..65a9aa7149f37fa26ea7788746124b033bf2e9d6 100644 (file)
@@ -2,19 +2,19 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>VMware guest GL driver</title>
+  <title>VMware SVGA3D Guest Driver</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  <h1>The Mesa 3D Graphics Library</h1>
+  The Mesa 3D Graphics Library
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>VMware guest GL driver</h1>
+<h1>VMware SVGA3D Guest Driver</h1>
 
 <p>
 This page describes how to build, install and use the
@@ -30,6 +30,7 @@ MacOS are all supported.
 With the August 2015 Workstation 12 / Fusion 8 releases, OpenGL 3.3
 is supported in the guest.
 This requires:
+</p>
 <ul>
 <li>The VM is configured for virtual hardware version 12.
 <li>The host OS, GPU and graphics driver supports DX11 (Windows) or
@@ -37,7 +38,6 @@ This requires:
 <li>On Linux, the vmwgfx kernel module must be version 2.9.0 or later.
 <li>A recent version of Mesa with the updated svga gallium driver.
 </ul>
-</p>
 
 <p>
 Otherwise, OpenGL 2.1 is supported.
@@ -143,7 +143,7 @@ Begin by saving your current directory location:
 <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
+  git clone https://gitlab.freedesktop.org/mesa/mesa.git
   </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>
@@ -153,7 +153,7 @@ Begin by saving your current directory location:
 Most distros ship with this but it's safest to install a newer version.
 To get the latest code from git:
   <pre>
-  git clone git://anongit.freedesktop.org/git/mesa/drm
+  git clone https://gitlab.freedesktop.org/mesa/drm.git
   </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>
@@ -166,9 +166,10 @@ To get the latest code from git:
 
 <ul>
 <li>
+<p>
 Determine where the GL-related libraries reside on your system and set
 the LIBDIR environment variable accordingly.
-<br><br>
+</p>
 For 32-bit Ubuntu systems:
 <pre>
   export LIBDIR=/usr/lib/i386-linux-gnu
@@ -191,28 +192,30 @@ For 64-bit Fedora systems:
 <li>Build libdrm:
   <pre>
   cd $TOP/drm
-  ./autogen.sh --prefix=/usr --libdir=${LIBDIR}
-  make
-  sudo make install
+  meson builddir --prefix=/usr --libdir=${LIBDIR}
+  ninja -C builddir
+  sudo ninja -C builddir install
   </pre>
-<li>Build Mesa and the vmwgfx_dri.so driver, the vmwgfx_drv.so xorg driver, the X acceleration library libxatracker.
+<li>
+<p>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>
+</p>
+
 The following configure options doesn't build the EGL system.
   <pre>
   cd $TOP/mesa
-  ./autogen.sh --prefix=/usr --libdir=${LIBDIR} --with-gallium-drivers=svga --with-dri-drivers=swrast --enable-xa --disable-dri3 --enable-glx-tls
-  make
-  sudo make install
+  meson builddir --prefix=/usr --libdir=${LIBDIR} -Dgallium-drivers=svga -Ddri-drivers=swrast -Dgallium-xa=true -Ddri3=false
+  ninja -C builddir
+  sudo ninja -C builddir install
   </pre>
 
+<p>
 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>
+</p>
 
 <li>xf86-video-vmware: Now, once libxatracker is installed, we proceed with
 building and replacing the current Xorg driver.
@@ -311,7 +314,7 @@ If OpenGL 3.3 is not working (you only get OpenGL 2.1):
 <li>Make sure the vmwgfx kernel module is version 2.9.0 or later.
 <li>Check the vmware.log file for errors.
 <li>Run 'dmesg | grep vmwgfx' and look for "DX: yes".
-
+</ul>
 
 </div>
 </body>