Update INSTALL.Windows to build datapath
authorNithin Raju <nithin@vmware.com>
Fri, 6 Feb 2015 06:22:09 +0000 (22:22 -0800)
committerGurucharan Shetty <gshetty@nicira.com>
Fri, 6 Feb 2015 14:59:51 +0000 (06:59 -0800)
In a previous commit, support had been added to support building
the kernel datapath from command line. In this patch, we document
it.

Signed-off-by: Nithin Raju <nithin@vmware.com>
Signed-off-by: Gurucharan Shetty <gshetty@nicira.com>
INSTALL.Windows.md

index 138d1bb..0882501 100644 (file)
@@ -96,15 +96,29 @@ For example,
 
 * Run make for the ported executables.
 
-Building the Kernel module
---------------------------
-We directly use the Visual Studio 2013 IDE to compile the kernel module. You can
-open the extensions.sln file in the IDE and build the solution.
+Building the Kernel datapath module
+-----------------------------------
+* We directly use the Visual Studio 2013 IDE to compile the kernel datapath.
+You can open the extensions.sln file in the IDE and build the solution.
+
+* The kernel datapath can be compiled from command line as well.  The top
+level 'make' will invoke building the kernel datapath, if the
+'--with-vstudioddk' argument is specified while configuring the package.
+For example,
+
+    % ./configure CC=./build-aux/cccl LD="`which link`" LIBS="-lws2_32" \
+    --prefix="C:/openvswitch/usr" --localstatedir="C:/openvswitch/var" \
+    --sysconfdir="C:/openvswitch/etc" --with-pthread="C:/pthread" \
+    --enable-ssl --with-openssl="C:/OpenSSL-Win32" \
+    --with-vstudioddk="<WDK to use>"
+
+    Possible values for "<WDK to use>" are:
+    "Win8.1 Debug", "Win8.1 Release", "Win8 Debug" and "Win8 Release".
 
 Installing the Kernel module
 ----------------------------
 Once you have built the solution, you can copy the following files to the
-target Hyper-V machines:
+target Hyper-V machines.
 
     ./datapath-windows/x64/Win8.1Debug/package/ovsext.inf
     ./datapath-windows/x64/Win8.1Debug/package/OVSExt.sys
@@ -112,6 +126,10 @@ target Hyper-V machines:
     ./datapath-windows/misc/install.cmd
     ./datapath-windows/misc/uninstall.cmd
 
+The above path assumes that the kernel module has been built using Windows
+DDK 8.1 in Debug mode. Change the path appropriately, if a different WDK
+has been used.
+
 Steps to install the module
 ---------------------------