X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;ds=sidebyside;f=README;h=3e986a4867360eb5dcb32320aa857eb7d3daabaf;hb=732dcb37a81c657fa587650bbf237e5f9c2bbc0d;hp=8991e4c81276b1a769731fffe4a6de650f57225d;hpb=064af42167bf4fc9aaea2702d80ce08074b889c0;p=openvswitch

diff --git a/README b/README
index 8991e4c8..3e986a48 100644
--- a/README
+++ b/README
@@ -3,7 +3,7 @@
 What is Open vSwitch?
 ---------------------
 
-Open vSwitch is an Ethernet switch for virtual servers with the
+Open vSwitch is a versatile software-based Ethernet switch with the 
 following features:
 
 	* NIC bonding with automatic fail-over and source MAC-based TX
@@ -15,60 +15,68 @@ following features:
 
 	* NetFlow v5 flow logging.
 
-	* Connectivity to an external OpenFlow controller, such as
-          NOX.
+	* Connectivity to an external OpenFlow controller, such as NOX.
+
+Open vSwitch supports Linux 2.6.15 and up, with testing focused on
+2.6.18 with Centos and Xen patches and version 2.6.26 from kernel.org.
+Open vSwitch also has special support for Citrix XenServer hosts.
 
 What's here?
 ------------
 
-The most important components of this distribution are:
+The main components of this distribution are:
+
+    * ovs-vswitchd, a daemon that implements the switch, along with 
+      a companion Linux kernel module for flow-based switching.
 
-	- A Linux kernel module for flow-based switching, in the
-          datapath directory.
+    * ovs-brcompatd, a daemon that allows ovs-vswitchd to act as a
+      drop-in replacement for the Linux bridge in many environments, 
+      along with a companion Linux kernel module to intercept bridge 
+      ioctls.
 
-        - ovs-vswitchd, a daemon that implements the virtual switch.
+    * ovs-dpctl, a tool for configuring the switch kernel module.
 
-	- ovs-dpctl, a tool for configuring the kernel module and
-          controlling OpenFlow switches.
+    * Scripts and specs for building RPMs that allow Open vSwitch
+      to be installed on a Citrix XenServer host as a drop-in
+      replacement for its switch, with additional functionality.
 
-This distribution includes some additional software as well:
+    * vlog-appctl, a utility that can control Open vSwitch daemons,
+      adjusting their logging levels among other uses.
 
-	- secchan, a program that implements a simple OpenFlow switch
-          (without the special features provided by ovs-vswitchd) using
-          the same kernel module as ovs-vswitchd.
+Open vSwitch also provides an OpenFlow implementation and tools for
+those interested in OpenFlow but not additional Open vSwitch features:
 
-	- ovs-controller, a simple OpenFlow switch
+    * secchan, a program that implements a simple OpenFlow switch
+      (without the special features provided by ovs-vswitchd) using
+      the same kernel module as ovs-vswitchd.
 
-	- ovs-ofctl, a utility for querying and controlling OpenFlow
-          switches and controllers.
+    * ovs-controller, a simple OpenFlow controller.
 
-	- vlog-appctl, a utility that can control Open vSwitch daemons,
-          adjusting their logging levels among other uses.
+    * ovs-ofctl, a utility for querying and controlling OpenFlow
+      switches and controllers.
 
-	- ovs-pki, a utility for creating and managing the public-key
-          infrastructure for OpenFlow switches.
+    * ovs-pki, a utility for creating and managing the public-key
+      infrastructure for OpenFlow switches.
 
-	- A patch to tcpdump that enables it to parse OpenFlow
-          messages.
+    * A patch to tcpdump that enables it to parse OpenFlow messages.
 
-For installation instructions, read INSTALL.  Each userspace program
-is also accompanied by a manpage.
+What other documentation is available?
+--------------------------------------
 
-Platform support
-----------------
+To install Open vSwitch on a regular Linux machine, read INSTALL.Linux.
 
-Our primary test environment is Debian GNU/Linux.  Ports to other
-platforms are welcome.  Please contact us with portability-related bug
-reports or patches.
+To build RPMs for installing Open vSwitch on a Citrix XenServer host
+or resource pool, read INSTALL.XenServer.
 
-The testing of the kernel module has focused on version 2.6.18 from
-Xen and version 2.6.26 from kernel.org.  Linux 2.6 releases from
-2.6.15 onward should also work.
+To learn set up SSL support for Open vSwitch, read INSTALL.SSL.
 
-GCC is the expected compiler.
+Each Open vSwitch userspace program is accompanied by a manpage.  Many
+of the manpages are customized to your configuration as part of the
+build process, so we recommend building Open vSwitch before reading
+the manpages.
 
 Contact 
 -------
 
-ovs-bugs@openvswitch.org
+bugs@openvswitch.org
 http://openvswitch.org/