From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by dpdk.space (Postfix) with ESMTP id 2E4D5A045E for ; Wed, 29 May 2019 18:19:42 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 348CF4F91; Wed, 29 May 2019 18:19:41 +0200 (CEST) Received: from mga12.intel.com (mga12.intel.com [192.55.52.136]) by dpdk.org (Postfix) with ESMTP id 2EF2C4CA6 for ; Wed, 29 May 2019 18:19:38 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by fmsmga106.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 29 May 2019 09:19:38 -0700 X-ExtLoop1: 1 Received: from silpixa00399126.ir.intel.com (HELO silpixa00399126.ger.corp.intel.com) ([10.237.223.2]) by fmsmga006.fm.intel.com with ESMTP; 29 May 2019 09:19:36 -0700 From: Bruce Richardson To: dev@dpdk.org Cc: john.mcnamara@intel.com, marko.kovacevic@intel.com, Bruce Richardson Date: Wed, 29 May 2019 17:19:32 +0100 Message-Id: <20190529161932.50459-1-bruce.richardson@intel.com> X-Mailer: git-send-email 2.21.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH] doc: update quickstart guide for building with meson 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" The build-sdk-meson.txt file is a little out of date, so update it with information on the latest build requirements, and remove any content no longer needed. Since the cross-compilation file quoted in the document is now considerably longer and more complex than previous, replace the contents of the file with a summary of it instead. This is shorter and more maintainable, and the original file is available as part of the repo anyway if the user wants to view it. Signed-off-by: Bruce Richardson --- doc/build-sdk-meson.txt | 27 +++++---------------------- 1 file changed, 5 insertions(+), 22 deletions(-) diff --git a/doc/build-sdk-meson.txt b/doc/build-sdk-meson.txt index 7b802442b..fc7fe37b5 100644 --- a/doc/build-sdk-meson.txt +++ b/doc/build-sdk-meson.txt @@ -32,8 +32,8 @@ The ``meson`` tool is used to configure a DPDK build. On most Linux distributions this can be got using the local package management system, e.g. ``dnf install meson`` or ``apt-get install meson``. If meson is not available as a suitable package, it can also be installed using the Python -3 ``pip`` tool, e.g. ``pip3 install meson``. Version 0.42 of meson is -recommended - if the version packaged is too old, the latest version is +3 ``pip`` tool, e.g. ``pip3 install meson``. Version 0.47.1 of meson is +required - if the version packaged is too old, the latest version is generally available from "pip". The other dependency for building is the ``ninja`` tool, which acts similar @@ -164,20 +164,9 @@ For example if the target machine is arm64 we can use the following command:: meson arm-build --cross-file config/arm/arm64_armv8_linux_gcc -where config/arm/arm64_armv8_linux_gcc contains the following -parameters:: - - [binaries] - c = 'aarch64-linux-gnu-gcc' - cpp = 'aarch64-linux-gnu-cpp' - ar = 'aarch64-linux-gnu-ar' - - [host_machine] - system = 'linux' - cpu_family = 'aarch64' - cpu = 'armv8-a' - endian = 'little' - +where config/arm/arm64_armv8_linux_gcc contains settings for the compilers +and other build tools to be used, as well as characteristics of the target +machine. Using the DPDK within an Application ------------------------------------- @@ -203,9 +192,3 @@ From examples/helloworld/Makefile:: build: @mkdir -p $@ - -NOTE: for --static builds, DPDK needs to be built with Meson >= 0.46 in order to -fully generate the list of private dependencies. If DPDK is built with an older -version of Meson, it might be necessary to manually specify dependencies of DPDK -PMDs/libraries, for example -lmlx5 -lmnl for librte-pmd-mlx5, or the static link -step might fail. -- 2.21.0