From patchwork Thu Sep 25 07:28:53 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 70976 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 6E27DCAC5B3 for ; Thu, 25 Sep 2025 07:29:27 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.web10.5653.1758785357390875539 for ; Thu, 25 Sep 2025 00:29:18 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=fSqs8Dps; 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 137514E40DD4; Thu, 25 Sep 2025 07:29:16 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id DEDD36062C; Thu, 25 Sep 2025 07:29:15 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 0B218102F1881; Thu, 25 Sep 2025 09:29:15 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1758785355; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=Pzm3PsFn0nZyR7D8wCdz0U1mVgaBDCen9XyBEyAaVbE=; b=fSqs8DpsizWlozkVWp5zbTDf7OhBLRflW4chT0IYg/4Gp+mgsIMxD4HR4Zkdv/nUdtLhcN UtTAW8ICDwWj3zgXXHxY6IPMlcn73+c+YKRDqIF5W/y22em9cNqKorISGTEgtTK0T7cyhr Lqa1sQRniL3qGpzbAuE3XukPtTFds+puMjOO7foIIgYo/4qhpExX6FlkAwQMMJ/3wHUdcG Jr6X9wnKFu6CfIx9Xvj0EGxNNjRkZvGPtT58vxH2mHJxKFtIsjKVyjkjocF9Bu3T+kjYU2 Ghxgc+skF99LzftWAv50ENaYj6Wwjar7E12c3xFtJmdosm7fpw6OIhVnR1T4yQ== From: Antonin Godard Date: Thu, 25 Sep 2025 09:28:53 +0200 Subject: [PATCH 1/2] ref-manual/structure: document the auto.conf file MIME-Version: 1.0 Message-Id: <20250925-fragments-v1-1-c9f747361fb2@bootlin.com> References: <20250925-fragments-v1-0-c9f747361fb2@bootlin.com> In-Reply-To: <20250925-fragments-v1-0-c9f747361fb2@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Tim Orling , Alexander Kanavin , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1117; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=pumsJEGfIVbLcWpi+Ml86tx/umSI6Sxp+U/8B/ftV5Q=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBo1O9Bb06jlXh0L3aanTauG7gcy6rX3t6Ee3uE1 N/k1hW/5TGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaNTvQQAKCRDRgEFAKaOo NhegD/9dSBrJLM5Ih5vBnWHY24CimOwiyyWtwAhEEWI2FkLbvM/REimusVYnOrbA3vljSlzoOgT hkiTRsT25BbKL0kFaMsqq791ZKP5D2sUNXc80uIQmScbAXsrktUwBIzngZVjrJoLd0dn9RL9QsI L7p1rRWCX2I02OK9WxPV8uzrJ9XpkU1y5OYOE0sgX9tw3c4C2MWv+oXu/Bq7dxQ34e3oCl9dfku +C0NcvbOxfVSrr3gZYNoWIGEldSuvBFY6JO5QTU7JxLzxIo11ZR4nEy0YCzQ9L7xpuiafoXHWai 6GyDVUO6au6B5Z0E13HK5uC6WFjmb6JWqFqzdKj8UQeoPB9jL/thKD4sglJ4vsOxBJoVPt7GUPM CawKTWZeL8JPrAiMPv/HJw3cdYhPORM5Z3MdGE13cObmyjQ2oPaXT5SmEuyPsQ9RSmegoF73Cw1 3hKgMakJvmu49Ig+1u93AkFzfnKUww9r0Pjlcl9qLXkwE3qhSbF74v8AoZLBJSubQntbNIFNtfO kvdyPt2bdjQNJqJleoZbMJ5+LYV9N9if+eywD4rPv0tTYPg0LhFELogztmNyHQGAchRSRE6PDEb VwT0irIFsMMBsskULVjYz1Fwa+sdUBqKlfF88y6gF97u8QKdpsFhYPe73f/WzwXXxq7g0GUANCW M+zt8q+VIuXAINg== 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 li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Thu, 25 Sep 2025 07:29:27 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/7592 Add documentation for auto.conf, which is used by external tools for automatically setting variables. Signed-off-by: Antonin Godard --- documentation/ref-manual/structure.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst index c9c44bc63..ef6523ed8 100644 --- a/documentation/ref-manual/structure.rst +++ b/documentation/ref-manual/structure.rst @@ -345,6 +345,15 @@ This configuration file is generated by :doc:`bblock ` and contains the signatures locked by ``bblock``. By default, it does not exist and will be created upon the first invocation of ``bblock``. +.. _structure-build-conf-auto.conf: + +``build/conf/auto.conf`` +------------------------ + +This file contains configuration variables that are automatically modified by +tools such as :oe_git:`bitbake-config-build `. +This file should not be modified manually. + .. _structure-build-downloads: ``build/downloads/``