diff mbox

[PATCHv2] Update ODP-DPDK README

Message ID 1407479009-11982-1-git-send-email-venkatesh.vivekanandan@linaro.org
State New
Headers show

Commit Message

Venkatesh Vivekanandan Aug. 8, 2014, 6:23 a.m. UTC
From: Venkatesh Vivekanandan <venkatesh.vivekanandan@linaro.org>

- export RTE_SDK and RTE_TARGET before compiling ODP
- Added a link to DPDK's how to compile
- new commands for odp_l2fwd and pktio
- cleanup

Signed-off-by: Venkatesh Vivekanandan <venkatesh.vivekanandan@linaro.org>
---
 platform/linux-dpdk/README | 28 +++++++++++++++++++---------
 1 file changed, 19 insertions(+), 9 deletions(-)

Comments

Anders Roxell Aug. 11, 2014, 9:23 a.m. UTC | #1
On 2014-08-08 11:53, venkatesh.vivekanandan@linaro.org wrote:
> From: Venkatesh Vivekanandan <venkatesh.vivekanandan@linaro.org>
> 
> - export RTE_SDK and RTE_TARGET before compiling ODP
> - Added a link to DPDK's how to compile
> - new commands for odp_l2fwd and pktio
> - cleanup
> 
> Signed-off-by: Venkatesh Vivekanandan <venkatesh.vivekanandan@linaro.org>
> ---
>  platform/linux-dpdk/README | 28 +++++++++++++++++++---------
>  1 file changed, 19 insertions(+), 9 deletions(-)
> 
> diff --git a/platform/linux-dpdk/README b/platform/linux-dpdk/README
> index 14ad4e8..ac0c4b8 100644
> --- a/platform/linux-dpdk/README
> +++ b/platform/linux-dpdk/README
> @@ -16,22 +16,29 @@ $ git clone http://92.243.14.124/git/dpdk ./<dpdk-dir>
>  # we support only 1.6.0r2 of dpdk for now
>  $ git tag -l -- will list all the tags available
>  $ git checkout -b 1.6.0 tags/v1.6.0r2
> -# Please refer dpdk.org website for more details on how to build dpdk.
> +# Please refer to http://dpdk.org/doc/intel/dpdk-start-linux-1.7.0.pdf for
> +# more details on how to build dpdk. This might change in future, so please
> +# watchout for dpdk.org website for latest docs.

Don't refere to a URL that will change...

This might be better:
Please refer to http://dpdk.org/doc/ for details on how to build
DPDK. Start by reading the "Getting started guide for Linux" page.


Cheers,
Anders

>  # Best effort is done to provide some help on dpdk cmds below for Ubuntu,
>  # where it was compiled and tested.
>  # Please refer "How to setup and compile DPDK" section in this document
>  
>  # To compile ODP with linux-dpdk
> +
> +$ export RTE_SDK=<dpdk-dir>
> +# For example
> +$ export RTE_SDK=/root/dpdk
> +$ export RTE_TARGET=x86_64-default-linuxapp-gcc
> +# RTE_TARGET is the configuration used while building DPDK
> +
>  $ cd <odp-dir>
>  $ ./bootstrap
> -$ ./configure --with-platform=linux-dpdk --with-sdk-install-path=<dpdk-install-path>
> -# For example
> -$ ./configure --with-platform=linux-dpdk --with-sdk-install-path=/root/dpdk/build
> +$ ./configure --with-platform=linux-dpdk --with-sdk-install-path=$RTE_SDK/$RTE_TARGET
>  $ make
>  
> -# Commands to test
> -l2fwding app - sudo ./test/l2fwd/odp_l2fwd -i 0,1 -m 0 -c 2
> -loopback app - sudo ./test/packet/odp_pktio -i 0,1 -m 0 -c 2
> +# App commands to test
> +l2fwding app - sudo ./example/l2fwd/odp_l2fwd -i 0,1 -m 0 -c 2
> +loopback app - sudo ./example/packet/odp_pktio -i 0,1 -m 0 -c 2
>  
>  	-i 0,1 - interface number
>  	-m 0   - burst mode
> @@ -42,8 +49,11 @@ How to setup and compile DPDK:
>  $ cd <dpdk-dir>
>  
>  # This has to be done only once.
> -# Following command will generate build dir as ./build in <dpdk-dir>
> -$ make install T=x86_64-default-linuxapp-gcc CONFIG_RTE_BUILD_COMBINE_LIBS=y EXTRA_CFLAGS="-fPIC"
> +$ make config T=x86_64-default-linuxapp-gcc O=x86_64-default-linuxapp-gcc
> +# set CONFIG_RTE_BUILD_COMBINE_LIBS=y in .config file
> +# Note: if non-intel SFP's are used in IXGBE, then set CONFIG_RTE_LIBRTE_IXGBE_ALLOW_UNSUPPORTED_SFP=y in .config file
> +$ make install T=x86_64-default-linuxapp-gcc EXTRA_CFLAGS="-fPIC"
> +
>  
>  # If "conflicting types for skb_set_hash" error happens during dpdk
>  # build, then please knock-off skb_set_hash function from kcompat.h as
> -- 
> 1.8.1.2
> 
> 
> _______________________________________________
> lng-odp mailing list
> lng-odp@lists.linaro.org
> http://lists.linaro.org/mailman/listinfo/lng-odp
diff mbox

Patch

diff --git a/platform/linux-dpdk/README b/platform/linux-dpdk/README
index 14ad4e8..ac0c4b8 100644
--- a/platform/linux-dpdk/README
+++ b/platform/linux-dpdk/README
@@ -16,22 +16,29 @@  $ git clone http://92.243.14.124/git/dpdk ./<dpdk-dir>
 # we support only 1.6.0r2 of dpdk for now
 $ git tag -l -- will list all the tags available
 $ git checkout -b 1.6.0 tags/v1.6.0r2
-# Please refer dpdk.org website for more details on how to build dpdk.
+# Please refer to http://dpdk.org/doc/intel/dpdk-start-linux-1.7.0.pdf for
+# more details on how to build dpdk. This might change in future, so please
+# watchout for dpdk.org website for latest docs.
 # Best effort is done to provide some help on dpdk cmds below for Ubuntu,
 # where it was compiled and tested.
 # Please refer "How to setup and compile DPDK" section in this document
 
 # To compile ODP with linux-dpdk
+
+$ export RTE_SDK=<dpdk-dir>
+# For example
+$ export RTE_SDK=/root/dpdk
+$ export RTE_TARGET=x86_64-default-linuxapp-gcc
+# RTE_TARGET is the configuration used while building DPDK
+
 $ cd <odp-dir>
 $ ./bootstrap
-$ ./configure --with-platform=linux-dpdk --with-sdk-install-path=<dpdk-install-path>
-# For example
-$ ./configure --with-platform=linux-dpdk --with-sdk-install-path=/root/dpdk/build
+$ ./configure --with-platform=linux-dpdk --with-sdk-install-path=$RTE_SDK/$RTE_TARGET
 $ make
 
-# Commands to test
-l2fwding app - sudo ./test/l2fwd/odp_l2fwd -i 0,1 -m 0 -c 2
-loopback app - sudo ./test/packet/odp_pktio -i 0,1 -m 0 -c 2
+# App commands to test
+l2fwding app - sudo ./example/l2fwd/odp_l2fwd -i 0,1 -m 0 -c 2
+loopback app - sudo ./example/packet/odp_pktio -i 0,1 -m 0 -c 2
 
 	-i 0,1 - interface number
 	-m 0   - burst mode
@@ -42,8 +49,11 @@  How to setup and compile DPDK:
 $ cd <dpdk-dir>
 
 # This has to be done only once.
-# Following command will generate build dir as ./build in <dpdk-dir>
-$ make install T=x86_64-default-linuxapp-gcc CONFIG_RTE_BUILD_COMBINE_LIBS=y EXTRA_CFLAGS="-fPIC"
+$ make config T=x86_64-default-linuxapp-gcc O=x86_64-default-linuxapp-gcc
+# set CONFIG_RTE_BUILD_COMBINE_LIBS=y in .config file
+# Note: if non-intel SFP's are used in IXGBE, then set CONFIG_RTE_LIBRTE_IXGBE_ALLOW_UNSUPPORTED_SFP=y in .config file
+$ make install T=x86_64-default-linuxapp-gcc EXTRA_CFLAGS="-fPIC"
+
 
 # If "conflicting types for skb_set_hash" error happens during dpdk
 # build, then please knock-off skb_set_hash function from kcompat.h as