Skip to contentSkip to conversation

doc: update quickstart guide for building with meson

PATCH Applied Bruce Richardson 2 participants 2 messages May 29, 2019 – Jun 5, 2019 Arm/Amlogic Meson SoC support

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: update quickstart guide for building with meson

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.

---
 doc/build-sdk-meson.txt | 27 +++++----------------------
 1 file changed, 5 insertions(+), 22 deletions(-)
doc/build-sdk-meson.txt +5 -22
index 7b802442b..fc7fe37b5 100644
@@ -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.
Signature · 1 line
2.21.0
#1 lore raw

29/05/2019 18:19, Bruce Richardson:

Quoted 11 lines

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.

Applied, thanks