From patchwork Tue Oct 13 12:13:34 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 100604 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 CE14DCC6B08 for ; Tue, 13 Oct 2026 12:14:10 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.5687.1791893645909421584 for ; Tue, 13 Oct 2026 05:14:06 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=IU16DxUw; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id B38B44E41209; Tue, 13 Oct 2026 12:14:03 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 796C060362; Tue, 13 Oct 2026 12:14:03 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 4864A11D70F56; Tue, 13 Oct 2026 14:14:02 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1791893642; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=ePXH4HJQ4a+lTQ+SxgkBFQ2FiI7hYt4TMo+I4SO48Bs=; b=IU16DxUwWEPd308hE49xB+t4m9giE29xBhMQ64QDARCXNCehTa/bLSOwze0ko+LHcHlvmr ApNtvLC10QsQxBPH1EB8+HqunJDLqmBsoQWx4Wxnc5YKp89nt267WpP1PjdLBqRvSIi+uL PTis0hoqModj7PMMjWUkE1RzoVLgsYHcOoYn4Ua+qgV5ii0cNthusSk5F+daWGvObLqls5 CNcImSmIkRm04+uQLIzz0OzL5n1UJpdcRUAuQZS1TMRsij6g1sgTaXSRYg+I+5bj5q2UVN +QoHpMLS8T/BqRn5Ef9Cad6I7b0gJmnHCP7OmUrSGtCZKFNGR4CFtml/UXTq4Q== From: Antonin Godard Date: Tue, 13 Oct 2026 14:13:34 +0200 Subject: [PATCH 1/4] main: add an argument for showing warnings as errors MIME-Version: 1.0 Message-Id: <20261013-warn-as-errors-v1-1-ab3658758ceb@bootlin.com> References: <20261013-warn-as-errors-v1-0-ab3658758ceb@bootlin.com> In-Reply-To: <20261013-warn-as-errors-v1-0-ab3658758ceb@bootlin.com> To: bitbake-devel@lists.openembedded.org Cc: Thomas Petazzoni , docs@lists.yoctoproject.org, Antonin Godard X-Mailer: b4 0.17-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1034; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=XI8cvf1wI6d/zdJv0v0/Pc/0Za77HiOxQM/1xHSQgNE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqziB0PQujZKp++DkI6chP+EKkxo5nIT7eHBR+I lJEXjTDlAWJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCas4gdAAKCRDRgEFAKaOo NhD8EADD6N9UL44/YENstSQg+gYakmVlUpTk34wldMUiOMZRDUm5C/8CeytrQvqXLR8jiztaOPx R1tYZdJuKgocVLfq018mPzB8+rhoTWKhN05ixTqN0I3cr7r0zlMcUAHlek6pFAgEMeT66+JZQ3I J9DS7i6R/gHXYVRzOgLvuEo60dTHJt3LZh1YniCcGnNFqAjuWRZa4FbSwRqMUk+sVxVYqcq3OsJ lnaYKMB43Bw9hRyUoBdvQEADotJi6fOfY2LdQbh/WrYYMk0VfQVCFPW+nRmzjnzNu+bHtl3Et4y eGJG+RGrFaoxXZxkl6cyIGhFllmS5EJz29+xShxSLTr+Vc9VvlNVKUt1BljFFBq1ovRJHdX2YI4 IAZR4X2gEmvkGjyw40BXyHa9oAsMP5bgXkxDkYd/4kIXEIsKIEDeSxCLuf5HIe0ySg0FuMi7FNe lOMzv9YFxmANbCdUGHNXx8uM3Y47QVSNjOHnyl7QKs04BocXEexqX1JdC2cdM3UYcqr45FvTk6I pz6EvZ2YXlCmxDP3Pv3+OUnWoAnxO3+iblZkaj4GshBMVvHhiGnZHRBGOZWA4lFuA2zdusQy/c5 J6UXFiJJojqNBddt/4QWv0sIPvb7wVWiCdwa4jhDezhgKtxaVURzzIZO4sBnBpMctebEpproPHp +n+o+zNYnsH591g== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 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 ; Tue, 13 Oct 2026 12:14:10 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10663 Add -W/--warnings-as-errors to make it possible to turn warnings into errors. The werror boolean should be used by UIs to turn their warnings into errors. Signed-off-by: Antonin Godard --- lib/bb/main.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/lib/bb/main.py b/lib/bb/main.py index 73a66468fef..7c65dfff1af 100755 --- a/lib/bb/main.py +++ b/lib/bb/main.py @@ -256,6 +256,9 @@ def create_bitbake_parser(): help="Output less log message data to the terminal. You can specify this " "more than once.") + logging_group.add_argument("-W", "--warnings-as-errors", action="store_true", dest="werror", + help="Treat warnings as errors.") + logging_group.add_argument("-w", "--write-log", dest="writeeventlog", default=os.environ.get("BBEVENTLOG"), help="Writes the event log of the build to a bitbake event json file. " From patchwork Tue Oct 13 12:13:35 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 100605 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 18009CC6B17 for ; Tue, 13 Oct 2026 12:14:12 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.5688.1791893646163682719 for ; Tue, 13 Oct 2026 05:14:06 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Nhfsd3E8; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 5D5A41A11FE; Tue, 13 Oct 2026 12:14:04 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 2D2F960362; Tue, 13 Oct 2026 12:14:04 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 48B0711D7105B; Tue, 13 Oct 2026 14:14:03 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1791893643; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=e8zCv3ba4s73w2+IyKqPTXYwD4KbQoIs1tO3fxzj2f8=; b=Nhfsd3E8+qZDSF4tZkW6jMxE3yofhbNfT7i96z+VePlWh78U/ZySsweDCOifQRfPVWH1TT 50lUYbNh4l4iz+5+qSsjQEdz5sk+s+77CVmgIJi3mHygewoLkwsvzpUY2NIqFzIIwxG42t QStCvs4W3n5KsY4DoS/Cc/E395kvtDa7mox4+bG8Jxrs81z2LYypuk5AXI6hr1Sje/rb/4 Z7CHFijpELSp8rqcznx25ci6yfuIWT8jtxE9WvOuHyaOVYVgl2tGfqrgvAUl7sf+CYaTMf nzF6Nw548iFbFoWYEiGHTSguJ+J8YDJaFWj0bFtD7uv9u9eMET+NU0l2oRI+mg== From: Antonin Godard Date: Tue, 13 Oct 2026 14:13:35 +0200 Subject: [PATCH 2/4] msg: add a helper to show warnings in red color MIME-Version: 1.0 Message-Id: <20261013-warn-as-errors-v1-2-ab3658758ceb@bootlin.com> References: <20261013-warn-as-errors-v1-0-ab3658758ceb@bootlin.com> In-Reply-To: <20261013-warn-as-errors-v1-0-ab3658758ceb@bootlin.com> To: bitbake-devel@lists.openembedded.org Cc: Thomas Petazzoni , docs@lists.yoctoproject.org, Antonin Godard X-Mailer: b4 0.17-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1133; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=ROVXoPLlsPztgqD6Z8t2y2a3AwhvuihOqzeftQ3RxC8=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqziB0PXsvYfTEgjPBNONJjtVBdyRq4eML4UNGj c7VzyGRJvGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCas4gdAAKCRDRgEFAKaOo NjIZD/4zPQKVEahmqKln1o/UN02yZYeNd2GAoG9/K7Gg0+f5R0oZokgafQCcn7DnOilX57HZ6w1 5SjZIE0O5A9g+cOIWHqFTLq6+HTeuuMNN+i3WtCcWI7r+8+nqMF7V0/KXwWm2Lrk/JuKWHD4T9+ I68USIb6ZBrhinSP1nCSIAUxvXxMdKrylad9IKW5+wCPIgSFxyhEf+KyiM77XcyVvROqEu6OiZO JSjdWnxv5eiHWG7gBlJ+w+AdKOitkcAyOYN+GGHXbcQ0lHZygmmLVp7YZqWvGWV6Hi58PrUg+rC LJx7aIawNn6ZVcT6W+9sntEDJqapO7aZ+Uy+JkhtDtIo++EZ/9pH+JNtZ4VcGfxURVwGU4MLiux yZPgckKcwx9t1CZaJ1DqVGKJCQxXwEiKMhQaBFMWUFAlNJTNfvpYDas5HhwGL+lnR2LOE6UBZS5 zbRAcnN/gwhHM6uKAyV0EeuPLrK2JPFeGQ3HyDCkeKJkH1W7vOZDiKhnPcgwk673MI4FLtzEZJm jt+I309SGsRbR02zb4sKrAOqy7jH1wRiUPeRvYVwVhUnghDHPLjVJ8cA/AhtaoObXnOtjryd6q8 RuggAQmoZRI9xkEISzu3mTCzEaTIuLsZDmU1F7r1Ib5IMhytpsJ9zuBDVmWmVc1bI4pcPdmkn2b f6jPfBibygSmNUA== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 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 ; Tue, 13 Oct 2026 12:14:12 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10664 In preparation for the next commit, add a helper that changes the warning color to be red, when warnings should be treated as errors. This helps users recognizing that the -W argument was passed while still being able to differentiate between warning and error messages (thanks to their levelname). Signed-off-by: Antonin Godard --- lib/bb/msg.py | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/lib/bb/msg.py b/lib/bb/msg.py index 4f616ff42e7..02728c44bba 100644 --- a/lib/bb/msg.py +++ b/lib/bb/msg.py @@ -102,6 +102,14 @@ class BBLogFormatter(logging.Formatter): def enable_color(self): self.color_enabled = True + def set_warn_color_red(self): + """ + Changes the warning messages color to red. Should be + used when treating warnings as errors. + """ + self.COLORS[self.WARNING] = self.RED + self.COLORS[self.WARNONCE] = self.RED + def __repr__(self): return "%s fmt='%s' color=%s" % (self.__class__.__name__, self._fmt, "True" if self.color_enabled else "False") From patchwork Tue Oct 13 12:13:36 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 100603 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 E460FCC6B0F for ; Tue, 13 Oct 2026 12:14:10 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.5606.1791893646874292565 for ; Tue, 13 Oct 2026 05:14:07 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=IQNUEa6i; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 3CC711A1201 for ; Tue, 13 Oct 2026 12:14:05 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 0A1AA60362; Tue, 13 Oct 2026 12:14:05 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 08FAD11D71058; Tue, 13 Oct 2026 14:14:03 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1791893644; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=SKAMb2L/OfNiCtu1zfi6Fqc1sDv1OFcPTLgLzk5zCkg=; b=IQNUEa6i/nxR5kxvbD9KzwtY51Dqi8lYuhBlP8hq5Gzu6thUoVDGkf8675OBDumvu5ICIK RxXM/Hs+3ydsVrvkkujo6/9+hkdZu0QMeSKY9dvrXeXwKIB/fjYT8LUe4ER+pUPrhmPwbQ qwCBbZXXswWQfoWD5ED394TkOeCYIk0hDTDkd4CKvDsQov4oK6ORF17mL67cq2bBRXtxbA A6uUnRRv7W5V3FnCOzaMGZuut/LTKBiXGom8ClGa4rZwiKZ1weM21xoLMJ2ET9lM39MK91 Nb2uWBt7xrBiz0B5XY7jcNwVWKipFZPa1nv4FJoO9aiQPhDhYd0LYHLf74JKMw== From: Antonin Godard Date: Tue, 13 Oct 2026 14:13:36 +0200 Subject: [PATCH 3/4] knotty: convert warnings to errors when -W is passed MIME-Version: 1.0 Message-Id: <20261013-warn-as-errors-v1-3-ab3658758ceb@bootlin.com> References: <20261013-warn-as-errors-v1-0-ab3658758ceb@bootlin.com> In-Reply-To: <20261013-warn-as-errors-v1-0-ab3658758ceb@bootlin.com> To: bitbake-devel@lists.openembedded.org Cc: Thomas Petazzoni , docs@lists.yoctoproject.org, Antonin Godard X-Mailer: b4 0.17-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2179; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=6Masqy+hbBKtotiStPySW3Pr0daMVYYOOh3Hh8f/H3M=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqziB0s++R6AVnKiRVnRL3Co01BfqUhjWhMZK/h EiVXUAyJh2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCas4gdAAKCRDRgEFAKaOo NnKBD/43oAqZVfJU2fh2J+69+8kg/t7vkXKv3BRRkry4ljnCakUzi70p8d70mblxN36KyV02nYK uoa7GKsNJY2Pui6O1+MCqi1GMA1ioJQ0XeQw2i5kvGiimVJuEAboWralA1gx5VO1bNZ2T36P05n G7T6GN2rmroaioyoxhKxewhYRwOSAEUGku/GKyntdgpy3rQE51WGe0V9OpHa/Z8ETIUG7oGwdQs 8YE+5jjQ7fcbVn0IxPnEiHEMM8+HMns0zhllJWCXbSNb7i55RIM8NVYINs4iHCsdkzLZyXthlH+ rBd9DswZJ1kTmny4jfmaHdlUTe87zEUtPUMuINNpMUbDCaAuiRtG1UBgUrjNZTxouOQRoXgpyNu DJ2IwebhOqmVzd/T68lyu+UtS+ER2dcPUe1I4ro+yGVoIlsp+61lxphe3ht0X8Ye9JBbvFpFq24 napztn/rB3sob7fsCOj170OaIx55q/hLMVJdycABO7XGKxhfc87NjIYpw9XrCF/LNQEcTPe818i 0TDz7cSdPVGXUq7Np0crCmLWkBxVILwu7wSyOO8q25d1NGQsGUV6wa9hcyB3w8WYGkV6ELUnLXm ulWSnD8YFBF/UPCqiTKtYeeMPCJ6En3O98gkafyaqlqOMWdzgJZL05EXTsVi5ea7C7N8SsNJuSd VyY3g2O1kipkWcg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 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 ; Tue, 13 Oct 2026 12:14:10 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10665 When -W is passed, modify the handlers to show warnings in red and set the return value to 1. Add a summary line informing the user that the -W option was used as it might not be obvious when looking at the bottom the end of the console log. Signed-off-by: Antonin Godard --- lib/bb/ui/knotty.py | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/lib/bb/ui/knotty.py b/lib/bb/ui/knotty.py index 1a3198b5c02..a3a5c374a35 100644 --- a/lib/bb/ui/knotty.py +++ b/lib/bb/ui/knotty.py @@ -662,6 +662,14 @@ def main(server, eventHandler, params, tf = TerminalFilter): # terminal handler console_handlers = [h for h in conf.config['handlers'].values() if getattr(h, 'is_console', False)] + if params.werror: + # Change the color of warning/warnonce messages to red when -W is passed + for h in console_handlers: + try: + h.formatter.set_warn_color_red() + except AttributeError: + pass + bb.utils.set_process_name("KnottyUI") if params.options.remote_server and params.options.kill_server: @@ -782,6 +790,8 @@ def main(server, eventHandler, params, tf = TerminalFilter): return_value = 1 elif event.levelno == bb.msg.BBLogFormatter.WARNING: warnings = warnings + 1 + if params.werror: + return_value = 1 if event.taskpid != 0: # For "normal" logging conditions, don't show note logs from tasks @@ -1054,6 +1064,10 @@ def main(server, eventHandler, params, tf = TerminalFilter): if return_value and errors: summary += pluralise("\nSummary: There was %s ERROR message, returning a non-zero exit code.", "\nSummary: There were %s ERROR messages, returning a non-zero exit code.", errors) + + if params.werror and warnings: + summary += "\nSummary: Warnings were treated as errors (-W)." + if summary and params.options.quiet == 0: print(summary) From patchwork Tue Oct 13 12:13:37 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 100606 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 4D60BCC6B16 for ; Tue, 13 Oct 2026 12:14:11 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.5692.1791893647809168023 for ; Tue, 13 Oct 2026 05:14:08 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=judHLpw3; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 248B01A1202; Tue, 13 Oct 2026 12:14:06 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id ECF7F60362; Tue, 13 Oct 2026 12:14:05 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D2B3811D7105D; Tue, 13 Oct 2026 14:14:04 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1791893645; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=pcJ85W9j5jNJ5Ja+H32XlE877a3GQa2KGJSDBd5MWf8=; b=judHLpw3ZdvxVdaQ3kla1z74gXwvHF8OhXEW3NUUf0guxSRYvvndPGyPAPoqrZJDZqVMob S24iLuizQcYHz+yfzxBG4defW0NUdJcQVUk7/SB/mL59WnhcmtUfXCaS7Y50v1ldHnpvOE 7CWR0kpXpaDhwlGLAcuEu991r+YLI4ZXyYUvkfwefvD0Dbh9lwkex0ZjAW+kKW3B8ka6zP qdybCz4dXJ2bGJQ/+QG0glnLcu6UcPbaY3U3AbErpT4toWNP1i2HzeDqNTE/9ADRTqRVe+ XfSSfZtv1EmgkaoNbq57DYqMfzKow8DpPv5q9cL7IxPh7uvMyDPY97I9oSL5cQ== From: Antonin Godard Date: Tue, 13 Oct 2026 14:13:37 +0200 Subject: [PATCH 4/4] doc/bitbake-user-manual-intro.rst: refresh bitbake's help message MIME-Version: 1.0 Message-Id: <20261013-warn-as-errors-v1-4-ab3658758ceb@bootlin.com> References: <20261013-warn-as-errors-v1-0-ab3658758ceb@bootlin.com> In-Reply-To: <20261013-warn-as-errors-v1-0-ab3658758ceb@bootlin.com> To: bitbake-devel@lists.openembedded.org Cc: Thomas Petazzoni , docs@lists.yoctoproject.org, Antonin Godard X-Mailer: b4 0.17-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=6961; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=tae5mbacN8YTT0dnqeQJpmQ9y30ZC/ALYFPnKl5B85Q=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqziB0fejzayLco+myJ0ohZOENdSTBx818BhHpO ero8ZVDS1WJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCas4gdAAKCRDRgEFAKaOo NvDJEACuTRxVdmCd2Gn6O7dedAV+0IqHYM/iWQ1rMUjJLXHEq96s/4QBxs9q7B/xixXTFirbFHS CBwHV9B1Wuxe7QYG5gc6crtiBGWLtChP7yipuyu8r2ufbNfoWykFQLr5PLLnLKKLXK0x/pu4dO2 DBgipz+osrZYfCZb4JATXl+TBBNlWJ3+IpfujoLfIPA7qZBjIq71l7XnhEdsQ4O1hzJ97cBiIAD /4Dt2HHw7CrpqDf5OpzmOqwA+JHl0J0PbqM5rZ0XfMbGQ5Gkw7YkqO6KdMjLP4IARYaW7uU0fta lJNGNBNLbyQokWvVxlr7IapfTk2kqAYqVlty6J/gF6J2BssvET6kDu4QIM72r3OJxdUAKWtmNsn tvZkB9iXDb5mcJWi1ueGRtO5jhMAOz4JIfcXCujtBZzUumt15aDOQjjhdOX874LUdJsVrJ3Lt1y TBSXa0LTIV6in0Ydyi2hDFV8+EWvVKYfLFrzHu1hMNjvrbNLgGKfQ3nciT9giDgz8FytWGDMLzo +MQ4CljHZsFNkzyMK+Id3+LEi2q0qI7jqF61vRoJwAoqK8Mt6Ns4WEzG/t0L5R3XUp9jbNJ83pZ DUJsQbHklN1szfTFNMFlGNSt/i3DvbBrdLDMc12460SVbKxm2fP7lpq63GJIgz6cxT6J8WIzS2L rbTnHg8iv7iJL0w== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 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 ; Tue, 13 Oct 2026 12:14:11 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10666 Refresh the bitbake help message with all recent changes. Signed-off-by: Antonin Godard --- .../bitbake-user-manual-intro.rst | 36 ++++++++++++---------- 1 file changed, 20 insertions(+), 16 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst index 6801323e2fb..af6dfed8915 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst @@ -415,8 +415,8 @@ Following is the usage and syntax for BitBake:: usage: bitbake [-s] [-e] [-g] [-u UI] [--version] [-h] [-f] [-c CMD] [-C INVALIDATE_STAMP] [--runall RUNALL] [--runonly RUNONLY] [--no-setscene] [--skip-setscene] [--setscene-only] [-n] [-p] - [-k] [-P] [-S SIGNATURE_HANDLER] [--revisions-changed] - [-b BUILDFILE] [-D] [-l DEBUG_DOMAINS] [-v] [-q] + [-k] [-P PROFILE] [-S SIGNATURE_HANDLER] [--revisions-changed] + [-b BUILDFILE] [-D] [-l DEBUG_DOMAINS] [-v] [-q] [-W] [-w WRITEEVENTLOG] [-B BIND] [-T SERVER_TIMEOUT] [--remote-server REMOTE_SERVER] [-m] [--token XMLRPCTOKEN] [--observe-only] [--status-only] [--server-only] [-r PREFILE] @@ -435,7 +435,7 @@ Following is the usage and syntax for BitBake:: set/changed. -g, --graphviz Save dependency tree information for the specified targets in the dot syntax. - -u UI, --ui UI The user interface to use (knotty, ncurses, taskexp, + -u, --ui UI The user interface to use (knotty, ncurses, taskexp_ncurses or teamcity - default knotty). --version Show programs version and exit. -h, --help Show this help message and exit. @@ -443,11 +443,11 @@ Following is the usage and syntax for BitBake:: Task control options: -f, --force Force the specified targets/task to run (invalidating any existing stamp file). - -c CMD, --cmd CMD Specify the task to execute. The exact options + -c, --cmd CMD Specify the task to execute. The exact options available depend on the metadata. Some examples might be 'compile' or 'populate_sysroot' or 'listtasks' may give a list of the tasks available. - -C INVALIDATE_STAMP, --clear-stamp INVALIDATE_STAMP + -C, --clear-stamp INVALIDATE_STAMP Invalidate the stamp for the specified task such as 'compile' and then run the default task for the specified target(s). @@ -471,8 +471,11 @@ Following is the usage and syntax for BitBake:: target that failed and anything depending on it cannot be built, as much as possible will be built before stopping. - -P, --profile Profile the command and save reports. - -S SIGNATURE_HANDLER, --dump-signatures SIGNATURE_HANDLER + -P, --profile PROFILE + Profile the command and save reports. Specify 'main', + 'idle' or 'parsing' to indicate which bitbake code to + profile. + -S, --dump-signatures SIGNATURE_HANDLER Dump out the signature construction information, with no task execution. The SIGNATURE_HANDLER parameter is passed to the handler. Two common values are none and @@ -484,7 +487,7 @@ Following is the usage and syntax for BitBake:: expected) --revisions-changed Set the exit code depending on whether upstream floating revisions have changed or not. - -b BUILDFILE, --buildfile BUILDFILE + -b, --buildfile BUILDFILE Execute tasks from a specific .bb recipe directly. WARNING: Does not handle any dependencies from other recipes. @@ -499,22 +502,24 @@ Following is the usage and syntax for BitBake:: -D only affects output to stdout. All debug messages are written to ${T}/log.do_taskname, regardless of the debug level. - -l DEBUG_DOMAINS, --log-domains DEBUG_DOMAINS + -l, --log-domains DEBUG_DOMAINS Show debug logging for the specified logging domains. -v, --verbose Enable tracing of shell tasks (with 'set -x'). Also print bb.note(...) messages to stdout (in addition to writing them to ${T}/log.do_). -q, --quiet Output less log message data to the terminal. You can specify this more than once. - -w WRITEEVENTLOG, --write-log WRITEEVENTLOG + -W, --warnings-as-errors + Treat warnings as errors. + -w, --write-log WRITEEVENTLOG Writes the event log of the build to a bitbake event json file. Use '' (empty string) to assign the name automatically. Server options: - -B BIND, --bind BIND The name/address for the bitbake xmlrpc server to bind + -B, --bind BIND The name/address for the bitbake xmlrpc server to bind to. - -T SERVER_TIMEOUT, --idle-timeout SERVER_TIMEOUT + -T, --idle-timeout SERVER_TIMEOUT Set timeout to unload bitbake server due to inactivity, set to -1 means no unload, default: Environment variable BB_SERVER_TIMEOUT. @@ -529,11 +534,10 @@ Following is the usage and syntax for BitBake:: (cooker) process. Configuration options: - -r PREFILE, --read PREFILE - Read the specified file before bitbake.conf. - -R POSTFILE, --postread POSTFILE + -r, --read PREFILE Read the specified file before bitbake.conf. + -R, --postread POSTFILE Read the specified file after bitbake.conf. - -I EXTRA_ASSUME_PROVIDED, --ignore-deps EXTRA_ASSUME_PROVIDED + -I, --ignore-deps EXTRA_ASSUME_PROVIDED Assume these dependencies don't exist and are already provided (equivalent to ASSUME_PROVIDED). Useful to make dependency graphs more appealing.