From patchwork Wed Nov 6 08:21:17 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anton Mikanovich X-Patchwork-Id: 3901 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Wed, 06 Nov 2024 09:21:41 +0100 X-Sieve: CMU Sieve 2.4 Received: from mail-lf1-f62.google.com (mail-lf1-f62.google.com [209.85.167.62]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 4A68Le05017133 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 6 Nov 2024 09:21:40 +0100 Received: by mail-lf1-f62.google.com with SMTP id 2adb3069b0e04-539eeb63cc3sf4131721e87.2 for ; Wed, 06 Nov 2024 00:21:40 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1730881295; cv=pass; d=google.com; s=arc-20240605; b=iNgsy4OJmqBp6MNXnFwfW8GtNC6PIhP4Ir/+uWfTcVEXVNWOvt4PidnVenVSW/XMDb ALdQdrn9RC4VttHX7EXV3MAo+LDUBiWmWxxNvrgHI9xRb5tUXfFak/atdYyW+19ekHJe mu367DJ455ClKPWoD8y9oRW79YmuE5kqVIQKDV6HfZ2aMntaiLzuphkRWs/ImsYPTD+m eAdo/+75ZcP9DIbOPk7ntxGRCK4lJ7bS07LIDiWz67xCO9Pq6dwekSLKlBUKY7KBvFLX zsmHoWSQ/VPA36nKw/kBvfoe5K3l50nlIv6D40wRUhVNHooLVcQXWO066ZMQ1+OYBM/u IXhQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:sender:dkim-signature; bh=jUbMfEEIU3rM9+TzA0RjLa/62jdLxlPLUagS/F1ddYc=; fh=N3SyreFDZwAbNlhiK55RZRyZTdEtGInIuIjZ4T9oAE0=; b=QGl8iRfK7W5phWTQedekecanXUah/61khz+hAHoi7KaZzJq/X5y+0bQ/CCoKXoT7oK 8dTkfsP6MPvpqx4uXpCG0UrLwMhS76aBUWnTqHn/hx+/OSbnlsmoH/Y6qVABTmh1BHqs vS+wv+b9wWxTUdK0DvpBhvIa3sIS1fvGyhm3YZcHM1pwXldKIje/lw8HkDzqb8OsvIu5 0AVI05/lTIAyQsWoRbPfylslwHzJaLFTrYK+u4jwAp2KuwIg03alVLsZzownpkHxF4GO T1OlX0vkeS32mx838eoRMeB4nZ2Z2C53G+ETd78WXWdBsTvmDO4NwBs2c9YTrQb2voYa th/A==; darn=isar-build.org ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20230601; t=1730881295; x=1731486095; darn=isar-build.org; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:x-original-authentication-results :x-original-sender:mime-version:references:in-reply-to:message-id :date:subject:cc:to:from:sender:from:to:cc:subject:date:message-id :reply-to; bh=jUbMfEEIU3rM9+TzA0RjLa/62jdLxlPLUagS/F1ddYc=; b=k+/URlozrmfAY5atLEcfPFIRtGupROGI7sI7ioryEWO/rGhRRIkUl2dFxYTEQBkGEZ ohPdR84tHmoEz9ZhQ1Md6JGYhRzjCbbkpGhyT7XcoT208RbomqmapiA0z834ohyg+t5p 2ea1S+qGgGh87a6QZmSs56bsfWc5yW87I3H44uu6JV9cMpEH+lRaIBhLCBp3BHCUviot BCgqb4Y5EcqdMvAutYcRywg/5DAOEZRUORHVvo03lMn2I6I7ouRTRkV+ZZlZAbB46vO+ jM9xOMeZFiPru1J5sMfr5B7x3Ad61sJn1ZWbtj4ltfeR2J3piGmAnroSpxuEnx6ID9Jy ZmUg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1730881295; x=1731486095; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence :x-original-authentication-results:x-original-sender:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :x-beenthere:x-gm-message-state:sender:from:to:cc:subject:date :message-id:reply-to; bh=jUbMfEEIU3rM9+TzA0RjLa/62jdLxlPLUagS/F1ddYc=; b=e5m7F1GUV3D/uPGMkvBo1c+uDxnuHz+ix3j12RWYxwb11gyeGx0w4TlAy0reWwtxW6 Uqpul7HNq4oVqRQlR//DBEIHKrqLTk3cPVoM4UpTR1bGSyDyzysIXOMNlvbVCpYsX5Ok Agtynus1oOjbXjhQefN1+ojFI2tOCV+I99uD9MV8eNonwFZS1ybSZ1qiJO6vhKo5mmo/ lFnF0ZCoUwfftUYimyLY0on6RkCR9XJ07vc/NK7NpnjJSzt8YvgeMSRScys8yuSH1KeE JrUgPnZneTyDaSR9I0Fm8ptftbcF7mWnLgtW2rJjuZH9z4mhN0IEXtoQt2gmNLJCzrNQ ftfw== Sender: isar-users@googlegroups.com X-Forwarded-Encrypted: i=2; AJvYcCXgaNHKCXY2unlFMjxJlYWPh+VJumJyNLxMGrVgCgTo0Alu13JEnmkk7MDsZBpzWuoMa0QRo8A=@isar-build.org X-Gm-Message-State: AOJu0YwJqkWq6kjxKLSaopL3C0e9A0/b4yvyqaLkgPoZK+RAEUHONced HgQsDYfC0n2qIsRpAvacc/U7BtER+rBYCjnlmxW4JrNFPlsccW/Y X-Google-Smtp-Source: AGHT+IE94Z6bYK50jZzOdc4BM5c/zB6BgoqPoZu5nT7M1WVOR9iz6UqXJ34zh2T0FrFsy3tvg68eZQ== X-Received: by 2002:a05:6512:a87:b0:53b:27ba:2d11 with SMTP id 2adb3069b0e04-53b7ece09bamr14500165e87.16.1730881294207; Wed, 06 Nov 2024 00:21:34 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:6512:2215:b0:539:fdc6:d67e with SMTP id 2adb3069b0e04-53c7972c266ls996064e87.2.-pod-prod-01-eu; Wed, 06 Nov 2024 00:21:32 -0800 (PST) X-Received: by 2002:a05:6512:3b1e:b0:539:f630:f233 with SMTP id 2adb3069b0e04-53b88f406e2mr14234293e87.57.1730881292026; Wed, 06 Nov 2024 00:21:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1730881292; cv=none; d=google.com; s=arc-20240605; b=P4WIGXTDuxeL9qPUn6M6VGFvUlQcl1rsKEJAm3I8f+yYkT3pNut7EpBng7HEnPzkp8 gc2GQNw2ZgTMh6DqFQ2iaVQ6rDNK7Aov6IP2+2g7ut1LUBbzO5MWG/Z9QLl2ftw3pj00 +wCOYg/R6ufVOcx5+Hl5qKuNMyMjAVRvkvnSbUKa2Df0CrVErEiIRP7tx4UDybDhqbqi UjFbxllOTq5JzPYs8yMHwoExnYImDGTLwYqBOnEksBN0bq2IaqR8zQa82BEJRjeG/ypx Lv1jPinEWwDSrra1rjdcu4MDswveco+LVeAakngOymUl1zdYblSdYZy5KMUJ+EUXpkaT jNcA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from; bh=MKoTmwDjs9D84BMIr779E6Areb5Ua0PXxvZZWTGivxM=; fh=/h9QQkzJ8EboVkWg45aWwpaUro6WMavIVd2OhN45RtE=; b=gJAOhu6b61xfDCJ0lV9wNR/mtmVypjJ6i/aQqVgbPqOzRPnF1Otc+0zxpRQV1XF965 1oWTB/M7jPotH5R+qbJp5JDVp7h3jParKd2E0f+AzwaVcUW45zwFPGVgtPGTFDTNe9vh PV8u3beEM8bNiFD08TgImFlUA5CN6Ow1eX6dejs+aGggP9AgcY6a67aw1tbN6H1S4xG7 fCvWHTg4lYmj5DEapUdpiYeZE9PUStDxzkdtA7ES8r2yd93e7mny6GmOHa2Ovm5dKR3p bJBoloSr4ixyVjyWe4CgwXR7VI0G7dY6eIU7KlSrSHZktEbtCbz/LBNPCZG1BpGETr5G jWnA==; dara=google.com ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id 2adb3069b0e04-53c7bccc4e7si504280e87.8.2024.11.06.00.21.31 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Wed, 06 Nov 2024 00:21:32 -0800 (PST) Received-SPF: pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Received: from user-B660.promwad.corp ([159.148.83.114]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPSA id 4A68LOjx016956 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 6 Nov 2024 09:21:31 +0100 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v11 8/8] user_manual.md: Update boostrap related documentation Date: Wed, 6 Nov 2024 10:21:17 +0200 Message-Id: <20241106082117.1089554-9-amikan@ilbers.de> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20241106082117.1089554-1-amikan@ilbers.de> References: <20241106082117.1089554-1-amikan@ilbers.de> MIME-Version: 1.0 X-Spam-Status: No, score=-4.6 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_BLOCKED,RCVD_IN_MSPIKE_H2, RCVD_IN_RP_CERTIFIED,RCVD_IN_RP_RNBL,RCVD_IN_RP_SAFE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-Original-Sender: amikan@ilbers.de X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Precedence: list Mailing-list: list isar-users@googlegroups.com; contact isar-users+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: isar-users@googlegroups.com X-Google-Group-Id: 914930254986 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= Update documentation in user manual and recipes API changelog. Signed-off-by: Anton Mikanovich --- RECIPE-API-CHANGELOG.md | 13 +++++++++++++ doc/user_manual.md | 15 ++++++++++++--- 2 files changed, 25 insertions(+), 3 deletions(-) diff --git a/RECIPE-API-CHANGELOG.md b/RECIPE-API-CHANGELOG.md index 56ebfeb7..deb1c4e1 100644 --- a/RECIPE-API-CHANGELOG.md +++ b/RECIPE-API-CHANGELOG.md @@ -680,3 +680,16 @@ Bitbake exit status depends on ISAR_FAIL_ON_CLEANUP bitbake variable: rootfs_do_umounts is not called from do_rootfs_finalize anymore. Every individual task that does mounting must also do the umounting at its end. + +### Default boostrap recipe changed to mmdebstrap + +New virtual packages bootstrap-host and bootstrap-target are introduced. +There are two providers of bootstrap-host/-target currently: + * isar-mmdebstrap: deafult one using mmdebstrap to prepare rootfs + * isar-bootstrap: previous bootstrap implementation left for compatibility + +So default bootstrap procedure is now performing with mmdebstrap. +Previous implementation still can be selected by setting in local.conf: + +PREFERRED_PROVIDER_bootstrap-host ?= "isar-bootstrap-host" +PREFERRED_PROVIDER_bootstrap-target ?= "isar-bootstrap-target" diff --git a/doc/user_manual.md b/doc/user_manual.md index 284847c8..06561247 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -66,7 +66,8 @@ The steps below describe how to build the images provided by default. ### Install Host Tools -The supported host system is >= buster. +The supported host system is >= buster for debootstrap and >= bullseye for +default mmdebstrap provider. Building `debian-trixie` requires host system >= bookworm. @@ -75,7 +76,9 @@ Install the following packages: apt install \ binfmt-support \ bzip2 \ - debootstrap \ + mmdebstrap \ + arch-test \ + apt-utils \ dpkg-dev \ gettext-base \ git \ @@ -93,6 +96,12 @@ apt install \ zstd ``` +If using isar-bootstrap provider, debootstrap should be installed instead of +mmdebstrap: +``` +apt install debootstrap +``` + If your host is >= buster, also install the following package. ``` apt install python3-distutils @@ -135,7 +144,7 @@ apt install qemu ### Setup Sudo -Isar requires `sudo` rights without password to work with `chroot` and `debootstrap`. To add them, use the following steps: +Isar requires `sudo` rights without password to work with `chroot`. To add them, use the following steps: ``` # visudo ```