public inbox for isar-users@googlegroups.com
 help / color / mirror / Atom feed
From: Anton Mikanovich <amikan@ilbers.de>
To: isar-users@googlegroups.com
Cc: Anton Mikanovich <amikan@ilbers.de>
Subject: [PATCH v10 8/8] user_manual.md: Update boostrap related documentation
Date: Mon,  8 Jul 2024 09:17:38 +0300	[thread overview]
Message-ID: <20240708061738.311938-9-amikan@ilbers.de> (raw)
In-Reply-To: <20240708061738.311938-1-amikan@ilbers.de>

Update documentation in user manual and recipes API changelog.

Signed-off-by: Anton Mikanovich <amikan@ilbers.de>
---
 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 12ea93ec..589dae66 100644
--- a/RECIPE-API-CHANGELOG.md
+++ b/RECIPE-API-CHANGELOG.md
@@ -629,3 +629,16 @@ into kernel kbuild package.
     Only the "host" specific package is built automatically at cross builds.
 
   * Support emulated module build with cross-compiled kernel for linux-module
+
+### 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 776ae52c..552b1d8c 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
 ```
-- 
2.34.1

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/isar-users/20240708061738.311938-9-amikan%40ilbers.de.

      parent reply	other threads:[~2024-07-08  6:18 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-07-08  6:17 [PATCH v10 0/8] Migrate to mmdebstrap Anton Mikanovich
2024-07-08  6:17 ` [PATCH v10 1/8] isar-bootstrap: Move common parts to bbclass Anton Mikanovich
2024-07-08  6:17 ` [PATCH v10 2/8] meta: Add mmdebstrap recipe Anton Mikanovich
2024-07-08  6:17 ` [PATCH v10 3/8] meta: Allow selecting bootstrap providers Anton Mikanovich
2024-07-08  6:17 ` [PATCH v10 4/8] testsuite: Allow variable " Anton Mikanovich
2024-07-08  6:17 ` [PATCH v10 5/8] mmdebstrap: Fix missing dpkg available Anton Mikanovich
2024-07-08  6:17 ` [PATCH v10 6/8] mmdebstrap: Move preparations to hooks Anton Mikanovich
2024-07-08  6:17 ` [PATCH v10 7/8] isar-bootstrap: Use tar output instead of directory Anton Mikanovich
2024-07-08  6:17 ` Anton Mikanovich [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20240708061738.311938-9-amikan@ilbers.de \
    --to=amikan@ilbers.de \
    --cc=isar-users@googlegroups.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox