From patchwork Mon Oct 11 13:42:27 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Juraj_Linke=C5=A1?= X-Patchwork-Id: 101037 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 7B304A034F; Mon, 11 Oct 2021 15:42:32 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 5F13040E50; Mon, 11 Oct 2021 15:42:32 +0200 (CEST) Received: from lb.pantheon.sk (lb.pantheon.sk [46.229.239.20]) by mails.dpdk.org (Postfix) with ESMTP id 959FD40E0F for ; Mon, 11 Oct 2021 15:42:30 +0200 (CEST) Received: from localhost (localhost [127.0.0.1]) by lb.pantheon.sk (Postfix) with ESMTP id F208410C903; Mon, 11 Oct 2021 15:42:29 +0200 (CEST) X-Virus-Scanned: amavisd-new at siecit.sk Received: from lb.pantheon.sk ([127.0.0.1]) by localhost (lb.pantheon.sk [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id kNe2G3RrZLL1; Mon, 11 Oct 2021 15:42:28 +0200 (CEST) Received: from service-node1.lab.pantheon.local (unknown [46.229.239.141]) by lb.pantheon.sk (Postfix) with ESMTP id DBB6010A155; Mon, 11 Oct 2021 15:42:27 +0200 (CEST) From: =?utf-8?q?Juraj_Linke=C5=A1?= To: thomas@monjalon.net, david.marchand@redhat.com, bruce.richardson@intel.com Cc: dev@dpdk.org, =?utf-8?q?Juraj_Linke=C5=A1?= Date: Mon, 11 Oct 2021 15:42:27 +0200 Message-Id: <1633959747-28723-1-git-send-email-juraj.linkes@pantheon.tech> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1633419847-13109-1-git-send-email-juraj.linkes@pantheon.tech> References: <1633419847-13109-1-git-send-email-juraj.linkes@pantheon.tech> MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH v2] doc: update machine meson option in prog guide 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 Sender: "dev" Update the docs to reflect the two new variables, cpu_instruction_set for non-arm builds and platform for arm builds. Fixes: bf66003b51ec ("build: use platform for generic and native builds") Signed-off-by: Juraj Linkeš --- v2: ci retest --- doc/guides/prog_guide/build-sdk-meson.rst | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/doc/guides/prog_guide/build-sdk-meson.rst b/doc/guides/prog_guide/build-sdk-meson.rst index 877a64b061..0f5ce599be 100644 --- a/doc/guides/prog_guide/build-sdk-meson.rst +++ b/doc/guides/prog_guide/build-sdk-meson.rst @@ -91,7 +91,8 @@ Project-specific options are passed used -Doption=value:: meson -Denable_docs=true fullbuild # build and install docs - meson -Dmachine=generic # use builder-independent baseline -march + meson -Dcpu_instruction_set=generic # use builder-independent + # baseline -march meson -Ddisable_drivers=event/*,net/tap # disable tap driver and all # eventdev PMDs for a smaller build @@ -120,9 +121,16 @@ Examples of setting some of the same options using meson configure:: re-scan from meson. .. note:: - machine=generic uses a config that works on all supported architectures - regardless of the capabilities of the machine where the build is happening. + cpu_instruction_set=generic uses an instruction set that works on all + supported architectures regardless of the capabilities of the machine + where the build is happening. +.. note:: + cpu_instruction_set is not used in Arm builds, as setting the instruction + set without other parameters leads to inferior builds. The way to tailor + Arm builds is to build for a SoC using -Dplatform=. + +] As well as those settings taken from ``meson configure``, other options such as the compiler to use can be passed via environment variables. For example::