> Do you want to add an INSTALL.FreeBSD or similar file at top level?
> Feel free to copy any applicable text from INSTALL.Linux.  Or, if you
> think it's better, please feel free to edit INSTALL.Linux to include
> FreeBSD instructions also, and then we can rename it to just INSTALL.

The combination of INSTALL.Linux and INSTALL.userspace are very close
to the installation instructions for FreeBSD, so I think renaming it
makes sense - something like the diff below (as well as
s/INSTALL.Linux/INSTALL/ throughout the other INSTALL docs).

Also it turns out that FreeBSD's make doesn't like the Makefiles, so I
just changed it to be explicit about GNU make.

--- INSTALL.Linux  2012-07-10 15:11:10.000000000 -0400
+++ INSTALL     2012-07-25 10:57:31.000000000 -0400
@@ -1,9 +1,9 @@
-                 How to Install Open vSwitch on Linux
-                 ====================================
+           How to Install Open vSwitch on Linux and FreeBSD
+           ================================================

 This document describes how to build and install Open vSwitch on a
-generic Linux host.  If you want to install Open vSwitch on a Citrix
-XenServer, see INSTALL.XenServer instead.
+generic Linux or FreeBSD host.  If you want to install Open vSwitch on
+a Citrix XenServer, see INSTALL.XenServer instead.

 This version of Open vSwitch may be built manually with "configure"
 and "make", as described below.  You may also build Debian packages by
@@ -15,7 +15,7 @@
 To compile the userspace programs in the Open vSwitch distribution,
 you will need the following software:

-    - A make program, e.g. GNU make.  BSD make should also work.
+    - GNU make.

     - The GNU C compiler.  We generally test with version 4.1, 4.2, or
       4.3.
@@ -29,9 +29,9 @@
       libssl is installed, then Open vSwitch will automatically build
       with support for it.

-To compile the kernel module, you must also install the following.  If
-you cannot build or install the kernel module, you may use the
-userspace-only implementation, at a cost in performance.  The
+To compile the kernel module on Linux, you must also install the
+following.  If you cannot build or install the kernel module, you may
+use the userspace-only implementation, at a cost in performance.  The
 userspace implementation may also lack some features.  Refer to
 INSTALL.userspace for more information.

@@ -119,14 +119,14 @@
     - libssl compatible with the libssl used for build, if OpenSSL was
       used for the build.

-    - The Linux kernel version configured as part of the build.
+    - On Linux, the same kernel version configured as part of the build.

-    - For optional support of ingress policing, the "tc" program from
-      iproute2 (part of all major distributions and available at
+    - For optional support of ingress policing on Linux, the "tc" program
+      from iproute2 (part of all major distributions and available at
       http://www.linux-foundation.org/en/Net:Iproute2).

-You should ensure that /dev/urandom exists.  To support TAP devices,
-you must also ensure that /dev/net/tun exists.
+On Linux you should ensure that /dev/urandom exists.  To support TAP
+devices, you must also ensure that /dev/net/tun exists.

 To run the ovsdbmonitor tool, the machine must also have the following
 software:
@@ -144,8 +144,8 @@
 (On Debian "lenny" the above can be installed with "apt-get install
 python-json python-qt4 python-zopeinterface python-twisted-conch".)

-Building and Installing Open vSwitch for Linux
-==============================================
+Building and Installing Open vSwitch for Linux or FreeBSD
+=========================================================

 Once you have installed all the prerequisites listed above in the Base
 Prerequisites section, follow the procedure below to build.
@@ -195,6 +195,8 @@

       % make

+   On FreeBSD systems you need to use "gmake" to invoke GNU make.
+
    For improved warnings if you installed "sparse" (see
    "Prerequisites"), add C=1 to the "make" command line.

@@ -322,7 +324,7 @@
       - If there is no important data in your database, then you may
         delete the database file and recreate it with ovsdb-tool,
         following the instructions under "Building and Installing Open
-        vSwitch for Linux".
+        vSwitch for Linux or FreeBSD".

       - If you want to preserve the contents of your database, back it
         up first, then use "ovsdb-tool convert" to upgrade it, e.g.:
@@ -330,7 +332,7 @@
         % ovsdb-tool convert /usr/local/etc/openvswitch/conf.db
vswitchd/vswitch.ovsschema

 4. Start the Open vSwitch daemons as described under "Building and
-   Installing Open vSwitch for Linux" above.
+   Installing Open vSwitch for Linux or FreeBSD" above.

 Bug Reporting
 -------------

--- a/INSTALL.userspace
+++ b/INSTALL.userspace
@@ -17,7 +17,7 @@ Building and Installing
 -----------------------

 The requirements and procedure for building, installing, and
-configuring Open vSwitch are the same as those given in INSTALL.Linux.
+configuring Open vSwitch are the same as those given in INSTALL.
 You may omit configuring, building, and installing the kernel module,
 and the related requirements.

@@ -31,6 +31,10 @@ The tun device must also exist as /dev/net/tun.  If
it does not exist,
 then create /dev/net (if necessary) with "mkdir /dev/net", then create
 /dev/net/tun with "mknod /dev/net/tun c 10 200".

+On FreeBSD, the userspace switch additionally requires the kernel
+tap(4) driver to be available, either built into the kernel or loaded
+as a module.
+
_______________________________________________
dev mailing list
dev@openvswitch.org
http://openvswitch.org/mailman/listinfo/dev

Reply via email to