summaryrefslogtreecommitdiff
path: root/doc/build-sdk-meson.txt
diff options
context:
space:
mode:
authorBruce Richardson <bruce.richardson@intel.com>2019-05-29 17:19:32 +0100
committerThomas Monjalon <thomas@monjalon.net>2019-06-05 12:19:56 +0200
commit8f4ebd0c34adabdec5e18b0622f1ed0a8b80915c (patch)
tree65e59a62e4dacadb270b9a8eb408e6028bd685a5 /doc/build-sdk-meson.txt
parent67dd4d77e04aae6c1ec5b1d0e8e111b102e824ea (diff)
downloaddpdk-8f4ebd0c34adabdec5e18b0622f1ed0a8b80915c.zip
dpdk-8f4ebd0c34adabdec5e18b0622f1ed0a8b80915c.tar.gz
dpdk-8f4ebd0c34adabdec5e18b0622f1ed0a8b80915c.tar.xz
doc: update quick start guide for 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. Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
Diffstat (limited to 'doc/build-sdk-meson.txt')
-rw-r--r--doc/build-sdk-meson.txt27
1 files changed, 5 insertions, 22 deletions
diff --git a/doc/build-sdk-meson.txt b/doc/build-sdk-meson.txt
index 7b80244..fc7fe37 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.