From patchwork Mon Jul 8 06:17:38 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anton Mikanovich X-Patchwork-Id: 3670 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Mon, 08 Jul 2024 08:18:04 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-wm1-f59.google.com (mail-wm1-f59.google.com [209.85.128.59]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 4686I3Hq030835 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Mon, 8 Jul 2024 08:18:03 +0200 Received: by mail-wm1-f59.google.com with SMTP id 5b1f17b1804b1-4265b751469sf9343845e9.1 for ; Sun, 07 Jul 2024 23:18:03 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1720419478; cv=pass; d=google.com; s=arc-20160816; b=bnYd3O5m47Az8Xkwr86nHoVU5+XPPQlzTTrAoOnZrXmdz0NgGv/8/5Qkt7S+G4Zn7Z mWyjguleVo8IzXYHK7HBz4kZVDw7jJ7y6l5Yjnqn4plObVPfV02o744Ge9PXo3dqQFGx T9nSrL22ujXZeOxhFUULCon428PzzO/lG7lzR1yDc/VcCJRyUzg2Sv/fhAjmF6UxXGjY qwTjRjDw2NhzTgFenEiMvR1/UPHIKGjtubNg0fxRdMQle68YRuRKHPc8VZV7foOFomY9 RGqPxJ7bvvzKO3M7osk+5NS9ZNWJztDC5p6nUMzojcXz21JabviUwa46lxWe7nEmMHgQ ZxRA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; 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=Nn+Yv1DSoZM/Q4z65nG43aWLTz6JCC0hBcY1DUuhNqk=; fh=vEt2qBpkNuQf/JQJU1OaIeIxlX1LE01+FC7ApSKut/0=; b=xoXhq7CxB4QrlqS5hZRjFMsNEGy4xvQE2dP9L6uaksje8kFuEWEOaMuk8vWvBDArBp PBGKA8V19fifnMGOXK9/U9zr8e/1+SiXFZ4o6ttEJ7v60IIpKcZPTrW15B46Crfl2ac6 rd45YRDjgb5p4XTlp6N6qg/E8dqTRwMqY2lJ7b5l47YA4exfeDsZuuNNuoSrBScFcacY GXT2ghNpdQGqJUmWgLvDfJ54pWMRhn7pIG4wWfjBOiQz/otXWeQabwe6E1nX16l8hJZ/ cssaabUeaBRWs/Lxy5hsSldPi+qaydXujUD2uW1Kap4lDYzF3SAAoGjA9hPrPrwewhSc jpsg==; 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=1720419478; x=1721024278; 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=Nn+Yv1DSoZM/Q4z65nG43aWLTz6JCC0hBcY1DUuhNqk=; b=mtCGYfFYGOxJhYpveEbY4mJvRAhxV5cmiOEBRD4VPxWYtx8jjtYSE0nXkK7wgfgcb1 iu4/Mc97wx6r5qUqMfXgbvmHRQe/488BXRJtGUQ5Rzmmu3fIqZK64IVtVRVreNZ8ON7A DFq4f2k/l0/8DoIHkjac4DYaJ6zTigMqTHVjt0t7OLLbHbRZtLrFrIFcnBitBZTz7Vy9 udm71/IUpKeipn5xS0h5bA8oUTq1cX9DFCHT8ZHx8SCTc6ebKRajV2Bwk5rbWzdpMczS iJ7Y1Ei1DpW1eF3ahYYrW6loVre40mf+PXRSWFhqu8CWgsPJYMpxXAH6mGSjn8Zokj4v 2fZA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1720419478; x=1721024278; 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=Nn+Yv1DSoZM/Q4z65nG43aWLTz6JCC0hBcY1DUuhNqk=; b=vN71Oa245eH8mdMlSlChniQwnMuwLwFndxM2L+VNr1I8lgT1oAGjmdMdQ4lPNhAQY+ H1CVhj3v0CiZlUlivcku8V+kCXKip0uGQyBAGGxnX80G5GEqCoXrK+K7QS9TXjaL/gxc bt1Wl+UTBW/EGEzPgIM3jhB/Jhlf1bry0RV7L4+GD4MiUCYlSrsS9k+0RtJYP21inUvl Ywv3vDHyDqwC08RktrdQVDYyYMtXVfzghnvFSrQ+qonj05C2UsUXDIMXVTcdc7z1BDS7 3aFkf8IuOaXP0zjBeLaAgSYWQztpxk9YgT7n0Tb+Kl71cINR10kkQ+agJk9hcmaZzURU 2I4Q== Sender: isar-users@googlegroups.com X-Forwarded-Encrypted: i=2; AJvYcCUK6hOuvIe9zXmgfPkEI3GYwMoKyqdvYMv5jvuobnq9UtgoJvYSisF3yNaGTe8o6bwespVhQ12i+rYMuO0eBB//WZEmaew= X-Gm-Message-State: AOJu0Yxsfrv7C0HMBGLYXCMAQ/gKsc9vzkZs4PCXQVDDIwYubcFYRmLO +DO6XPgueLIRLV/Y1o3V7inFfZBGmGNEoIe9ZF6SIRFSZrLIB3Fb X-Google-Smtp-Source: AGHT+IEX8/dWJezSs/Ka7QTEcZSZm8WVgnzjUFAI87pD6sz/pER2hXQ7C1U2gveyDzZ6PVtFLT6ARw== X-Received: by 2002:a05:600c:2d16:b0:426:5b52:84fb with SMTP id 5b1f17b1804b1-4265b528599mr55693085e9.7.1720419478190; Sun, 07 Jul 2024 23:17:58 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:600c:1c24:b0:426:67f1:ab2d with SMTP id 5b1f17b1804b1-42667f1bd30ls2709355e9.0.-pod-prod-00-eu-canary; Sun, 07 Jul 2024 23:17:56 -0700 (PDT) X-Received: by 2002:a05:600c:3510:b0:424:aa83:ef27 with SMTP id 5b1f17b1804b1-4264b0c5393mr98305225e9.1.1720419476450; Sun, 07 Jul 2024 23:17:56 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1720419476; cv=none; d=google.com; s=arc-20160816; b=ivUEFs+kukrsBtJ+4joZ1Luf/8fafPDfRBMYXdUubeiq0Sni9VDx0uVton2eLGoaVa w4NlIPJvfYqJHKRzGtHDkWXnO0TK+DabWDLJqXM3cQ8yKJ59N2nYKLGPbukl1CbhMsmN hHFdubLBfDmVMSku32MnrJKVqurvK7qbWbVhRnepcocN4kGWiXaGVgoSwIechTvzE9B7 aIfUlWOWGGONvQy5XrjZ/6GxFLFDHzrcM544C1SsAizuayJP+8LhxnBe9rzVTx43Ja2n jGhLmix9SZgvdfOZoaVKXrfNKOY9A2Y4ZnRf5aMOpWF6rz4AgjNMAo9yQf0Ra4fpUCkS hPwQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from; bh=BeEF2Nxzmm9+xvUdvNprhcPi5wLiRAU0ezaVIGWeyhA=; fh=/h9QQkzJ8EboVkWg45aWwpaUro6WMavIVd2OhN45RtE=; b=QU4YX1Q6EB8dBMKljtS9S0XemCB+N3JlbD3AkjugM0t1a4n+CM26Z3qPcuPjjUNv0y jy4QKdd/eUVukDQB+2/e7ksg/TOaWFbPLO4y8gktCH0jaR056DmFHjB2mMGiW8MRsfjs kVvBraqpB8oDNqNsCmIaZCjKUuH+1RZplKCKpzTDZr7dW3Y4ZsfhEVeRWCZAxmbc2ekQ 79oD9IiEqvm+6W+YWS8IuTxuOuDiYHIr6zZ/uHz7RC1qRCcbhVN0KoOWnC1J3M6adVKu 2WjIYcV+7Thved9RpgC6QsIdS5ylIb43ZnVvcBZlRrXZXVFql4Zr5QS6EoUP2II8leJh +POw==; 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 5b1f17b1804b1-42661583512si2510275e9.0.2024.07.07.23.17.56 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Sun, 07 Jul 2024 23:17:56 -0700 (PDT) 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 4686HmV0030688 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 8 Jul 2024 08:17:55 +0200 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v10 8/8] user_manual.md: Update boostrap related documentation Date: Mon, 8 Jul 2024 09:17:38 +0300 Message-Id: <20240708061738.311938-9-amikan@ilbers.de> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240708061738.311938-1-amikan@ilbers.de> References: <20240708061738.311938-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_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 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 ```