From: Gregory Etelson Date: Thu, 26 Nov 2020 16:43:28 +0000 (+0100) Subject: doc: add pkg-config requirement for applications X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=829b22c212f08a8a1a0bffccc0b6258ca4c635f8;p=dpdk.git 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 --- 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 -------------------------