From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 95055A04DD; Wed, 21 Oct 2020 10:17:54 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id BFA03ACDA; Wed, 21 Oct 2020 10:17:38 +0200 (CEST) Received: from mga07.intel.com (mga07.intel.com [134.134.136.100]) by dpdk.org (Postfix) with ESMTP id 69F4CAC67 for ; Wed, 21 Oct 2020 10:17:35 +0200 (CEST) IronPort-SDR: jycI9O3UxNLsqo8d7W8PHwIgW2D4GynPhv6yL4J1fs23JIV9RieNngWPv3msvlGx2vB30aj0vB OoYLKv9K19Nw== X-IronPort-AV: E=McAfee;i="6000,8403,9780"; a="231525170" X-IronPort-AV: E=Sophos;i="5.77,400,1596524400"; d="scan'208";a="231525170" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga003.jf.intel.com ([10.7.209.27]) by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 21 Oct 2020 01:17:33 -0700 IronPort-SDR: 5giDFsiJ6t4j88B1SD4TyZZf2G/JVEkDjqVsMFfi09xqwYSJpMEsfuX0P33ZAS5cJEB8mT/ZMc VTnksjB7k0uA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.77,400,1596524400"; d="scan'208";a="316301899" Received: from silpixa00400355.ir.intel.com (HELO silpixa00400355.ger.corp.intel.com) ([10.237.222.239]) by orsmga003.jf.intel.com with ESMTP; 21 Oct 2020 01:17:31 -0700 From: Ciara Power To: dev@dpdk.org Cc: Ciara Power , Harman Kalra , Kevin Laatz , Jerin Jacob , Nithin Dabilpuram Date: Wed, 21 Oct 2020 09:17:11 +0100 Message-Id: <20201021081725.68541-2-ciara.power@intel.com> X-Mailer: git-send-email 2.22.0 In-Reply-To: <20201021081725.68541-1-ciara.power@intel.com> References: <20200807123009.21266-1-ciara.power@intel.com> <20201021081725.68541-1-ciara.power@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v7 01/14] doc: remove references to make from platforms guides X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Make is no longer supported for compiling DPDK, references are now removed in the documentation. Signed-off-by: Ciara Power Signed-off-by: Harman Kalra Reviewed-by: Kevin Laatz --- v7: Merged changes from another patch, as suggested by the author on v6, and added the relevant sign off. --- doc/guides/platform/bluefield.rst | 22 ------------- doc/guides/platform/octeontx.rst | 51 ++++++++++++------------------- doc/guides/platform/octeontx2.rst | 32 ------------------- 3 files changed, 19 insertions(+), 86 deletions(-) diff --git a/doc/guides/platform/bluefield.rst b/doc/guides/platform/bluefield.rst index deda675b75..366f2b23a7 100644 --- a/doc/guides/platform/bluefield.rst +++ b/doc/guides/platform/bluefield.rst @@ -60,17 +60,6 @@ Native Compilation Refer to :doc:`../nics/mlx5` for prerequisites. Either Mellanox OFED/EN or rdma-core library with corresponding kernel drivers is required. -make build -^^^^^^^^^^ - -.. code-block:: console - - make config T=arm64-bluefield-linux-gcc - make -j - -meson build -^^^^^^^^^^^ - .. code-block:: console meson build @@ -126,17 +115,6 @@ Then, untar the tarball at the cross toolchain directory on the x86 host. cd $(dirname $(which aarch64-linux-gnu-gcc))/.. tar xf aarch64-linux-gnu-mlx.tar -make build -^^^^^^^^^^ - -.. code-block:: console - - make config T=arm64-bluefield-linux-gcc - make -j CROSS=aarch64-linux-gnu- CONFIG_RTE_KNI_KMOD=n CONFIG_RTE_EAL_IGB_UIO=n - -meson build -^^^^^^^^^^^ - .. code-block:: console meson build --cross-file config/arm/arm64_bluefield_linux_gcc diff --git a/doc/guides/platform/octeontx.rst b/doc/guides/platform/octeontx.rst index 7d1cb647d3..42ddb1762e 100644 --- a/doc/guides/platform/octeontx.rst +++ b/doc/guides/platform/octeontx.rst @@ -94,19 +94,15 @@ drivers can be compiled with the following steps, .. code-block:: console - cd - make config T=arm64-thunderx-linux-gcc - make + meson build -Dexamples= + ninja -C build The example applications can be compiled using the following: .. code-block:: console - cd - export RTE_SDK=$PWD - export RTE_TARGET=build - cd examples/ - make + meson build -Dexamples= + ninja -C build Cross Compilation ~~~~~~~~~~~~~~~~~ @@ -115,10 +111,7 @@ The DPDK applications can be cross-compiled on any x86 based platform. The OCTEON TX SDK need to be installed on the build system. The SDK package will provide the required toolchain etc. -Refer to :doc:`../linux_gsg/cross_build_dpdk_for_arm64` for further steps on -compilation. The 'host' & 'CC' to be used in the commands would change, -in addition to the paths to which libnuma related files have to be -copied. +Refer to :doc:`../linux_gsg/cross_build_dpdk_for_arm64` for generic arm64 details. The following steps can be used to perform cross-compilation with OCTEON TX SDK 6.2.0 patch 3: @@ -128,34 +121,28 @@ SDK 6.2.0 patch 3: cd source env-setup - 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-thunderx-linux CC=aarch64-thunderx-linux-gnu-gcc --prefix= - make install - -The above steps will prepare build system with numa additions. Now this build system can be used -to build applications for **OCTEON TX** :sup:`®` platforms. +The above steps will prepare build system with required toolchain. +Now this build system can be used to build applications for **OCTEON TX** :sup:`®` platforms. .. code-block:: console cd - export RTE_SDK=$PWD - export RTE_KERNELDIR=$THUNDER_ROOT/linux/kernel/linux - make config T=arm64-thunderx-linux-gcc - make -j CROSS=aarch64-thunderx-linux-gnu- CONFIG_RTE_KNI_KMOD=n CONFIG_RTE_EAL_IGB_UIO=n EXTRA_CFLAGS="-isystem /include" EXTRA_LDFLAGS="-L/lib -lnuma" + meson build --cross-file config/arm/arm64_thunderx_linux_gcc + ninja -C build -If NUMA support is not required, it can be disabled as explained in -:doc:`../linux_gsg/cross_build_dpdk_for_arm64`. - -Following steps could be used in that case. +The example applications can be compiled using the following: .. code-block:: console - make config T=arm64-thunderx-linux-gcc - make CROSS=aarch64-thunderx-linux-gnu- + cd + meson build --cross-file config/arm/arm64_thunderx_linux_gcc -Dexamples= + ninja -C build + +.. note:: + By default, meson cross compilation uses ``aarch64-linux-gnu-gcc`` toolchain, + if OCTEON TX SDK 6.2.0 patch 3 is available then it can be used by + overriding the c, cpp, ar, strip ``binaries`` attributes to respective thunderx + toolchain binaries in ``config/arm/arm64_thunderx_linux_gcc`` file. SDK and related information can be obtained from: `Cavium support site `_. diff --git a/doc/guides/platform/octeontx2.rst b/doc/guides/platform/octeontx2.rst index c4d64ab4b2..8b5991f03b 100644 --- a/doc/guides/platform/octeontx2.rst +++ b/doc/guides/platform/octeontx2.rst @@ -503,27 +503,6 @@ an x86 based platform. Native Compilation ~~~~~~~~~~~~~~~~~~ -make build -^^^^^^^^^^ - -.. code-block:: console - - make config T=arm64-octeontx2-linux-gcc - make -j - -The example applications can be compiled using the following: - -.. code-block:: console - - cd - export RTE_SDK=$PWD - export RTE_TARGET=build - cd examples/ - make -j - -meson build -^^^^^^^^^^^ - .. code-block:: console meson build @@ -534,17 +513,6 @@ Cross Compilation Refer to :doc:`../linux_gsg/cross_build_dpdk_for_arm64` for generic arm64 details. -make build -^^^^^^^^^^ - -.. code-block:: console - - make config T=arm64-octeontx2-linux-gcc - make -j CROSS=aarch64-marvell-linux-gnu- CONFIG_RTE_KNI_KMOD=n - -meson build -^^^^^^^^^^^ - .. code-block:: console meson build --cross-file config/arm/arm64_octeontx2_linux_gcc -- 2.22.0