From 829b22c212f08a8a1a0bffccc0b6258ca4c635f8 Mon Sep 17 00:00:00 2001 From: Gregory Etelson Date: Thu, 26 Nov 2020 17:43:28 +0100 Subject: [PATCH] doc: add pkg-config requirement for applications DPDK relies on pkg-config(1) to provide correct parameters for compiler and linker used in application build. Inaccurate build parameters, produced by pkg-config from DPDK .pc files could fail application build or cause unpredicted results during application runtime. Update system requirements doc about a bug in pkg-config v0.27 used in RHEL-7. Signed-off-by: Gregory Etelson Signed-off-by: Thomas Monjalon Acked-by: Bruce Richardson --- doc/guides/linux_gsg/sys_reqs.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst index 7e410750e9..e074faf514 100644 --- a/doc/guides/linux_gsg/sys_reqs.rst +++ b/doc/guides/linux_gsg/sys_reqs.rst @@ -92,6 +92,19 @@ found in that driver's documentation in the relevant DPDK guide document, e.g. :doc:`../nics/index` +Building DPDK Applications +-------------------------- + +The tool pkg-config or pkgconf, integrated in most build systems, +must be used to parse options and dependencies from libdpdk.pc. + +.. note:: + + pkg-config 0.27, supplied with RHEL-7, + does not process the Libs.private section correctly, + resulting in statically linked applications not being linked properly. + + Running DPDK Applications ------------------------- -- 2.20.1