.. SPDX-License-Identifier: BSD-3-Clause Copyright(c) 2018 ARM Corporation. Cross compile DPDK for ARM64 ============================ This chapter describes how to cross compile DPDK for ARM64 from x86 build hosts. .. note:: Whilst it is recommended to natively build DPDK on ARM64 (just like with x86), it is also possible to cross-build DPDK for ARM64. An ARM64 cross compile GNU toolchain is used for this. 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. 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.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.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:: For the host requirements and other info, refer to the release note section: https://releases.linaro.org/components/toolchain/binaries/ Getting the prerequisite library -------------------------------- NUMA is required by most modern machines, not needed for non-NUMA architectures. .. note:: For compiling the NUMA lib, run libtool --version to ensure the libtool version >= 2.2, otherwise the compilation will fail with errors. .. code-block:: console git clone https://github.com/numactl/numactl.git cd numactl git checkout v2.0.11 -b v2.0.11 ./autogen.sh autoconf -i ./configure --host=aarch64-linux-gnu CC=aarch64-linux-gnu-gcc --prefix= make install The numa header files and lib file is generated in the include and lib folder respectively under . .. _augment_the_cross_toolchain_with_numa_support: Augment the cross toolchain with NUMA support --------------------------------------------- .. note:: This way is optional, an alternative is to use extra CFLAGS and LDFLAGS, depicted in :ref:`configure_and_cross_compile_dpdk_build` below. Copy the NUMA header files and lib to the cross compiler's directories: .. code-block:: console 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 -------------------------------------- To configure a build, choose one of the target configurations, like arm64-dpaa2-linuxapp-gcc and arm64-thunderx-linuxapp-gcc. .. code-block:: console make config T=arm64-armv8a-linuxapp-gcc To cross-compile, without compiling the kernel modules, use the following command: .. code-block:: console make -j CROSS=aarch64-linux-gnu- CONFIG_RTE_KNI_KMOD=n CONFIG_RTE_EAL_IGB_UIO=n To cross-compile, including the kernel modules, the kernel source tree needs to be specified by setting RTE_KERNELDIR: .. code-block:: console make -j CROSS=aarch64-linux-gnu- RTE_KERNELDIR= CROSS_COMPILE=aarch64-linux-gnu- To compile for non-NUMA targets, without compiling the kernel modules, use the following command: .. code-block:: console make -j CROSS=aarch64-linux-gnu- CONFIG_RTE_KNI_KMOD=n CONFIG_RTE_EAL_IGB_UIO=n CONFIG_RTE_LIBRTE_VHOST_NUMA=n CONFIG_RTE_EAL_NUMA_AWARE_HUGEPAGES=n .. note:: 1. EXTRA_CFLAGS and EXTRA_LDFLAGS should be added to include the NUMA headers and link the library respectively, if the above step :ref:`augment_the_cross_toolchain_with_numa_support` was skipped therefore the toolchain was not augmented with NUMA support. 2. "-isystem /include" should be add to EXTRA_CFLAGS, otherwise the numa.h file will get a lot of compiling errors of Werror=cast-qual, Werror=strict-prototypes and Werror=old-style-definition. An example is given below: .. 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_linuxapp_gcc ninja -C arm64-build