From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id BD27CA04DD; Thu, 26 Nov 2020 17:43:41 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 8FF46CA10; Thu, 26 Nov 2020 17:43:40 +0100 (CET) Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) by dpdk.org (Postfix) with ESMTP id EA5A4C9F4 for ; Thu, 26 Nov 2020 17:43:38 +0100 (CET) Received: from compute2.internal (compute2.nyi.internal [10.202.2.42]) by mailout.nyi.internal (Postfix) with ESMTP id 6BD575C0174; Thu, 26 Nov 2020 11:43:37 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute2.internal (MEProxy); Thu, 26 Nov 2020 11:43:37 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; s=fm2; bh=ADTOr7/f3/PtA H5/Ove1fQLU91enQVyKzk0Ib2klNF0=; b=o8GQndhnLu3qUEqYTrCr6Sfk9k23X TjfQNuBav7n7PvhPnlVWnOAHh8DICHQ713XBrYsBPZ347xiw+EOPwQhc1e4yZOr5 Y8tbMNr8Y5InOS57/aBGVey81GRPpr+gfuOSIWZtZdyAw7KJKvwQnWa500Uc52lL +YiHifmPnxcYIRFL+97zGW2iehj7jc4aa9EmStiqNdV8pnedtQGCzxnSp2B9ExTM DOONZ4sAtmVhlPvPnDKMCnyWyf4uI26wySuiD6kYffwb64tMZscEO5jd2Ktm88Qr wlBcQtUPeD8O2AunXb9j0/L8stI30MJm5KJiONT69jfFNM8aPT047NoFw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :in-reply-to:message-id:mime-version:references:subject:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; bh=ADTOr7/f3/PtAH5/Ove1fQLU91enQVyKzk0Ib2klNF0=; b=cBmOFVxm 3O5IQHgpACbTj7nieClxOE8cw4deAz5rVx5mjL1uW3dWHcxiLLqBxwA/y7bQC5if cC4mnBs9JG2RvcNesaBaes/JADLrmcrXd5n3l3HkxtHTSF/PmBc+0wWkelgvBvR9 0d9ubu7MXPPj6T6TNbm9yxLW7e3Ei58WULPhf9lK302m8hXf9UMH3lWtFTzJzieE 1eCtttpoWUVhjPAdw3kzJeDtuIfdNXGoNIl0OHm/YpvILeglaIFEuKdk8Hrpm+zt ZbnX4a12oUPFvpxGotI9/FEvuY2+ASvqQTWVEOStBWIXMSSBMwSkKGSOMYwXe+vP 0H2r4lT0OSA7ow== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedujedrudehvddgledvucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvufffkffojghfggfgsedtkeertdertddtnecuhfhrohhmpefvhhhomhgr shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecugg ftrfgrthhtvghrnhepvdehgfeivdejgedtveehfefhteelfefgieevgfffveefjeegtdfg uedthedtgeevnecukfhppeejjedrudefgedrvddtfedrudekgeenucevlhhushhtvghruf hiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehthhhomhgrshesmhhonhhjrghl ohhnrdhnvght X-ME-Proxy: Received: from xps.monjalon.net (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id 55F94328005A; Thu, 26 Nov 2020 11:43:36 -0500 (EST) From: Thomas Monjalon To: dev@dpdk.org Cc: david.marchand@redhat.com, bruce.richardson@intel.com, Gregory Etelson Date: Thu, 26 Nov 2020 17:43:28 +0100 Message-Id: <20201126164328.1515020-1-thomas@monjalon.net> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201117181746.17904-1-getelson@nvidia.com> References: <20201117181746.17904-1-getelson@nvidia.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v3 1/1] doc: add pkg-config requirement for applications 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" From: Gregory Etelson 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 --- v3: improve wording with Bruce's suggestions v2: make a more global note about the need for pkg-config in app build --- 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 dadb23fc89..9116616fe9 100644 --- a/doc/guides/linux_gsg/sys_reqs.rst +++ b/doc/guides/linux_gsg/sys_reqs.rst @@ -94,6 +94,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.28.0