datapath-windows: Rename switch context's nameHashArray and vport's nameLink login...

[cascardo/ovs.git] / INSTALL.Fedora

diff --git a/INSTALL.Fedora b/INSTALL.Fedora
index d023127..aa76c06 100644 (file)
--- a/INSTALL.Fedora
+++ b/INSTALL.Fedora
@@ -13,17 +13,43 @@ Building Open vSwitch for Fedora
 You may build from an Open vSwitch distribution tarball or from an
 Open vSwitch Git tree.
 
-Before you begin, note the RPM source directory on your version of
-Fedora.  On Fedora 15, it is $HOME/rpmbuild/SOURCES.
-
-1. If you are building from an Open vSwitch Git tree, then you will
-   need to first create a distribution tarball by running "./boot.sh;
-   ./configure; make dist" in the Git tree.
-
-2. Copy the distribution tarball into the RPM source directory.
-
-3. Unpack the distribution tarball into a temporary directory and "cd"
-   into the root of the distribution tarball.
+The default RPM build directory (_topdir) has five directories in
+the top-level:
+1. BUILD/ Where the software is unpacked and built.
+2. RPMS/ Where the newly created binary package files are written.
+3. SOURCES/ Contains the original sources, patches, and icon files.
+4. SPECS/ Contains the spec files for each package to be built.
+5. SRPMS/ Where the newly created source package files are written.
+
+Before you begin, note the RPM sources directory on your version of
+Fedora.  The command "rpmbuild --showrc" will show the configuration
+for each of those directories. Alternatively, the command "rpm --eval
+ '%{_topdir}'" shows the current configuration for the top level
+directory and the command "rpm --eval '%{_sourcedir}'" does the same
+for the sources directory.  On Fedora 17, the default RPM _topdir is
+$HOME/rpmbuild and the default RPM sources directory is
+$HOME/rpmbuild/SOURCES.
+
+1. If you are building from a distribution tarball, skip to step 2.
+   Otherwise, you must be building from an Open vSwitch Git tree.
+   Create a distribution tarball from the root of the Git tree by
+   running:
+
+       ./boot.sh
+       ./configure
+       make dist
+
+2. Now you have a distribution tarball, named something like
+   openvswitch-x.y.z.tar.gz.  Copy this file into the RPM sources
+   directory, e.g.:
+
+       cp openvswitch-x.y.z.tar.gz $HOME/rpmbuild/SOURCES
+
+3. Make another copy of the distribution tarball in a temporary
+   directory.  Then unpack the tarball and "cd" into its root, e.g.:
+
+       tar xzf openvswitch-x.y.z.tar.gz
+       cd openvswitch-x.y.z
 
 4. To build Open vSwitch userspace, run:
 
@@ -31,7 +57,12 @@ Fedora.  On Fedora 15, it is $HOME/rpmbuild/SOURCES.
 
    This produces one RPM: "openvswitch".
 
-5. On Fedora 15, to build the Open vSwitch kernel module, run:
+   The above command automatically runs the Open vSwitch unit tests.
+   To disable the unit tests, run:
+
+       rpmbuild -bb --without check rhel/openvswitch-fedora.spec
+
+5. On Fedora 17, to build the Open vSwitch kernel module, run:
 
        rpmbuild -bb rhel/openvswitch-kmod-fedora.spec