aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZoltan Kiss <zoltan.kiss@linaro.org>2014-11-25 18:11:19 +0000
committerZoltan Kiss <zoltan.kiss@linaro.org>2015-07-09 14:48:32 +0100
commitdc021dfec135d90cefd36cf1599c83e1266bfc98 (patch)
tree5ed628d05c9e76d1279562cc08e7f1f1df7257c6
parente855893adccf94f06e0243f63755595da7c3b028 (diff)
INSTALL.ODP: Add info about Debian packaging
This makes it easier to deploy OVS with ODP support. Signed-off-by: Zoltan Kiss <zoltan.kiss@linaro.org>
-rw-r--r--INSTALL.ODP.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/INSTALL.ODP.md b/INSTALL.ODP.md
index 243c72a08..16903184a 100644
--- a/INSTALL.ODP.md
+++ b/INSTALL.ODP.md
@@ -52,6 +52,48 @@ Refer to INSTALL.userspace for general requirements of building userspace OVS.
Alternatively go to https://wiki.linaro.org/LNG/Engineering/OVSDPDKOnUbuntu
which explains how to run OVS with DPDK. Similar steps should work with ODP.
+OVS Debian package:
+=============
+You can pass the configure options via DATAPATH_CONFIGURE_OPTS:
+
+DATAPATH_CONFIGURE_OPTS="--with-odp=<ODP_DIR> --with-odp-platform=<platform>" \
+fakeroot debian/rules binary
+
+If you cross-compile, you need to:
+- specify "host" for configure
+- DEB_HOST_GNU_TYPE has to be set for dh_strip
+- DEB_HOST_ARCH has to be set for dh_gencontrol to correctly create the
+ debian/contol files
+- dh_shlibdeps needs to find the libraries in LD_LIBRARY_PATH
+- probably a cross-compiled OpenSSL. That needs to be told to configure
+
+An example:
+
+LD_LIBRARY_PATH='$LD_LIBRARY_PATH:/usr/arm-linux-gnueabihf/lib:<OpenSSL-DIR>' \
+DEB_HOST_GNU_TYPE=arm-linux-gnueabihf \
+DEB_HOST_ARCH=armhf \
+DATAPATH_CONFIGURE_OPTS="--with-odp=<ODP_DIR> --with-odp-platform=<platform> \
+--host=arm-linux-gnueabihf --with-openssl=<OpenSSL-DIR>" fakeroot debian/rules \
+binary
+
+If you compile OpenSSL from upstream, probably you won't have the shlibs file,
+you can create one in <OpenSSL-DIR>/DEBIAN/shlibs:
+
+libcrypto 1.0.0 libcrypto1.0.0 (>= 1.0.1d)
+libssl 1.0.0 libssl1.0.0 (>= 1.0.1d)
+
+If you use DPDK as an ODP platform, and it's not installed to standard library
+paths, you have to LDFLAGS="$(LDFLAGS) -L$(RTE_SDK)/$(RTE_TARGET)/lib" to
+DATAPATH_CONFIGURE_OPTS.
+
+You can influence the package build process through DEB_BUILD_OPTIONS:
+- set parallel compiling
+- skip unit tests, if you are just experimenting with compile
+- not stripping the debug symbols into a separate package, so you don't have to
+ specify them separately to your debug tools
+See INSTALL.Debian for more. An example for the above options:
+DEB_BUILD_OPTIONS='parallel=8 nocheck nostrip'
+
Using ODP with ovs-vswitchd:
----------------------------