From patchwork Fri Mar 20 15:03:10 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Zhangfei Gao X-Patchwork-Id: 83989 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 94DDF1098797 for ; Fri, 20 Mar 2026 15:03:34 +0000 (UTC) Received: from mail-wm1-f47.google.com (mail-wm1-f47.google.com [209.85.128.47]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.15016.1774019011678696311 for ; Fri, 20 Mar 2026 08:03:31 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@linaro.org header.s=google header.b=x5Lb+NOT; spf=pass (domain: linaro.org, ip: 209.85.128.47, mailfrom: zhangfei.gao@linaro.org) Received: by mail-wm1-f47.google.com with SMTP id 5b1f17b1804b1-48558d6ef83so6757005e9.3 for ; Fri, 20 Mar 2026 08:03:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1774019010; x=1774623810; darn=lists.openembedded.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=vMrp1sC9cvPAua46zgYQGqEZX8VTCeuby5c8Rw2WTGo=; b=x5Lb+NOTHjcgUNED0HB9dCQV4Y/DNyywtVX5TFW41Xmd7vOv1pXwqGB0VKNQXnm/Nd 4DqqtWRa8Pcix6orTrXrf9NnCbIxLL9n+X/01fKyLGscqJDcBr0X9pPdAkOavggQOEQz Z8jABYKZkDHVjMdLygoVIF1+CyPVVxb/TulFbtgqb8dasyBBiqb//DfRrR+EsBZD+Swc wCgSj7+9LpQeaDvh//lciSx8eZo/M/78XkBDsHnJsEQl6NuVfl6sfVueRDL2OWhz6OlH /UQSMt//Fj3M/QhMqWEX29pGUS7pRgolVYSDbaU5qUdOUyrme1qiMwjBlTtMKu1vKLSM vXYQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1774019010; x=1774623810; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=vMrp1sC9cvPAua46zgYQGqEZX8VTCeuby5c8Rw2WTGo=; b=niXUyM1sMuID/WBsqqdJrjqRJVsfBXL80aGXoMj3he9az4gUF7wL6X6FxF4qQDVF/l fZIvYnJQtLtUdX1TpyJ7Ki1EeV0V1SMb2OkfmXfGRq8CPINeP2doeYj8iA+GYRGM+1ga JeN6Bfxe111Zt2s332tN2QU0ffYW8F49rsqee8qMunlhyx1oFi4zKwPCi34J2jVF38xi OTYtVLfdQO2BCpVFxzIVAcfxuDGdYnwHHTzWwmy4HvaAA2Tv2awWitv9oHM1em+xHAVJ 41g/tqMGgDCWTG1vNocUKwJQcOQRNNn3SwAU2QMdvQvolTwRQrDsT6wodIsIGalnynyZ ntVw== X-Gm-Message-State: AOJu0YxOnPHvDObQgpB1Pd7eciXvKnan6C2u2c+1XCFZQYI8Ku3/sdNS G7DdEUSMEAoxZQ8RCdqti5byrqZMgW7G8tkGuIWHgwAgy/h2KgeHIcuXue4Km2G/Y6tpBWkDHAI jBAzd9+XNhg== X-Gm-Gg: ATEYQzw1JYOwogDDeArXKuOo6k652wCi5F1TGriOrqdd/bqHVGyPB5bwUkT8F2U9lwe /CHAT1QwlL0ow7rYNtPo5NAMZj+3VRBTbxtSIu+CabzsRrldkCb0hz4VqWX2T+C6wjekwZI+aqC 6P1rxOwmCn5XnuJG2kFI5Qf5ADzcxTHW+0wIqGMBtALQMxk8ywjY0edND/oKwqFnRab8J/jw6LK FmMntnAIxLyiy/tMf3xdRaGJwlsrnFXYP8SRpYghxWMwZVHpJWYRR7ioNCKnZTd3Yx0+Y8Ldrvk iWgvTWgZb501DPED02X2IhH8nx6dm90lV6jN9XxSr+kwlK8vMqBkmdg3y0ihiKg85DUnADE3USh kO//IK1Fs3V2EYZ82Q7ohpKEXec3fehnvq0Mu3GCpTNxEfrWihD2m+tgM6Olf7bFJGs0s0QOyYR Mel8AFmRppzErUKq8KvxF5077mU/PEZPYw7mJd+pB9Xu+AZWk3RxCm8VI/bFaNp58N1gqSsKaz X-Received: by 2002:a05:600c:8b25:b0:480:6bef:63a0 with SMTP id 5b1f17b1804b1-486fee0d8cdmr57888645e9.21.1774019009594; Fri, 20 Mar 2026 08:03:29 -0700 (PDT) Received: from hackbox2.linaro.org ([2a00:2381:fd67:101:f4c1:e8ff:fe8f:2fb2]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-486f8b322d9sm132096145e9.8.2026.03.20.08.03.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Mar 2026 08:03:27 -0700 (PDT) From: Zhangfei Gao To: bitbake-devel@lists.openembedded.org Cc: christopher.obbard@linaro.org, Zhangfei Gao Subject: [PATCH 1/3] bitbake-setup: support bb-local-conf-header injection Date: Fri, 20 Mar 2026 15:03:10 +0000 Message-Id: <20260320150312.1243270-2-zhangfei.gao@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20260320150312.1243270-1-zhangfei.gao@linaro.org> References: <20260320150312.1243270-1-zhangfei.gao@linaro.org> MIME-Version: 1.0 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 ; Fri, 20 Mar 2026 15:03:34 -0000 X-Groupsio-URL: https://lists.openembedded.org/g/bitbake-devel/message/19192 Allow bitbake configurations to provide local.conf content through 'bb-local-conf-header'. When present, bitbake-setup appends the provided value (string or list of lines) to build/conf/local.conf during setup initialization. This helps projects carry machine-specific local.conf policy in configuration data instead of wrapper scripts. Signed-off-by: Zhangfei Gao --- bin/bitbake-setup | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/bin/bitbake-setup b/bin/bitbake-setup index 9d08f3a1b..edb8c4d1f 100755 --- a/bin/bitbake-setup +++ b/bin/bitbake-setup @@ -310,6 +310,15 @@ def setup_bitbake_build(bitbake_config, layerdir, setupdir, thisdir, update_bb_c # layer fragments from changes made here. # """ + + local_conf_extra = bitbake_config.get("bb-local-conf-header") + if local_conf_extra: + local_conf += "\n# Added by bitbake-setup from bb-local-conf-header\n" + if isinstance(local_conf_extra, list): + local_conf += "\n".join(local_conf_extra) + "\n" + else: + local_conf += str(local_conf_extra) + "\n" + with open(os.path.join(build_conf_dir, "local.conf"), 'w') as f: f.write(local_conf) From patchwork Fri Mar 20 15:03:11 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Zhangfei Gao X-Patchwork-Id: 83991 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 83E871098797 for ; Fri, 20 Mar 2026 15:03:44 +0000 (UTC) Received: from mail-wm1-f45.google.com (mail-wm1-f45.google.com [209.85.128.45]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.15020.1774019014878299330 for ; Fri, 20 Mar 2026 08:03:35 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@linaro.org header.s=google header.b=pmakByPi; spf=pass (domain: linaro.org, ip: 209.85.128.45, mailfrom: zhangfei.gao@linaro.org) Received: by mail-wm1-f45.google.com with SMTP id 5b1f17b1804b1-48374014a77so19349675e9.3 for ; Fri, 20 Mar 2026 08:03:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1774019012; x=1774623812; darn=lists.openembedded.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=QBco/5MR/qFsiTgsx+QAWHKMY1U8GDhvFKRm/A/bAAk=; b=pmakByPiTEh/df6iW7nQ7IrrpDETgcnGcCoBQEVsnAuKRriGIUUYk8s+pflq5F/rj4 y/XwY3JY5hgdp0PhUVhcBC+l9tS44ykPofQwzqoked8TtyEN6ZoEFmC9J9AIokLQ60pg XAV6pIbcS2QI/VK2sZNb8yG8nzpsbluhEw76TAp8ZBR5nwkyp9jmukvNoZWREGTG7pz3 8jln8k3cZEObZHfVS/eHNRegLcyNHSYcm2cLNwBtFlfsiL6ugbFlz+l7CWFRKfclyAKo zIKtEWIn22nxqitig307zsm+X55gTpLZoI4s4HLjVLI+kSxTHWy+3so0CChdNsX11LRx rgPg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1774019012; x=1774623812; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=QBco/5MR/qFsiTgsx+QAWHKMY1U8GDhvFKRm/A/bAAk=; b=rqG0yIbqR3ueAfCpVyq3z3YWyHmUzf0iSTgT1CYLYlSAkIN6hPDnO65LtaO8eDv9pd xTXohvTNMV0VOaBZ+VtvP6yAYPLatOQWr+0EkBzntSZmVqgCzm+ATNhAtI6VXp6bxuFP O4y9H7f0tbwU4eEK+TuT4z7fcZ0+/2af8Te4zZ1k0FOcLVdHv9Ppw8NxRxaQNgwkVKHQ Vj+NjLFwj5D6giNiIZLzLSNp8qBiUhiKVPEmFWWfYkU8+t7AI97umz77Oye5HNAyuaZW PWJ9WfrwHS8MBX+Pk4kNz1wGH1Q/DcO6LVUerdm9SguReebH/oiJzaVVxJTKLPeqNkjX p5iw== X-Gm-Message-State: AOJu0YxIJMjiNIQIbf+rhPhVJWqXAwBX1oStoDjzj+jLdJeSOk1qURSx yXmxv/+iMbt0uAo+UPwH5Obb95+15J+XthzYI8G70zpYgIjI597vjChdYHv4yAQnswMyL1kMD+V 28bz2rqSKKg== X-Gm-Gg: ATEYQzxH+aA9Z/NXkxm+6H/vSuf41RQUHRRaAUFFvtqKIbgjJ2pjx2HgtVBp36XFPEg WyGHFoii8ped7vH7CUJ5EZYWo6Sc7FFyxDlLhlCKrtWCm4r8J4GxYkzWOaXnk7DF9D4pUC8BjLb c/rr9SBEEVzS759mcmRANhEQjTnut2LahQGUl1QgjYTTmXhm+WoiDm03UR4rU8WDBHzZhnLKhXY 0w7/F/6B+Ln0V7QQy7v52LcwvTzHw1sFCAXHF0LOZ1a6xQiaj0W5+FiSBMkX0sFc4IysCg6RFKK OUtnFQsUyFk6agYIWjCNHCbqJdGT8oTUThkKJs16W4BUGzxSA+R6mWuoP7STLyDDJYD4lzElM7P i1C5qxV7JnGK3/1lAtGoGfPB78ERmO3aDONkS2RX5r7by1VHNrB8kXBYnfTKdt32YWHOmeDZcZY ls3DXwzpZr3Xk8+9Hlq0b1458eZe490jUiwWQWE7Y51qOFFOQNOhlkXAeJ2QSTdmJDXrhahIWf X-Received: by 2002:a05:600c:a402:b0:485:2c61:9457 with SMTP id 5b1f17b1804b1-486fedb54c2mr41756425e9.10.1774019012207; Fri, 20 Mar 2026 08:03:32 -0700 (PDT) Received: from hackbox2.linaro.org ([2a00:2381:fd67:101:f4c1:e8ff:fe8f:2fb2]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-486f8b322d9sm132096145e9.8.2026.03.20.08.03.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Mar 2026 08:03:30 -0700 (PDT) From: Zhangfei Gao To: bitbake-devel@lists.openembedded.org Cc: christopher.obbard@linaro.org, Zhangfei Gao Subject: [PATCH 2/3] bitbake-setup: add bb-target build wrapper Date: Fri, 20 Mar 2026 15:03:11 +0000 Message-Id: <20260320150312.1243270-3-zhangfei.gao@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20260320150312.1243270-1-zhangfei.gao@linaro.org> References: <20260320150312.1243270-1-zhangfei.gao@linaro.org> MIME-Version: 1.0 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 ; Fri, 20 Mar 2026 15:03:44 -0000 X-Groupsio-URL: https://lists.openembedded.org/g/bitbake-devel/message/19193 Allow configurations to define 'bb-target'. When set, bitbake-setup creates a setupdir/build-target helper script that sources build/init-build-env and runs bitbake with the configured default target (or with arguments provided by the user). This reduces wrapper-script logic and makes setup usage closer to one-command project build workflows. Signed-off-by: Zhangfei Gao --- bin/bitbake-setup | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/bin/bitbake-setup b/bin/bitbake-setup index edb8c4d1f..04cb15dab 100755 --- a/bin/bitbake-setup +++ b/bin/bitbake-setup @@ -361,6 +361,30 @@ def setup_bitbake_build(bitbake_config, layerdir, setupdir, thisdir, update_bb_c f.write('\n') f.write(content) + def _make_default_target_wrapper(setupdir): + default_target = bitbake_config.get("bb-target") + if not default_target: + return + + wrapper = os.path.join(setupdir, 'build-target') + script = """#!/bin/sh +# build-target wrapper created by bitbake-setup +set -e + +if [ "$#" -gt 0 ]; then + target="$*" +else + target="{default_target}" +fi + +. "$(dirname "$0")/build/init-build-env" >/dev/null +bitbake $target +""".format(default_target=default_target) + + with open(wrapper, 'w') as f: + f.write(script) + os.chmod(wrapper, 0o755) + bitbake_builddir = os.path.join(setupdir, "build") logger.plain("Setting up bitbake configuration in\n {}\n".format(bitbake_builddir)) @@ -394,6 +418,7 @@ def setup_bitbake_build(bitbake_config, layerdir, setupdir, thisdir, update_bb_c _make_init_build_env(bitbake_builddir, os.path.realpath(oeinitbuildenvdir)) _prepend_passthrough_to_init_build_env(bitbake_builddir) + _make_default_target_wrapper(setupdir) siteconf_symlink = os.path.join(bitbake_confdir, "site.conf") siteconf = os.path.normpath(os.path.join(setupdir, '..', "site.conf")) From patchwork Fri Mar 20 15:03:12 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Zhangfei Gao X-Patchwork-Id: 83990 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 997031098799 for ; Fri, 20 Mar 2026 15:03:44 +0000 (UTC) Received: from mail-wm1-f45.google.com (mail-wm1-f45.google.com [209.85.128.45]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.15029.1774019017741635010 for ; Fri, 20 Mar 2026 08:03:38 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@linaro.org header.s=google header.b=FCKi93c8; spf=pass (domain: linaro.org, ip: 209.85.128.45, mailfrom: zhangfei.gao@linaro.org) Received: by mail-wm1-f45.google.com with SMTP id 5b1f17b1804b1-4870206f73bso2827885e9.3 for ; Fri, 20 Mar 2026 08:03:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1774019015; x=1774623815; darn=lists.openembedded.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=mRlWjYAxTjgu09xRrYvad1lZ06Zx13fRvHxlh1szo8M=; b=FCKi93c8HQQHeBwXrAUkFTCkMV3QGb4H3aru2HOQjxd68phqMhdpAqTcwgShl8cvjm ogZGMr0jHShmEk3BWWnurI9NiaLIXB6xoEGCgEIajhTYzDr6cgvhByttnusfQYsX3N0y gXCd2RsMtYq4bbiN0goP5IjMGfpcH8mFDCtpqRTxFBBFAAjkHCJRrYznZP9yJH3Cslyt FYIFbXSdy9QnDY9zy9ql7vIkXF9S4XOSFixGyCPbKCoissRI676KFHVaCUJAcywedz9y GJTVnL9Un2WYb+I2yHpJWlFR2+/8wqE3q8m45W3/Z82o1UWald6fUzUNhiljO1Gf2oxK DpHQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1774019015; x=1774623815; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=mRlWjYAxTjgu09xRrYvad1lZ06Zx13fRvHxlh1szo8M=; b=oLHqpK0dVDPx6QpCiFbfUckltJcQuvw7vp8usLjrrxzKiUQj6bqcc8wbX9hrGFivrL Z6ol0UXaXlQ4G8KtfT///BKecDoR9fnma/28kbaI4sTbUPxpBscys045bDwKpG1gANlo OQuexKWcHFGRI1+q0qQYsVIKg5sPuCBstj53aRQgjqI8OaV+Pmci08WJiMcBqC2gFME2 uZFK9YvV5ILXI2RVa7xnhHMBeLI2fWRK9swyDE8GFfmVfmiz8gd1cbTMB4xTRTzTLAPy fa+8SHdR17/1LT2jsrVeLEwSn90NcCaXOvJYBek2OvoBXVWStfLPdNZ7VrHDp78SL3/r wesA== X-Gm-Message-State: AOJu0YxnMYp+Qfqz6nbCBZFuTyhHR59+QAKh3lKy/8ZTVQxb7NU2ihl2 BWARUnudQpoJgtrC8aTAkue9/SxEkC/2BmtddVfnSlGLuSatAOD+DEtCMhnOOBSxLwdspJqK2Jf nzk3zII/hUw== X-Gm-Gg: ATEYQzx9CxfMRzB4tkmBs5nxg3D3fxgp1PEjMOFT6+l74zmYMSVOt+KLh9TOaqvG4to CZkzdMZsKA9PRRI/GavePsO1wdwx9myBYtcMx8+QugVIm6zI+AGhh0FOcB23GNtbuzv5WyqrLTK yprg2jfXFE0TrVFGCn0sZe6xA7OQkXHlnlQvcMudzSWyEkASfKMmk1Vddx0X03D6aW3Nai2k/WW HN3BAnWPdV9hnGzEQ/V6rsPtUx/ncujD/hH+IvzqiKUDyjIt8C7v9QJ+fJbs79/EdorB0k2Uo17 d7Sv1cB8tU//FDiQ3e6wRlYi54beSwIxCxb+0HDFgeYbPXw8efbXmWch6vPCpqXPg3lsppT+fpe +1+ktBq8NPKq7iz/JmVP+72Ce51Wfh+bIVWSB/1cVBtPpBtBL3yCzgW9SXala3kkuFRB4li0t+l 7429DeQ7KBi5MM2yiTjG0fC7ScoWA+wHjZzZnpZqPYUTSIkSdj4UYwsoAZ7YU6Ak7KSHNsTpVR X-Received: by 2002:a05:600c:a55:b0:485:6bcc:87dc with SMTP id 5b1f17b1804b1-486fedc3db0mr49876215e9.14.1774019015412; Fri, 20 Mar 2026 08:03:35 -0700 (PDT) Received: from hackbox2.linaro.org ([2a00:2381:fd67:101:f4c1:e8ff:fe8f:2fb2]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-486f8b322d9sm132096145e9.8.2026.03.20.08.03.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Mar 2026 08:03:32 -0700 (PDT) From: Zhangfei Gao To: bitbake-devel@lists.openembedded.org Cc: christopher.obbard@linaro.org, Zhangfei Gao Subject: [PATCH 3/3] doc: document bb-local-conf-header and bb-target Date: Fri, 20 Mar 2026 15:03:12 +0000 Message-Id: <20260320150312.1243270-4-zhangfei.gao@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20260320150312.1243270-1-zhangfei.gao@linaro.org> References: <20260320150312.1243270-1-zhangfei.gao@linaro.org> MIME-Version: 1.0 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 ; Fri, 20 Mar 2026 15:03:44 -0000 X-Groupsio-URL: https://lists.openembedded.org/g/bitbake-devel/message/19194 Describe two optional bitbake-setup configuration keys in the user manual: - bb-local-conf-header - bb-target Include behavior notes and a minimal JSON example for local.conf injection and setupdir/build-target usage. Signed-off-by: Zhangfei Gao --- .../bitbake-user-manual-environment-setup.rst | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst index f7580c8e0..fc9ab12ac 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst @@ -847,6 +847,29 @@ They contain the following sections: - ``bb-env-passthrough-additions`` (*optional*): List of environment variables to include in :term:`BB_ENV_PASSTHROUGH_ADDITIONS`. + - ``bb-local-conf-header`` (*optional*): Local configuration lines to + append into ``build/conf/local.conf`` during :ref:`ref-bbsetup-command-init`. + + This can be either a single string or a list of strings. + + Example:: + + { + ... + "bb-local-conf-header": [ + "MACHINE ?= "qemux86-64"", + "DISTRO ?= "poky"" + ], + ... + } + + - ``bb-target`` (*optional*): Default bitbake target to + use for the generated ``build-target`` helper in a :term:`Setup`. + + If this key is present, bitbake-setup generates a ``build-target`` script + in the setup directory. Running ``./build-target`` uses this default + target. Passing arguments to ``./build-target`` overrides the default. + - ``bb-layers`` (*optional*): List of layers to add to the ``bblayers.conf`` file. Paths in this list are relative to the ``layers/`` directory of a :term:`Setup`.