From patchwork Wed Feb 11 18:06:20 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Quentin Schulz X-Patchwork-Id: 80923 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 D9240ECD6DC for ; Wed, 11 Feb 2026 18:06:38 +0000 (UTC) Received: from smtp-1909.mail.infomaniak.ch (smtp-1909.mail.infomaniak.ch [185.125.25.9]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.25755.1770833191606167711 for ; Wed, 11 Feb 2026 10:06:32 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@0leil.net header.s=20231125 header.b=KcHP/tDE; spf=pass (domain: 0leil.net, ip: 185.125.25.9, mailfrom: foss+yocto@0leil.net) Received: from smtp-4-0000.mail.infomaniak.ch (smtp-4-0000.mail.infomaniak.ch [10.7.10.107]) by smtp-4-3000.mail.infomaniak.ch (Postfix) with ESMTPS id 4fB5wQ1FMpzB3M; Wed, 11 Feb 2026 19:06:30 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=0leil.net; s=20231125; t=1770833190; bh=L6H1tw62hGL2vdwemXZyjMbUMe2jbN/HpT66YshS+1A=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=KcHP/tDEMYYp0nDo7zisAUi896xoFN/IoRej639ufU+KCdcw+Cp2b7MwAk6jBSv85 NuBAdFGFDHOqQHyI+agB9YqejXFAIx+utt/cwmh2g7f9qa9IF5P9zwJDxw/ZU/5MF/ DjdYN0mqRP4JmSurH6BIHRFK9Ev/syoZVbCvHZvzr47kPQ/fvzEVyGDIyvTdqhoCq0 NtpC2eQJIuHLF6GvZOPmduvBjALSG89sf5ZwlV7MqKK9t6yWj7becJqdpMzI9k+rzB 0VqFSgS1Hirm75SW8rpaprSCFLzzab0Cvl5rbhsKIAEAos9fWCu7ijXK14cAdKJD7y 4ZR/7RMJrh/lA== Received: from unknown by smtp-4-0000.mail.infomaniak.ch (Postfix) with ESMTPA id 4fB5wP4b84zcfC; Wed, 11 Feb 2026 19:06:29 +0100 (CET) From: Quentin Schulz Date: Wed, 11 Feb 2026 19:06:20 +0100 Subject: [PATCH 1/4] doc: bitbake-user-manual-ref-variables: clarify BBMASK directory matching MIME-Version: 1.0 Message-Id: <20260211-bbmask-slashes-v1-1-b72161c647ef@cherry.de> References: <20260211-bbmask-slashes-v1-0-b72161c647ef@cherry.de> In-Reply-To: <20260211-bbmask-slashes-v1-0-b72161c647ef@cherry.de> To: bitbake-devel@lists.openembedded.org Cc: "Robert P. J. Day" , docs@lists.yoctoproject.org, Quentin Schulz X-Mailer: b4 0.15-dev-47773 X-Infomaniak-Routing: alpha List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 11 Feb 2026 18:06:38 -0000 X-Groupsio-URL: https://lists.openembedded.org/g/bitbake-devel/message/19009 From: Quentin Schulz BBMASK matches files in the directories matching the regex, and also in their respective subdirectories, so make that clear in the wording leading to the example. Signed-off-by: Quentin Schulz --- doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst index 4b3b10d46..18bbd638d 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst @@ -1051,8 +1051,8 @@ overview of their function and contents. documentation at http://docs.python.org/3/library/re.html. The following example uses a complete regular expression to tell - BitBake to ignore all recipe and recipe append files in the - ``meta-ti/recipes-misc/`` directory:: + BitBake to ignore all recipe and recipe append files in + ``meta-ti/recipes-misc/`` directories (and their subdirectories):: BBMASK = "meta-ti/recipes-misc/" From patchwork Wed Feb 11 18:06:21 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Quentin Schulz X-Patchwork-Id: 80924 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 01FF1ECD6E0 for ; Wed, 11 Feb 2026 18:06:39 +0000 (UTC) Received: from smtp-190d.mail.infomaniak.ch (smtp-190d.mail.infomaniak.ch [185.125.25.13]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.25478.1770833192708117228 for ; Wed, 11 Feb 2026 10:06:33 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@0leil.net header.s=20231125 header.b=YpijehKQ; spf=pass (domain: 0leil.net, ip: 185.125.25.13, mailfrom: foss+yocto@0leil.net) Received: from smtp-4-0000.mail.infomaniak.ch (unknown [IPv6:2001:1600:7:10::a6b]) by smtp-4-3000.mail.infomaniak.ch (Postfix) with ESMTPS id 4fB5wQ5l9pzC22; Wed, 11 Feb 2026 19:06:30 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=0leil.net; s=20231125; t=1770833190; bh=WSXc47pUNY65BTpch+5vXCYfACEp0V2Dos511v5FpL0=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=YpijehKQqqsTeEppGZ2ZldRrEo3fokoHfCxFp3zVG6rXwHCI6KSuetwUfuPSn5OvV u75rkBpbcKSPV8sHFuvhVJFpYIWSjkrQEjyoDJtDHib6cMsmdgZ6obuxVbzcTWSUUR FTTmEachBg2sKbz78j0kXPNombOgPcW8HZU4JxBJwfr+Nxm7/6XISEzWUmTxr9qr2y 6MMOOy+DbVFNXKo8yJ8Zmg50MwTAbVNDx7r8j7jLO2CH5KDXLRTghBeirr32m0mSt9 +QfUJLKivpomiAR0l2+YsHPJpZp8/Ih3FCsO6Dag5iA2Ac5QyefHApXDwj0CN5KQPE aba7NrsbjeBGQ== Received: from unknown by smtp-4-0000.mail.infomaniak.ch (Postfix) with ESMTPA id 4fB5wQ1q5dzgcn; Wed, 11 Feb 2026 19:06:30 +0100 (CET) From: Quentin Schulz Date: Wed, 11 Feb 2026 19:06:21 +0100 Subject: [PATCH 2/4] doc: bitbake-user-manual-ref-variables: have directory examples be consistent MIME-Version: 1.0 Message-Id: <20260211-bbmask-slashes-v1-2-b72161c647ef@cherry.de> References: <20260211-bbmask-slashes-v1-0-b72161c647ef@cherry.de> In-Reply-To: <20260211-bbmask-slashes-v1-0-b72161c647ef@cherry.de> To: bitbake-devel@lists.openembedded.org Cc: "Robert P. J. Day" , docs@lists.yoctoproject.org, Quentin Schulz X-Mailer: b4 0.15-dev-47773 X-Infomaniak-Routing: alpha List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 11 Feb 2026 18:06:38 -0000 X-Groupsio-URL: https://lists.openembedded.org/g/bitbake-devel/message/19010 From: Quentin Schulz It's a bit confusing to have a mix of paths with and without a leading slash. The behavior is actually different. The next commit will explain when/why to add a leading slash. Reported-by: Robert P. J. Day Signed-off-by: Quentin Schulz --- doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst index 18bbd638d..f20a9012c 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst @@ -1054,13 +1054,13 @@ overview of their function and contents. BitBake to ignore all recipe and recipe append files in ``meta-ti/recipes-misc/`` directories (and their subdirectories):: - BBMASK = "meta-ti/recipes-misc/" + BBMASK = "/meta-ti/recipes-misc/" If you want to mask out multiple directories or recipes, you can specify multiple regular expression fragments. This next example masks out multiple directories and individual recipes:: - BBMASK += "/meta-ti/recipes-misc/ meta-ti/recipes-ti/packagegroup/" + BBMASK += "/meta-ti/recipes-ti/packagegroup/" BBMASK += "/meta-oe/recipes-support/" BBMASK += "/meta-foo/.*/openldap" BBMASK += "opencv.*\.bbappend" From patchwork Wed Feb 11 18:06:22 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Quentin Schulz X-Patchwork-Id: 80925 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 0E902ECD6E4 for ; Wed, 11 Feb 2026 18:06:39 +0000 (UTC) Received: from smtp-190d.mail.infomaniak.ch (smtp-190d.mail.infomaniak.ch [185.125.25.13]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.25757.1770833192712114149 for ; Wed, 11 Feb 2026 10:06:33 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@0leil.net header.s=20231125 header.b=NdodwDyF; spf=pass (domain: 0leil.net, ip: 185.125.25.13, mailfrom: foss+yocto@0leil.net) Received: from smtp-4-0000.mail.infomaniak.ch (smtp-4-0000.mail.infomaniak.ch [10.7.10.107]) by smtp-4-3000.mail.infomaniak.ch (Postfix) with ESMTPS id 4fB5wR2kKCz8kZ; Wed, 11 Feb 2026 19:06:31 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=0leil.net; s=20231125; t=1770833191; bh=WP2DxU/9nzBdnkjibxjUuRGyFd55gkXphqsiHgtKkYY=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=NdodwDyFGfYQIX4Cn+a9FPHqBHMB6SQmZtcZkUqX87jkFEP0M+PgvLDFCThl0XBi7 MyCCVYrGH3IatiVmLnW1DE+pUi+2icIpK5GwHWgpeaCimHHt4sGMHnY5h4y/JyI3eE oMHcNd93HCXu+/pHWpMIf8zqm57zyi9A3FANLV5TKzMoPceshHx2rvFX2DYngqWOQb 6iIY0m0XzvQPCCcqBzsDl/jEhgwnIZA+uEGFnSGGRRe5bjXL96nWtfqBy9Ygx5zee6 SqjVjWJ9X43L1A/CWI5xPwU8j/+UYBTGoj9kHTPHc99p7nlckV9ZQ/qZT7bva7y0t2 bjo32e4lKcNFw== Received: from unknown by smtp-4-0000.mail.infomaniak.ch (Postfix) with ESMTPA id 4fB5wQ69ngzhdp; Wed, 11 Feb 2026 19:06:30 +0100 (CET) From: Quentin Schulz Date: Wed, 11 Feb 2026 19:06:22 +0100 Subject: [PATCH 3/4] doc: bitbake-user-manual-ref-variables: clarify BBMASK matching patterns MIME-Version: 1.0 Message-Id: <20260211-bbmask-slashes-v1-3-b72161c647ef@cherry.de> References: <20260211-bbmask-slashes-v1-0-b72161c647ef@cherry.de> In-Reply-To: <20260211-bbmask-slashes-v1-0-b72161c647ef@cherry.de> To: bitbake-devel@lists.openembedded.org Cc: "Robert P. J. Day" , docs@lists.yoctoproject.org, Quentin Schulz X-Mailer: b4 0.15-dev-47773 X-Infomaniak-Routing: alpha List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 11 Feb 2026 18:06:39 -0000 X-Groupsio-URL: https://lists.openembedded.org/g/bitbake-devel/message/19011 From: Quentin Schulz The documentation doesn't explain the side-effect of putting a leading slash, only the trailing slash. The leading slash is not for making the regular expression match an absolute path, but to force the match on the directory or file that exactly starts (and ends if there is a trailing slash) with the specified string. Finally, this also explains that this still doesn't prevent more than the intended path to be caught up, specifically because it is NOT a regular expression matching an absolute path. For that though, the user can use BBFILE_PATTERN set for the layer they want to mask the recipe or append files to BitBake. This is typically a regex starting with ^${LAYERDIR}, making it an absolute path matching. Let's document those limitations. Reported-by: Robert P. J. Day Signed-off-by: Quentin Schulz --- .../bitbake-user-manual-ref-variables.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst index f20a9012c..6612dcc03 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst @@ -1071,6 +1071,28 @@ overview of their function and contents. When specifying a directory name, use the trailing slash character to ensure you match just that directory name. + .. note:: + + The leading slash in a regular expression in :term:`BBMASK` does not + mean the path is absolute. It simply forces the directory to be named + exactly that. Take:: + + BBMASK = "meta-ti/recipes-bsp/" + + If you happen to have a directory ``my-meta-ti/recipes-bsp``, it will + be matched. + + Leading with a slash:: + + BBMASK = "/meta-ti/recipes-bsp/" + + makes sure that doesn't happen. However, this doesn't prevent matching a + directory ``meta-foo/meta-ti/recipes-bsp``. For that, use the + appropriate :term:`BBFILE_PATTERN` to only match a directory from one + specific layer:: + + BBMASK = "${BBFILE_PATTERN_meta-ti}/recipes-bsp/" + :term:`BBMULTICONFIG` Enables BitBake to perform multiple configuration builds and lists each separate configuration (multiconfig). You can use this variable From patchwork Wed Feb 11 18:06:23 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Quentin Schulz X-Patchwork-Id: 80926 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 1FA40ECD6E5 for ; Wed, 11 Feb 2026 18:06:39 +0000 (UTC) Received: from smtp-42af.mail.infomaniak.ch (smtp-42af.mail.infomaniak.ch [84.16.66.175]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.25759.1770833193617857991 for ; Wed, 11 Feb 2026 10:06:33 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@0leil.net header.s=20231125 header.b=iIIT0Dk4; spf=pass (domain: 0leil.net, ip: 84.16.66.175, mailfrom: foss+yocto@0leil.net) Received: from smtp-4-0000.mail.infomaniak.ch (unknown [IPv6:2001:1600:7:10::a6b]) by smtp-4-3000.mail.infomaniak.ch (Postfix) with ESMTPS id 4fB5wS0JYhzCGP; Wed, 11 Feb 2026 19:06:32 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=0leil.net; s=20231125; t=1770833191; bh=8yracizhFTpk2jwkZvN9xVDFHx4zIygI4BovBEUAn3Q=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=iIIT0Dk47OSF3OOTKS5RFQNTDV90hKG7XOrlWTvqnUbu4YvB/PjjhAwijgyWYRXMI IbxMdru2gg2mnvVVj7P2llVJkbvZ+7Cak/qvsxoI+2FUGyFwlTmejwCj16rftdss5O JimydP1BSL6B/NZwVpd89NCLK5cHGInmRRkAepP/P0gJ4FI9sSOZvmfCBHuYRiYkzL 7oYOdFNwbDymHUqNZ3kOXSE4PN3LM0JKknh7jyewXH7/nDTuf1XEMeCYzwCD1YTATE bhU4DGeMi2OvUD6nPlaRNQ7RMBVZfhbgqQ2wmaxSIcZgEQFl2GEIiXuqWbJUucn8R/ UPg2dG+pDzmZg== Received: from unknown by smtp-4-0000.mail.infomaniak.ch (Postfix) with ESMTPA id 4fB5wR3Qz0zf9T; Wed, 11 Feb 2026 19:06:31 +0100 (CET) From: Quentin Schulz Date: Wed, 11 Feb 2026 19:06:23 +0100 Subject: [PATCH 4/4] doc: bitbake-user-manual-ref-variables: update BBMASK example with current meta-ti MIME-Version: 1.0 Message-Id: <20260211-bbmask-slashes-v1-4-b72161c647ef@cherry.de> References: <20260211-bbmask-slashes-v1-0-b72161c647ef@cherry.de> In-Reply-To: <20260211-bbmask-slashes-v1-0-b72161c647ef@cherry.de> To: bitbake-devel@lists.openembedded.org Cc: "Robert P. J. Day" , docs@lists.yoctoproject.org, Quentin Schulz X-Mailer: b4 0.15-dev-47773 X-Infomaniak-Routing: alpha List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 11 Feb 2026 18:06:39 -0000 X-Groupsio-URL: https://lists.openembedded.org/g/bitbake-devel/message/19012 From: Quentin Schulz meta-ti git repo now has multiple layers in it since kirkstone, so let's update the examples to match the current state of meta-ti by using meta-ti-bsp. Signed-off-by: Quentin Schulz --- .../bitbake-user-manual-ref-variables.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst index 6612dcc03..e8563bc97 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst @@ -1052,15 +1052,15 @@ overview of their function and contents. The following example uses a complete regular expression to tell BitBake to ignore all recipe and recipe append files in - ``meta-ti/recipes-misc/`` directories (and their subdirectories):: + ``meta-ti-bsp/recipes-ti/`` directories (and their subdirectories):: - BBMASK = "/meta-ti/recipes-misc/" + BBMASK = "/meta-ti-bsp/recipes-ti/" If you want to mask out multiple directories or recipes, you can specify multiple regular expression fragments. This next example masks out multiple directories and individual recipes:: - BBMASK += "/meta-ti/recipes-ti/packagegroup/" + BBMASK += "/meta-ti-bsp/recipes-graphics/powervr-umlibs/" BBMASK += "/meta-oe/recipes-support/" BBMASK += "/meta-foo/.*/openldap" BBMASK += "opencv.*\.bbappend" @@ -1077,21 +1077,21 @@ overview of their function and contents. mean the path is absolute. It simply forces the directory to be named exactly that. Take:: - BBMASK = "meta-ti/recipes-bsp/" + BBMASK = "meta-ti-bsp/recipes-ti/" - If you happen to have a directory ``my-meta-ti/recipes-bsp``, it will + If you happen to have a directory ``my-meta-ti-bsp/recipes-ti``, it will be matched. Leading with a slash:: - BBMASK = "/meta-ti/recipes-bsp/" + BBMASK = "/meta-ti-bsp/recipes-ti/" makes sure that doesn't happen. However, this doesn't prevent matching a - directory ``meta-foo/meta-ti/recipes-bsp``. For that, use the + directory ``meta-foo/meta-ti-bsp/recipes-ti``. For that, use the appropriate :term:`BBFILE_PATTERN` to only match a directory from one specific layer:: - BBMASK = "${BBFILE_PATTERN_meta-ti}/recipes-bsp/" + BBMASK = "${BBFILE_PATTERN_meta-ti-bsp}/recipes-bsp/" :term:`BBMULTICONFIG` Enables BitBake to perform multiple configuration builds and lists