From patchwork Mon Mar 17 16:03:28 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 59269 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id D54EAC35FF3 for ; Mon, 17 Mar 2025 16:03:40 +0000 (UTC) Received: from relay9-d.mail.gandi.net (relay9-d.mail.gandi.net [217.70.183.199]) by mx.groups.io with SMTP id smtpd.web10.56549.1742227418549567162 for ; Mon, 17 Mar 2025 09:03:38 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=pez2BIZa; spf=pass (domain: bootlin.com, ip: 217.70.183.199, mailfrom: antonin.godard@bootlin.com) Received: by mail.gandi.net (Postfix) with ESMTPSA id B54C3442AD; Mon, 17 Mar 2025 16:03:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1742227416; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=h6RNiThSTiIV0sX0hX6PpRkVPSN70AaJr9ej8azbO10=; b=pez2BIZaEtNhXIeszW2ayYIutDj+5cI+y4RctlMtWVZ8fDQ9592pZS+0afFocYgKGdyeOW esQfbD30vpISOfUvheary4BhMFCH7j4gJ9sSP0hLHz+ViUkFmSLEK53tEAr+rOv0m09ZSv YGjvCy4fc2gFUjsL/a+lqjWmDEqxqRobaTnjCLkRFETCL01EnvPYH/DbV3+2uD6VYdaPBa yPlwvVegrsgvE+E7S56LtbeybJK87Af3xYBS4VK/aS84DEL0LAPsF0EuPKqa5G2Xf3hhPG rP7SdsZUsB+MM2q18cFpKWU21N9GsjXNJNSZp8I0lSXfrC2XISUibFF0oHO+Bw== From: Antonin Godard Date: Mon, 17 Mar 2025 17:03:28 +0100 Subject: [PATCH 1/4] ref-manual/variables.rst: add missing documentation for BUILD_* variables MIME-Version: 1.0 Message-Id: <20250317-cc-vars-v1-1-25edbadfd054@bootlin.com> References: <20250317-cc-vars-v1-0-25edbadfd054@bootlin.com> In-Reply-To: <20250317-cc-vars-v1-0-25edbadfd054@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=8822; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=EtDIrZupRLjqz4EnVTFCAPQ8L3J7yiPiATUBD/Wo7pE=; b=owEBbQKS/ZANAwAIAdGAQUApo6g2AcsmYgBn2EfXfr59VbypKLOltqi9vAhaFgP3KZYqM0KC6 e+E9beJx02JAjMEAAEIAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCZ9hH1wAKCRDRgEFAKaOo NleKEACIlucIhEPd49gBLdvK0v4uGsKRsCsFYRkN8QWn8zZVdLQKHvXIAARuhRx9N2tp8V2h6vn QJjLhC6ZPPfXQBhuHa04irnfWWj4H1e/AAmOsoz2ynFeoscV7r4ood4HfvxOcyTe8KEgJYantBo ZBTTpOgQos7o+NrTxEOuYUyNcL+xeSPcWfpgHeHGfAkd6BBN0Wcj+Eaq9dfgakDvmp2ZC6FDmfF 02jV8YcSIx1iZj657HwGOPSJbDwrs4tOajXeR2V0PtSAIYiBu1MRDZY7bw3wHIdZVz0SIc2/49S cMz3BsP27DvHJ63aO/H4PeacPEYPUEg3yZKb5JzRZ+3nuXM7frlHFYM9t/NePkDuMfs/Dfqhb55 KEOQvz13/ddyxz2HY5MjOahyJYYcJKNh1Gi3I2gvqHIDsqiepd5+p4+T02YuKauyjeI1viC488l SoX62uLcNojW0T5GkyEM/8FO+BREIrJbbfAbxSbH8sMhUxRHZS6Y+/uTFW9KB22THRqa+p82Ue7 ECKUg3O4vucpeGbBT6FM9yd3fdQYocEIpI7u+SMGLiy7zaCYX5owTQLF0e8kL6bRzW1FxSucpb8 OQNBy/+UZpZBULANYp1Y1Q3OK8kuErfL0TV7OHkAYi1qNaTPALEYN47HCvapen/oFAmC2/dU4iK muligD8g9k7yWEA== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-GND-State: clean X-GND-Score: -100 X-GND-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddufeelleegucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecuifetpfffkfdpucggtfgfnhhsuhgsshgtrhhisggvnecuuegrihhlohhuthemuceftddunecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjughrpefhfffugggtgffkfhgjvfevofesthejredtredtjeenucfhrhhomheptehnthhonhhinhcuifhouggrrhguuceorghnthhonhhinhdrghhouggrrhgusegsohhothhlihhnrdgtohhmqeenucggtffrrghtthgvrhhnpeehieeguefhfeegheffgfeuieetheeileefheejkeetgfekueehueeluddvlefghfenucfkphepvdgrtddumegtsgdugeemheehieemjegrtddtmeejtgehtgemiegruggvmeejleegkeemgedtheelnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehinhgvthepvdgrtddumegtsgdugeemheehieemjegrtddtmeejtgehtgemiegruggvmeejleegkeemgedtheelpdhhvghloheplgduvdejrddtrddurddungdpmhgrihhlfhhrohhmpegrnhhtohhnihhnrdhgohgurghrugessghoohhtlhhinhdrtghomhdpnhgspghrtghpthhtohepfedprhgtphhtthhopeguohgtsheslhhishhtshdrhihotghtohhprhhojhgvtghtrdhorhhgpdhrtghpthhtohepthhhohhmrghsrdhpvghtrgiiiihonhhisegsohhothhlihhnrdgtohhmpdhrtghpthhtoheprghnthhonhhinhdrghhouggrrhgusegso hhothhlihhnrdgtohhm X-GND-Sasl: antonin.godard@bootlin.com List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 17 Mar 2025 16:03:40 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/6578 These toolchain variables are used in a native context. Some of the BUILD_* variables missed documentation. Also, some of the base commands were also not there so document them (FC and READELF). Some of existing BUILD_* variable documentation were missing the note about their usage in a native context, so add it too so that all BUILD_* variables are documented the same way. [YOCTO #15719] Signed-off-by: Antonin Godard --- documentation/ref-manual/variables.rst | 107 +++++++++++++++++++++++++ 1 file changed, 107 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 861b04eaa..24b3f7db9 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -985,6 +985,24 @@ system and gives an overview of their function and contents. variable is a useful pointer in case a bug in the software being built needs to be manually reported. + :term:`BUILD_AR` + Specifies the architecture-specific archiver for the build host, + derived in part from :term:`BUILD_PREFIX`:: + + BUILD_AR = "${BUILD_PREFIX}ar" + + When building in the ``-native`` context, :term:`AR` is set to the value + of this variable by default. + + :term:`BUILD_AS` + Specifies the architecture-specific assembler for the build host, + derived in part from from :term:`BUILD_PREFIX`:: + + BUILD_AS = "${BUILD_PREFIX}ar" + + When building in the ``-native`` context, :term:`AS` is set to the value + of this variable by default. + :term:`BUILD_ARCH` Specifies the architecture of the build host (e.g. ``i686``). The OpenEmbedded build system sets the value of :term:`BUILD_ARCH` from the @@ -994,6 +1012,15 @@ system and gives an overview of their function and contents. Specifies the architecture-specific assembler flags for the build host. By default, the value of :term:`BUILD_AS_ARCH` is empty. + :term:`BUILD_CC` + Specifies the architecture-specific C compiler for the build host, + derived in part from :term:`BUILD_PREFIX` and :term:`BUILD_CC_ARCH`:: + + BUILD_CC = "${CCACHE}${BUILD_PREFIX}gcc ${BUILD_CC_ARCH}" + + When building in the ``-native`` context, :term:`CC` is set to the value + of this variable by default. + :term:`BUILD_CC_ARCH` Specifies the architecture-specific C compiler flags for the build host. By default, the value of :term:`BUILD_CC_ARCH` is empty. @@ -1011,12 +1038,31 @@ system and gives an overview of their function and contents. :term:`CFLAGS` is set to the value of this variable by default. + :term:`BUILD_CPP` + Specifies the C preprocessor command (to both the C and the C++ compilers) + when building for the build host, derived in part from + :term:`BUILD_PREFIX` and :term:`BUILD_CC_ARCH`:: + + BUILD_CPP = "${BUILD_PREFIX}gcc ${BUILD_CC_ARCH} -E" + + When building in the ``-native`` context, :term:`CPP` is set to the value + of this variable by default. + :term:`BUILD_CPPFLAGS` Specifies the flags to pass to the C preprocessor (i.e. to both the C and the C++ compilers) when building for the build host. When building in the ``-native`` context, :term:`CPPFLAGS` is set to the value of this variable by default. + :term:`BUILD_CXX` + Specifies the architecture-specific C++ compiler for the build host, + derived in part from :term:`BUILD_PREFIX` and :term:`BUILD_CC_ARCH`:: + + BUILD_CXX = "${CCACHE}${BUILD_PREFIX}g++ ${BUILD_CC_ARCH}" + + When building in the ``-native`` context, :term:`CXX` is set to the value + of this variable by default. + :term:`BUILD_CXXFLAGS` Specifies the flags to pass to the C++ compiler when building for the build host. When building in the ``-native`` context, @@ -1029,12 +1075,18 @@ system and gives an overview of their function and contents. value of :term:`BUILD_CC_ARCH`, assuming :term:`BUILD_CC_ARCH` is set. + When building in the ``-native`` context, :term:`FC` is set to the value + of this variable by default. + :term:`BUILD_LD` Specifies the linker command for the build host. By default, :term:`BUILD_LD` points to the GNU linker (ld) and passes as arguments the value of :term:`BUILD_LD_ARCH`, assuming :term:`BUILD_LD_ARCH` is set. + When building in the ``-native`` context, :term:`LD` is set to the value + of this variable by default. + :term:`BUILD_LD_ARCH` Specifies architecture-specific linker flags for the build host. By default, the value of :term:`BUILD_LD_ARCH` is empty. @@ -1045,6 +1097,34 @@ system and gives an overview of their function and contents. :term:`LDFLAGS` is set to the value of this variable by default. + :term:`BUILD_NM` + Specifies the architecture-specific utility to list symbols from object + files for the build host, derived in part from :term:`BUILD_PREFIX`:: + + BUILD_NM = "${BUILD_PREFIX}nm" + + When building in the ``-native`` context, :term:`NM` is set to the + value of this variable by default. + + :term:`BUILD_OBJCOPY` + Specifies the architecture-specific utility to copy object files for the + build host, derived in part from :term:`BUILD_PREFIX`:: + + BUILD_OBJCOPY = "${BUILD_PREFIX}objcopy" + + When building in the ``-native`` context, :term:`OBJCOPY` is set to the + value of this variable by default. + + :term:`BUILD_OBJDUMP` + Specifies the architecture-specific utility to display object files + information for the build host, derived in part from + :term:`BUILD_PREFIX`:: + + BUILD_OBJDUMP = "${BUILD_PREFIX}objdump" + + When building in the ``-native`` context, :term:`OBJDUMP` is set to the + value of this variable by default. + :term:`BUILD_OPTIMIZATION` Specifies the optimization flags passed to the C compiler when building for the build host or the SDK. The flags are passed through @@ -1065,12 +1145,33 @@ system and gives an overview of their function and contents. build system uses the :term:`BUILD_PREFIX` value to set the :term:`TARGET_PREFIX` when building for :ref:`ref-classes-native` recipes. + :term:`BUILD_RANLIB` + Specifies the architecture-specific utility to generate indexes for + archives for the build host, derived in part from :term:`BUILD_PREFIX`:: + + BUILD_RANLIB = "${BUILD_PREFIX}ranlib -D" + + When building in the ``-native`` context, :term:`RANLIB` is set to the + value of this variable by default. + + :term:`BUILD_READELF` + Specifies the architecture-specific utility to display information about + ELF files for the build host, derived in part from :term:`BUILD_PREFIX`:: + + BUILD_READELF = "${BUILD_PREFIX}readelf" + + When building in the ``-native`` context, :term:`READELF` is set to the + value of this variable by default. + :term:`BUILD_STRIP` Specifies the command to be used to strip debugging symbols from binaries produced for the build host. By default, :term:`BUILD_STRIP` points to ``${``\ :term:`BUILD_PREFIX`\ ``}strip``. + When building in the ``-native`` context, :term:`STRIP` is set to the + value of this variable by default. + :term:`BUILD_SYS` Specifies the system, including the architecture and the operating system, to use when building for the build host (i.e. when building @@ -2818,6 +2919,9 @@ system and gives an overview of their function and contents. :term:`FAKEROOTNOENV` See :term:`bitbake:FAKEROOTNOENV` in the BitBake manual. + :term:`FC` + The minimal command and arguments used to run the Fortran compiler. + :term:`FEATURE_PACKAGES` Defines one or more packages to include in an image when a specific item is included in :term:`IMAGE_FEATURES`. @@ -7289,6 +7393,9 @@ system and gives an overview of their function and contents. ":ref:`bitbake-user-manual/bitbake-user-manual-execution:dependencies`" sections in the BitBake User Manual for additional information on tasks and dependencies. + :term:`READELF` + The minimal command and arguments to run ``readelf``. + :term:`RECIPE_MAINTAINER` This variable defines the name and e-mail address of the maintainer of a recipe. Such information can be used by human users submitted changes, From patchwork Mon Mar 17 16:03:29 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 59270 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id EA23EC35FF9 for ; Mon, 17 Mar 2025 16:03:40 +0000 (UTC) Received: from relay9-d.mail.gandi.net (relay9-d.mail.gandi.net [217.70.183.199]) by mx.groups.io with SMTP id smtpd.web11.56739.1742227418555801847 for ; Mon, 17 Mar 2025 09:03:38 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=kgio8UjL; spf=pass (domain: bootlin.com, ip: 217.70.183.199, mailfrom: antonin.godard@bootlin.com) Received: by mail.gandi.net (Postfix) with ESMTPSA id E7602442C2; Mon, 17 Mar 2025 16:03:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1742227417; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=q7/sQFsuWoMTeeSlApZBNfiJuDmacThmPuxifftSBg4=; b=kgio8UjL5NwP3HeTj56O9nlJPXgOpEVdEVut8RMEdJD8QHv3weKkjv8zYHFUpIXTZ1Cizb ScWNZaKe5x2BvD8Gn3pDJYk6gvRtepukCqBBB15JFfMdq3+Sn3VlTqMmfv4u1vm7f6go9d hW/R99nBvZq2WDUipB6D+bevqHkS4Z7D2iZHlDDNz6ipMpbgJjii/eNZIR/uJfGFlUWDLg V+8U+w1bpwarJEHZx23XPlrDXQKcgYSeY8GxQ3tF6Q0nbugkW9oLG6VEcc7WkXjDBnzsxN KKjGqTwrRF8uf6V4AyMMS3nN8cJogUg1NZbZTf8UZCgBSxBkli0mLYRN018WpA== From: Antonin Godard Date: Mon, 17 Mar 2025 17:03:29 +0100 Subject: [PATCH 2/4] ref-manual/variables.rst: document missing SDK_*_ARCH variables MIME-Version: 1.0 Message-Id: <20250317-cc-vars-v1-2-25edbadfd054@bootlin.com> References: <20250317-cc-vars-v1-0-25edbadfd054@bootlin.com> In-Reply-To: <20250317-cc-vars-v1-0-25edbadfd054@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2171; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=DCMW5VhBW1qZM1zF5IGcK1Q9nWjGoSoyXnjsUcS22z4=; b=owEBbQKS/ZANAwAIAdGAQUApo6g2AcsmYgBn2EfXXBXFWzq7lWRgeUUnHHy7UmYtdXlftybaO HJC+ISxoKiJAjMEAAEIAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCZ9hH1wAKCRDRgEFAKaOo NkQiEAC2SX7TjqqbIU1zcCy+kyufdQYKE/nWQG2ZQDIYoBriURWX+sxnWMAZQiHVyJFVnMzESYc KqRx9kpQeaSruxFReAcv/wZw0tYvY5zZ4aEzcrssss8TzLTWF0BN8j1e1kHW6hsdW6XsS1p5HEJ 1Di1eHAWaUrCABU/kSGOR3/MO7KyLYz01xzD3TtU4VnzWfo69iv1dyuJmswHCFcCxJJ+HgKqL+A PqCAmmC/rxtE5w/A2BpsFbMLsDVtHTz9dIw8FQGxwJpq6zyFfcRDYqEajYhJ7OnAxmqjpTaXG7o 5NCUX/MJ8WeUBlo/op4kHhutnob1rOgTRKRu5F928RTAetw3fcBrW1torV9Eco0unG7nWVLyIyd +R9VvgWCqbhWSdRbiixKGlhpjVHGsq82PKQeULKiISorZlbnajuUq0F9A4688BDEdm3HeMwB6xS ja26kAieR6nTViqX9pANLrurk7PjVSdUIqrMPPPBpPHku8tTMUTJN98tZVWp9wFTHwDDZczw0Vg E0kE3n4M4b/i+G8FxJk4At7edkkvkgNYhoREK+p5PGhuDx/pOTSh4/UFwQAuQGeSC0hOsnbqXao x60hyJ1RzR1//Gg67ARMrxjb+gvNncM+QUtAjhVkg8t8WCxmsZ3b7/ToEH/Lo8/gfpUFf9rSZ65 iR+I0Pm2PB48M3A== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-GND-State: clean X-GND-Score: -100 X-GND-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddufeelleegucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecuifetpfffkfdpucggtfgfnhhsuhgsshgtrhhisggvnecuuegrihhlohhuthemuceftddunecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjughrpefhfffugggtgffkfhgjvfevofesthejredtredtjeenucfhrhhomheptehnthhonhhinhcuifhouggrrhguuceorghnthhonhhinhdrghhouggrrhgusegsohhothhlihhnrdgtohhmqeenucggtffrrghtthgvrhhnpeehieeguefhfeegheffgfeuieetheeileefheejkeetgfekueehueeluddvlefghfenucfkphepvdgrtddumegtsgdugeemheehieemjegrtddtmeejtgehtgemiegruggvmeejleegkeemgedtheelnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehinhgvthepvdgrtddumegtsgdugeemheehieemjegrtddtmeejtgehtgemiegruggvmeejleegkeemgedtheelpdhhvghloheplgduvdejrddtrddurddungdpmhgrihhlfhhrohhmpegrnhhtohhnihhnrdhgohgurghrugessghoohhtlhhinhdrtghomhdpnhgspghrtghpthhtohepfedprhgtphhtthhopeguohgtsheslhhishhtshdrhihotghtohhprhhojhgvtghtrdhorhhgpdhrtghpthhtohepthhhohhmrghsrdhpvghtrgiiiihonhhisegsohhothhlihhnrdgtohhmpdhrtghpthhtoheprghnthhonhhinhdrghhouggrrhgusegso hhothhlihhnrdgtohhm X-GND-Sasl: antonin.godard@bootlin.com List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 17 Mar 2025 16:03:40 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/6580 These variables control the flags for the assembler, compiler and linker when building for nativesdk recipes. Signed-off-by: Antonin Godard --- documentation/ref-manual/variables.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 24b3f7db9..4063fda8c 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -7793,11 +7793,21 @@ system and gives an overview of their function and contents. Only one archive type can be specified. + :term:`SDK_AS_ARCH` + Specifies architecture-specific assembler flags when building + :ref:`ref-classes-nativesdk` recipes. By default, the value of + :term:`SDK_AS_ARCH` equals the one of :term:`BUILD_AS_ARCH`. + :term:`SDK_BUILDINFO_FILE` When using the :ref:`ref-classes-image-buildinfo` class, specifies the file in the SDK to write the build information into. The default value is "``/buildinfo``". + :term:`SDK_CC_ARCH` + Specifies the architecture-specific C compiler flags when building + :ref:`ref-classes-nativesdk` recipes. By default, the value of + :term:`SDK_CC_ARCH` equals the one of :term:`BUILD_CC_ARCH`. + :term:`SDK_CUSTOM_TEMPLATECONF` When building the extensible SDK, if :term:`SDK_CUSTOM_TEMPLATECONF` is set to "1" and a ``conf/templateconf.cfg`` file exists in the :term:`Build Directory` @@ -7879,6 +7889,11 @@ system and gives an overview of their function and contents. :term:`SDK_EXT_TYPE` is set to "minimal", and defaults to "1" if :term:`SDK_EXT_TYPE` is set to "full". + :term:`SDK_LD_ARCH` + Specifies architecture-specific linker flags when building + :ref:`ref-classes-nativesdk` recipes. By default, the value of + :term:`SDK_LD_ARCH` equals the one of :term:`BUILD_LD_ARCH`. + :term:`SDK_NAME` The base name for SDK output files. The default value (as set in ``meta-poky/conf/distro/poky.conf``) is derived from the From patchwork Mon Mar 17 16:03:30 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 59271 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id F02D5C35FFB for ; Mon, 17 Mar 2025 16:03:40 +0000 (UTC) Received: from relay9-d.mail.gandi.net (relay9-d.mail.gandi.net [217.70.183.199]) by mx.groups.io with SMTP id smtpd.web10.56548.1742227418537936722 for ; Mon, 17 Mar 2025 09:03:38 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=YMdhpOYj; spf=pass (domain: bootlin.com, ip: 217.70.183.199, mailfrom: antonin.godard@bootlin.com) Received: by mail.gandi.net (Postfix) with ESMTPSA id 2909C4429D; Mon, 17 Mar 2025 16:03:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1742227417; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=mt3d6Z//Inxrdh0uqCvowdvLiJIEBbqHj5dOJJ5/U+s=; b=YMdhpOYjCzXw/cIzZABfesWwxeOTNnArVwDzac7MUIjpe+MpEf8wBYSabN5DMmWFJEAu8a qZk+vNESqvkWMPLwZ0jrvBWo8ONkdL22F9ovUq6XiJE/JDeyEgFPKyVsD0Rf8FvWJCwZPk P4/pfNScqvk9clHL0yO6RTho+Ik8nJc9/0OfIxoRKBjly2twsFiVi9l+FrXHkOlix5Dc8W F942+1PjisXXy0iytFwHFqOMwBjJdMmtom8fXG3j4V4a8C3C9IV9C5mKyvXEK6cBd/AYp4 PnKD0YU7zqgTlz3rA00E+MFTpN92QoTZVQ8PgNpr30bTSixiplEmt8AxcUHRFA== From: Antonin Godard Date: Mon, 17 Mar 2025 17:03:30 +0100 Subject: [PATCH 3/4] ref-manual/variables.rst: document HOST_*_ARCH variables MIME-Version: 1.0 Message-Id: <20250317-cc-vars-v1-3-25edbadfd054@bootlin.com> References: <20250317-cc-vars-v1-0-25edbadfd054@bootlin.com> In-Reply-To: <20250317-cc-vars-v1-0-25edbadfd054@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1984; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=xIrTn0ZA9X2x8BZLTPWfPgav6jaLFba8ByPKCIVSlmc=; b=owEBbQKS/ZANAwAIAdGAQUApo6g2AcsmYgBn2EfXTGFg57Z0ZS2O0xDxQkQC+j/XHske4wuwg nkjuomR7LCJAjMEAAEIAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCZ9hH1wAKCRDRgEFAKaOo Nm9uEACiwL6ndyT9u1xmsiPP1EoI2Acc4zvmbqshMILC6aBY0y2D8S/bZcVF4zrTNxByuXXXVTz NcWKFuM3gw7WymoOJMOVTQyGQDVFMKq5DWdYAxLzLudhO+PQ52GSN//hrMOqsepKqnqzavixddt JXvPFS3HG6AK2Gex9IUzvslgWsJLu0X0yaLZWCDbRvgifLSxlp2XjZxp0wtVy4q/l80yWn4SI82 lMVfDFh/AgKb2EnWeW4T+44jlNgJIpq5IVCTSHW/9Aei20AAT/LzRwSI6u+bclrOsHZt/lV8W5n hvb/nJt2WaKCM82P9rS/YVyYstarmo7VHHPgJlaHhw0pzjBP2B+9RKjRyZZNSqrPhg3nmK8yPId 7OWUtfikW4ssgkb8BwW3HqEEEpSYfMIY4rcSNaYtRZai2ySOZeJ7+AMcuV8azuSrMo9I3xzW427 gO+MuCEyjGM4l222muzzXqmWA5O4mq1zg73bIuBk4mgz0WijYnTPQ3DbFfIHPY5cYNIQwBm2IPO PoRqWymqdfS19WKd/ITQZhpI3mOClpsQvwvtOZvP6b/TtrpYgTPdOf/ggUE/USVgmFLbowZ0z5b cu6KML1crZ8Lv7+JZ9MPebd3bhLRtDmINXF3CunL/sw9wCJPnDIRAa2TZ5rjxvFI/MHp+TjRGtN l96sVNPQ5hvNrJg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-GND-State: clean X-GND-Score: -100 X-GND-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddufeelleegucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecuifetpfffkfdpucggtfgfnhhsuhgsshgtrhhisggvnecuuegrihhlohhuthemuceftddunecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjughrpefhfffugggtgffkfhgjvfevofesthejredtredtjeenucfhrhhomheptehnthhonhhinhcuifhouggrrhguuceorghnthhonhhinhdrghhouggrrhgusegsohhothhlihhnrdgtohhmqeenucggtffrrghtthgvrhhnpeehieeguefhfeegheffgfeuieetheeileefheejkeetgfekueehueeluddvlefghfenucfkphepvdgrtddumegtsgdugeemheehieemjegrtddtmeejtgehtgemiegruggvmeejleegkeemgedtheelnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehinhgvthepvdgrtddumegtsgdugeemheehieemjegrtddtmeejtgehtgemiegruggvmeejleegkeemgedtheelpdhhvghloheplgduvdejrddtrddurddungdpmhgrihhlfhhrohhmpegrnhhtohhnihhnrdhgohgurghrugessghoohhtlhhinhdrtghomhdpnhgspghrtghpthhtohepfedprhgtphhtthhopeguohgtsheslhhishhtshdrhihotghtohhprhhojhgvtghtrdhorhhgpdhrtghpthhtohepthhhohhmrghsrdhpvghtrgiiiihonhhisegsohhothhlihhnrdgtohhmpdhrtghpthhtoheprghnthhonhhinhdrghhouggrrhgusegso hhothhlihhnrdgtohhm X-GND-Sasl: antonin.godard@bootlin.com List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 17 Mar 2025 16:03:40 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/6579 These variables control the flags for the assembler, compiler and linker, but depend on the context. Signed-off-by: Antonin Godard --- documentation/ref-manual/variables.rst | 27 ++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 4063fda8c..f339e409e 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -3547,6 +3547,20 @@ system and gives an overview of their function and contents. - mips - mipsel + :term:`HOST_AS_ARCH` + Specifies architecture-specific assembler flags. + + Default initialization for :term:`HOST_AS_ARCH` varies depending on what + is being built: + + - :term:`TARGET_AS_ARCH` when building for the + target + + - :term:`BUILD_AS_ARCH` when building for the build host (i.e. + ``-native``) + + - :term:`SDK_AS_ARCH` when building for an SDK (i.e. ``nativesdk-``) + :term:`HOST_CC_ARCH` Specifies architecture-specific compiler flags that are passed to the C compiler. @@ -3563,6 +3577,19 @@ system and gives an overview of their function and contents. - ``BUILDSDK_CC_ARCH`` when building for an SDK (i.e. ``nativesdk-``) + :term:`HOST_LD_ARCH` + Specifies architecture-specific linker flags. + + Default initialization for :term:`HOST_LD_ARCH` varies depending on what + is being built: + + - :term:`TARGET_LD_ARCH` when building for the target + + - :term:`BUILD_LD_ARCH` when building for the build host (i.e. + ``-native``) + + - :term:`SDK_LD_ARCH` when building for an SDK (i.e. ``nativesdk-``) + :term:`HOST_OS` Specifies the name of the target operating system, which is normally the same as the :term:`TARGET_OS`. The variable can From patchwork Mon Mar 17 16:03:31 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 59268 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id D0E97C282EC for ; Mon, 17 Mar 2025 16:03:40 +0000 (UTC) Received: from relay9-d.mail.gandi.net (relay9-d.mail.gandi.net [217.70.183.199]) by mx.groups.io with SMTP id smtpd.web11.56740.1742227418810984131 for ; Mon, 17 Mar 2025 09:03:39 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=LE82Rn4p; spf=pass (domain: bootlin.com, ip: 217.70.183.199, mailfrom: antonin.godard@bootlin.com) Received: by mail.gandi.net (Postfix) with ESMTPSA id 578EE442C4; Mon, 17 Mar 2025 16:03:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1742227417; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=l6EsDcD3JPw5lC/Av0rz19Shbtf0s1bHb/DHOPHIUQ4=; b=LE82Rn4pNbhpAvdZ68Gf6ALjkC77ul2CSakgs8Jyd6DSQEQhm2Ywl2177hmK7U43PjEi0j TAo2ARAV7lUkdDcYPvNzhlTYVtCq5lb8zu4jYsRGZWLS5NycjZtWXWzZNV7xohF8qhLJmq DSqT/DtWuskOFLNfEdNL5AX9riTxzdkkiQnRQ9nTDpRyP7yTnQtPY7oYIDuQH5QjyBAYl4 N9ao9496WU08fV1Q4NcKIPcrZ05fUyAo6rin/42zKBIHjpcoU9uy39+K+cusTVwh2Eo9Xz AdYRwjfm/K72SnW0kCtswueKLiezHSDu7ci5rRkGYVDCygrGmUNwP0oi0bfpqg== From: Antonin Godard Date: Mon, 17 Mar 2025 17:03:31 +0100 Subject: [PATCH 4/4] ref-manual/variables.rst: HOST_CC_ARCH: fix wrong SDK reference MIME-Version: 1.0 Message-Id: <20250317-cc-vars-v1-4-25edbadfd054@bootlin.com> References: <20250317-cc-vars-v1-0-25edbadfd054@bootlin.com> In-Reply-To: <20250317-cc-vars-v1-0-25edbadfd054@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=951; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Qujd9CTL3Yel8pO9+XM9lOCqvRx+08paUmOf6m95EsY=; b=owEBbQKS/ZANAwAIAdGAQUApo6g2AcsmYgBn2EfYGdSjzB9JcRmNXXl1Ir7h2OzCCf+MIEo6X iB4kPZCyEWJAjMEAAEIAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCZ9hH2AAKCRDRgEFAKaOo NjLtEAC28C6o3afAfI7Cl1EzNiGaOnhl/e4QF4PpDckskLUDqp9BPtZ2bN5ArY2UXkjnM1rgJ+V gDy0hTjSu7nZ1DBw2qbX0qyZbDAgAs9wNaE3CscyJldJpAMIaykxQ4Dk/l/7Kd0AxvoqOArRGma 6M8Vt3MhWO8iW7xgkAogB9frq5JtKXOa9dsBQvjfeMCr/MyAHzbJWwOqWW74h69WXASNd1Kwg6R jGyj94M5+reMkwHdK77WE9L5N2dyDWCXI6dOwJAy/PgRc9mILYsG0URhnls3zD27omvX0iODu6v AiWvhhXSCfbuXTl18HpTGmh7FKkncjAZZXGzy9esAsJAayuAzNP1F8QdU1XkXHtAuOHfIoKLAZ2 UGU8Kty6+ns5ZbNTNWMuWpWi/nKnztIniWn3j9bMWazPWgEREVxvuSWRf4HYL02nOldx05f5weh 0ls/I7Zi1yQ/5SzeJxu8MgE8Fy59+CjGJSZROG8uXqiNHWTr1uQooKDBrx0B+MHh10nRi4h5hRb 6A1R/NMw7JBBGoCaMnsDEG8dLoIslCWH6wSbs8K7CIBUZ7dKuQUDRHYuXeVEHQjzwEEAjvwzYr1 58ZnaMBb6HFLwJ6iqAFkozdEfaawtH1DIdItGgxM8jUsYcPvnYFMHVttusp81rhn/cS2xXQRBty 1LVuiQZ98eFJVWg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-GND-State: clean X-GND-Score: -100 X-GND-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddufeelleegucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecuifetpfffkfdpucggtfgfnhhsuhgsshgtrhhisggvnecuuegrihhlohhuthemuceftddunecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjughrpefhfffugggtgffkfhgjvfevofesthejredtredtjeenucfhrhhomheptehnthhonhhinhcuifhouggrrhguuceorghnthhonhhinhdrghhouggrrhgusegsohhothhlihhnrdgtohhmqeenucggtffrrghtthgvrhhnpeehieeguefhfeegheffgfeuieetheeileefheejkeetgfekueehueeluddvlefghfenucfkphepvdgrtddumegtsgdugeemheehieemjegrtddtmeejtgehtgemiegruggvmeejleegkeemgedtheelnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehinhgvthepvdgrtddumegtsgdugeemheehieemjegrtddtmeejtgehtgemiegruggvmeejleegkeemgedtheelpdhhvghloheplgduvdejrddtrddurddungdpmhgrihhlfhhrohhmpegrnhhtohhnihhnrdhgohgurghrugessghoohhtlhhinhdrtghomhdpnhgspghrtghpthhtohepfedprhgtphhtthhopeguohgtsheslhhishhtshdrhihotghtohhprhhojhgvtghtrdhorhhgpdhrtghpthhtohepthhhohhmrghsrdhpvghtrgiiiihonhhisegsohhothhlihhnrdgtohhmpdhrtghpthhtoheprghnthhonhhinhdrghhouggrrhgusegso hhothhlihhnrdgtohhm X-GND-Sasl: antonin.godard@bootlin.com List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 17 Mar 2025 16:03:40 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/6582 When building for nativesdk recipes, HOST_CC_ARCH equals SDK_CC_ARCH, not BUILDSDK_CC_ARCH which doesn't exist. Signed-off-by: Antonin Godard --- documentation/ref-manual/variables.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index f339e409e..20f78a7ab 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -3574,8 +3574,7 @@ system and gives an overview of their function and contents. - :term:`BUILD_CC_ARCH` when building for the build host (i.e. ``-native``) - - ``BUILDSDK_CC_ARCH`` when building for an SDK (i.e. - ``nativesdk-``) + - :term:`SDK_CC_ARCH` when building for an SDK (i.e. ``nativesdk-``) :term:`HOST_LD_ARCH` Specifies architecture-specific linker flags.