From patchwork Thu Sep 3 14:49:42 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bruce Richardson X-Patchwork-Id: 76410 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 8FD8BA04BF; Thu, 3 Sep 2020 16:50:28 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 7A5A51BEAF; Thu, 3 Sep 2020 16:50:02 +0200 (CEST) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by dpdk.org (Postfix) with ESMTP id 60AC21C0CC for ; Thu, 3 Sep 2020 16:50:00 +0200 (CEST) IronPort-SDR: xNQxpSVIdD9nYxy5HV4UtqSquhO6bLIBTYqN0GjWmJ1ev17p83Pmtz9JnZbjZcO0LBd53xl17P K8DPWNMjAHwA== X-IronPort-AV: E=McAfee;i="6000,8403,9733"; a="242403480" X-IronPort-AV: E=Sophos;i="5.76,387,1592895600"; d="scan'208";a="242403480" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga004.jf.intel.com ([10.7.209.38]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 03 Sep 2020 07:50:00 -0700 IronPort-SDR: p9bWVabqmj7EaSnW2wfwv006XbZ/23VrBpdtsPrmtIZuoaK1csh5ZIB5aesA946XWow2XkNG5v aybVvH+WVFVQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.76,387,1592895600"; d="scan'208";a="446930303" Received: from silpixa00399126.ir.intel.com ([10.237.222.27]) by orsmga004.jf.intel.com with ESMTP; 03 Sep 2020 07:49:58 -0700 From: Bruce Richardson To: dev@dpdk.org Cc: Ma Lihong , Hemant Agrawal , Bruce Richardson Date: Thu, 3 Sep 2020 15:49:42 +0100 Message-Id: <20200903144942.671870-4-bruce.richardson@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200903144942.671870-1-bruce.richardson@intel.com> References: <20200825114447.135030-1-bruce.richardson@intel.com> <20200903144942.671870-1-bruce.richardson@intel.com> MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH v2 3/3] doc: add notes on overriding extra config values 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" Since it's possible to tweak the DPDK build a little further using CFLAGS, we note that in the documentation. Suggested-by: Hemant Agrawal Signed-off-by: Bruce Richardson Acked-by: Hemant Agrawal --- doc/guides/linux_gsg/build_dpdk.rst | 8 ++++++++ doc/guides/prog_guide/build-sdk-meson.rst | 8 ++++++++ 2 files changed, 16 insertions(+) diff --git a/doc/guides/linux_gsg/build_dpdk.rst b/doc/guides/linux_gsg/build_dpdk.rst index c536e354e..9c242069e 100644 --- a/doc/guides/linux_gsg/build_dpdk.rst +++ b/doc/guides/linux_gsg/build_dpdk.rst @@ -117,6 +117,14 @@ dependencies are met on the current system are built. When `-Dexamples=all` is set as a meson option, meson will check each example application to see if it can be built, and add all which can be built to the list of tasks in the ninja build configuration file. +.. note:: + + A number of buildtime constants are present in DPDK, listed in file ``config/rte_config.h``. + While these should not normally need to be changed, + they can be overridden by setting the new value of the constant in the ``CFLAGS`` environment variable, + or via ``c_args`` meson parameter. + For example: ``meson configure -Dc_args="-DRTE_PKTMBUF_HEADROOM=256"`` + Building Applications Using Installed DPDK ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/doc/guides/prog_guide/build-sdk-meson.rst b/doc/guides/prog_guide/build-sdk-meson.rst index 44d1cafdf..3838871a3 100644 --- a/doc/guides/prog_guide/build-sdk-meson.rst +++ b/doc/guides/prog_guide/build-sdk-meson.rst @@ -68,6 +68,14 @@ built into meson, while others, such as ``max_lcores``, or the list of examples to build, are DPDK-specific. To have a list of all options available run ``meson configure`` in the build directory. +.. note:: + + A number of buildtime constants are present in DPDK, listed in file ``config/rte_config.h``. + While these should not normally need to be changed, + they can be overridden by setting the new value of the constant in the ``CFLAGS`` environment variable, + or via ``c_args`` meson parameter. + For example: ``meson configure -Dc_args="-DRTE_PKTMBUF_HEADROOM=256"`` + Examples of adjusting the defaults when doing initial meson configuration. Project-specific options are passed used -Doption=value::