X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Flinux_gsg%2Fcross_build_dpdk_for_arm64.rst;h=c5875a6d57f43f4a95b97292dc30eaeac671e158;hb=f31d17807236094268ccd1bead5d740a10fec513;hp=e799b0ba41018ffb6f5d6972005c1a651b6d3dc7;hpb=487eec3401b7a1664982f39da139980a4f5b3adc;p=dpdk.git diff --git a/doc/guides/linux_gsg/cross_build_dpdk_for_arm64.rst b/doc/guides/linux_gsg/cross_build_dpdk_for_arm64.rst index e799b0ba41..c5875a6d57 100644 --- a/doc/guides/linux_gsg/cross_build_dpdk_for_arm64.rst +++ b/doc/guides/linux_gsg/cross_build_dpdk_for_arm64.rst @@ -16,19 +16,21 @@ Obtain the cross tool chain The latest cross compile tool chain can be downloaded from: https://developer.arm.com/open-source/gnu-toolchain/gnu-a/downloads. -Following is the step to get the version 8.2, latest one at the time of this writing. +It is always recommended to check and get the latest compiler tool from the page and use +it to generate better code. As of this writing 8.3-2019.03 is the newest, the following +description is an example of this version. .. code-block:: console - wget https://developer.arm.com/-/media/Files/downloads/gnu-a/8.2-2019.01/gcc-arm-8.2-2019.01-x86_64-aarch64-linux-gnu.tar.xz + wget https://developer.arm.com/-/media/Files/downloads/gnu-a/8.3-2019.03/binrel/gcc-arm-8.3-2019.03-x86_64-aarch64-linux-gnu.tar.xz Unzip and add into the PATH --------------------------- .. code-block:: console - tar -xvf gcc-arm-8.2-2019.01-x86_64-aarch64-linux-gnu.tar.xz - export PATH=$PATH:/gcc-arm-8.2-2019.01-x86_64-aarch64-linux-gnu/bin + tar -xvf gcc-arm-8.3-2019.03-x86_64-aarch64-linux-gnu.tar.xz + export PATH=$PATH:/gcc-arm-8.3-2019.03-x86_64-aarch64-linux-gnu/bin .. note:: @@ -50,7 +52,7 @@ NUMA is required by most modern machines, not needed for non-NUMA architectures. git clone https://github.com/numactl/numactl.git cd numactl - git checkout v2.0.11 -b v2.0.11 + git checkout v2.0.13 -b v2.0.13 ./autogen.sh autoconf -i ./configure --host=aarch64-linux-gnu CC=aarch64-linux-gnu-gcc --prefix= @@ -71,14 +73,35 @@ Copy the NUMA header files and lib to the cross compiler's directories: .. code-block:: console - cp /include/numa*.h /gcc-arm-8.2-2019.01-x86_64-aarch64-linux-gnu/bin/../aarch64-linux-gnu/libc/usr/include/ - cp /lib/libnuma.a /gcc-arm-8.2-2019.01-x86_64-aarch64-linux-gnu/lib/gcc/aarch64-linux-gnu/8.2/ - cp /lib/libnuma.so /gcc-arm-8.2-2019.01-x86_64-aarch64-linux-gnu/lib/gcc/aarch64-linux-gnu/8.2/ + cp /include/numa*.h /gcc-arm-8.3-2019.03-x86_64-aarch64-linux-gnu/aarch64-linux-gnu/libc/usr/include/ + cp /lib/libnuma.a /gcc-arm-8.3-2019.03-x86_64-aarch64-linux-gnu/lib/gcc/aarch64-linux-gnu/8.3.0/ + cp /lib/libnuma.so /gcc-arm-8.3-2019.03-x86_64-aarch64-linux-gnu/lib/gcc/aarch64-linux-gnu/8.3.0/ .. _configure_and_cross_compile_dpdk_build: -Configure and cross compile DPDK Build --------------------------------------- +Cross Compiling DPDK using Meson +-------------------------------- + +Meson depends on pkgconfig to find the dependencies. +The package ``pkg-config-aarch64-linux-gnu`` is required for aarch64. +To install it in Ubuntu:: + + sudo apt-get install pkg-config-aarch64-linux-gnu + +To cross-compile DPDK on a desired target machine we can use the following +command:: + + meson cross-build --cross-file + ninja -C cross-build + +For example if the target machine is arm64 we can use the following +command:: + + meson arm64-build --cross-file config/arm/arm64_armv8_linux_gcc + ninja -C arm64-build + +Configure and Cross Compile DPDK using Make +------------------------------------------- To configure a build, choose one of the target configurations, like arm64-dpaa-linux-gcc and arm64-thunderx-linux-gcc. .. code-block:: console @@ -118,18 +141,3 @@ To compile for non-NUMA targets, without compiling the kernel modules, use the f .. code-block:: console make -j CROSS=aarch64-linux-gnu- CONFIG_RTE_KNI_KMOD=n CONFIG_RTE_EAL_IGB_UIO=n EXTRA_CFLAGS="-isystem /include" EXTRA_LDFLAGS="-L/lib -lnuma" - -Meson Cross Compiling DPDK --------------------------- - -To cross-compile DPDK on a desired target machine we can use the following -command:: - - meson cross-build --cross-file - ninja -C cross-build - -For example if the target machine is arm64 we can use the following -command:: - - meson arm64-build --cross-file config/arm/arm64_armv8_linux_gcc - ninja -C arm64-build