From patchwork Thu Mar 10 12:38:39 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bruce Richardson X-Patchwork-Id: 108648 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 273ACA0093; Thu, 10 Mar 2022 13:39:21 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B30F841161; Thu, 10 Mar 2022 13:39:03 +0100 (CET) Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by mails.dpdk.org (Postfix) with ESMTP id CBE884114F for ; Thu, 10 Mar 2022 13:39:00 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1646915941; x=1678451941; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=ZGhTWsEE3z1Vk9a5dVD79GpWqBzQgi5T6hSDUXuC21Q=; b=nOUrkRCWKrwg1CirvDzspQYVQ17V9j91u/rsROt+5ptV+6vDli3Acmvy 1u1v+/IMYUf5MMGKzYLE5Jmm8sh1elK2EzDaaW33sj30aZQ5ofUItNUld vPuXcKpjq2QpTaFX36XXOdnNHidbzAHN3iiKq3Zfpj2GRI6OZEaPko1dh rbgoOE/45cCxe9PUtiLqlgs7uSymvYC+iO64SsZMHROAFBRoN0UlnxQfI qkPjULHw88dFNA2LeLpAUF7+4uI0jJGKO7f+DMCtMEhV47Xhj988aPBKa siaBI8ov3/4HT6Pmu6y6PuQNAFaAlCWbph0cBVf/MYkxq7hfJePGXvqh2 g==; X-IronPort-AV: E=McAfee;i="6200,9189,10281"; a="315957617" X-IronPort-AV: E=Sophos;i="5.90,170,1643702400"; d="scan'208";a="315957617" Received: from orsmga006.jf.intel.com ([10.7.209.51]) by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 10 Mar 2022 04:39:00 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.90,170,1643702400"; d="scan'208";a="513970217" Received: from silpixa00399126.ir.intel.com ([10.237.223.34]) by orsmga006.jf.intel.com with ESMTP; 10 Mar 2022 04:38:58 -0800 From: Bruce Richardson To: dev@dpdk.org Cc: john.mcnamara@intel.com, Bruce Richardson Subject: [PATCH v2 4/8] doc/linux_gsg: merge requirements section for app building Date: Thu, 10 Mar 2022 12:38:39 +0000 Message-Id: <20220310123843.612207-5-bruce.richardson@intel.com> X-Mailer: git-send-email 2.32.0 In-Reply-To: <20220310123843.612207-1-bruce.richardson@intel.com> References: <20220308145001.529734-1-bruce.richardson@intel.com> <20220310123843.612207-1-bruce.richardson@intel.com> MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org When building end-applications linked with DPDK, the only additional tool needed is pkg-config/pkgconf. However, the standard development tools meta-packages on most distro's include this as standard, meaning it does not really require its own section. The one outlier in the existing text is "alpine" where it is not present when using "libc-dev" target. However, changing "gcc" and "libc-dev" to "alpine-sdk" metapackage aligns alpine with the other distros in this regard. Signed-off-by: Bruce Richardson --- doc/guides/linux_gsg/sys_reqs.rst | 26 ++++++++++---------------- 1 file changed, 10 insertions(+), 16 deletions(-) diff --git a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst index df367742cc..08d45898f0 100644 --- a/doc/guides/linux_gsg/sys_reqs.rst +++ b/doc/guides/linux_gsg/sys_reqs.rst @@ -27,11 +27,19 @@ Compilation of the DPDK The setup commands and installed packages needed on various systems may be different. For details on Linux distributions and the versions tested, please consult the DPDK Release Notes. -* General development tools including a supported C compiler such as gcc (version 4.9+) or clang (version 3.4+). +* General development tools including a supported C compiler such as gcc (version 4.9+) or clang (version 3.4+), + and ``pkg-config`` or ``pkgconf`` to be used when building end-user binaries against DPDK. * For RHEL/Fedora systems these can be installed using ``dnf groupinstall "Development Tools"`` * For Ubuntu/Debian systems these can be installed using ``apt install build-essential`` - * For Alpine Linux, ``apk add gcc libc-dev bsd-compat-headers libexecinfo-dev`` + * For Alpine Linux, ``apk add alpine-sdk bsd-compat-headers libexecinfo-dev`` + +.. 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. + Use an updated version of ``pkg-config`` or ``pkgconf`` instead when building applications * Python 3.5 or later. @@ -87,20 +95,6 @@ For poll-mode drivers, the additional dependencies for each driver can be 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 -------------------------