From patchwork Fri Jun 14 11:34:25 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anton Mikanovich X-Patchwork-Id: 3611 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Fri, 14 Jun 2024 13:34:50 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-lj1-f184.google.com (mail-lj1-f184.google.com [209.85.208.184]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 45EBYnV7032143 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 14 Jun 2024 13:34:49 +0200 Received: by mail-lj1-f184.google.com with SMTP id 38308e7fff4ca-2ec063ce179sf15969551fa.0 for ; Fri, 14 Jun 2024 04:34:49 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1718364884; cv=pass; d=google.com; s=arc-20160816; b=VLfL36BoNeM/fE2xSgHA7Mn66I2RlLrGuwsR2oie0X5WYscOysOo3ANnPP3bxFBetj p9zZtaeMpCxNhjrtGynF9qy5CDnkLiWJ8z1kV8vFx83+PoJ1kI8B/OgCWWePyrtObMBJ Fyyq7Q0krQNRdgEQUCk3Fo2gnLzTPtSIguKJ093o42MJnj0LSUa2B8GLo9EV48Qlgswm Xriqhr7X5ohKUXi4GBjRPvc9rjqbH+UmAd9QoD3VyknUb8QsUmaTc6GmnHNv3piSZ9OG e3O71cFf+JdTcJoOHc+/1yXYgMrvrTHbrPgZLls4f66AeNxOBMMWfKMrOvqzFIrDbkhd O9Ng== 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=LXyjU/oqM2vxjCPnzHFGPYeBNqdErYN+2oRZsnozntE=; fh=hbhuJPGHkoTBR0pitoqu2FWCNzqwtznmONu2A2wYhFQ=; b=jlEW+64tenBxMAAdnHdU3hru6gfiWlTzOZfp7ZlO3bn/UdOgm++/j2yDdTHrPdirLM sWm/lmgflzjx+sJJ3DN21NctzBVkmTb+NGCz20IrE+v/N1qW+cfSb89P1SVSGXHw0gqt GjYq2A/JS6q8zm0xKbuxMs61+tLa6NcbBT7/djmZ4vccVUPT+3HAbVqreJYC4pDDqyKB bQJPTYLCyamMRpAGsAGbg7lp+fmCbGKx5hGvmbHJc7A2Uh5RGQO3aRSosp02qDhPFIss AurZLM5ohgcWdbeiYGKaN6mX3CXia4iYiCYd4y9lkEn8nE7n0RQzBKDn46Ly4Yq0JuG4 tQug==; 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=1718364884; x=1718969684; 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=LXyjU/oqM2vxjCPnzHFGPYeBNqdErYN+2oRZsnozntE=; b=Dbe/QrfxeoFYP93+K4LPR/ZwlU4cdd668AH/Aqhj9yOnL1iTR44QGNVWilEzTEvTVy 6xuZpto5uxJ29ou4GcAvFlLJsy+G2EUWZ6fovCFzdmKS4Nnje3ad8tRsyhYhPVx+BfdV /E0vcbVkd6/P/n0kNmkEqtbMJSMaIwrRsJC5pdmkH2SB1BJOl5la5NUa8S2HEmInloRt DGkrh/4TWnaRhM18aZgjpIVsZMtJR4IaKX9OopGy8Vvc/ghohs8BEgDPCnFm4vBdtCU/ 6ympmQhVgX8gFc/bfx3oOa37K+OIh94jVlea2e+ArFNgB7Alc7rqe7RDUbL2Gtc1HtCA dLOg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1718364884; x=1718969684; 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=LXyjU/oqM2vxjCPnzHFGPYeBNqdErYN+2oRZsnozntE=; b=P778sBGmfPnNwiFdc4eh0+5JCHeL4IitFQacG/ZQllGP/lHiu45hNeghE9OmAKwgZZ h+fCQ1IGnGt/EYFo3F2xkuv4gEqmRBJInssD96fmcUe8oot9kI0iCLx79O6l1Ld6iXuh dbaj2GQnkfNro/g830ZerxPxNRYUvIHH6W03RCSVrwzn2UzdQI4su75LDi08gIEvwf7l D5mO1/XLbXBjDEsjSg1K0tWJcMMwp6/Zy90Zdmsc33MrwcgyDNb/u3f1CMjO0VyWalhz OhBsEjj4xwZkTPUMs0X07IzeDY1UhVuibldu4w8dk59vsjv4Xiz/bgak5Uey5M1dI2+p Y/gQ== Sender: isar-users@googlegroups.com X-Forwarded-Encrypted: i=2; AJvYcCXKgPhNMHASsn8KR8JEjaSXbPKtLFiYg4tNfyY7RUxhGd/nJ6uSIIXu7i3Mz2HgV9X0NseOuv6y3d722CRdKA4lWhMVq+0= X-Gm-Message-State: AOJu0YzZZGn23B3o5jhLzJlb5RJDBl0nESEkgLY5+hycHRXYVbedsehj PmclJR8E7Ynf83eglva7Aq4rDd03B/CebeZcjwoL/usgnj696GFO X-Google-Smtp-Source: AGHT+IHZD81UcFRTlNv4zjZQI36JjV0vBJA7F7+3oawTaR5ZKsH3U/8INCWLGb1yJIFCamvJrUoNNg== X-Received: by 2002:a2e:96cd:0:b0:2ec:17a9:ce9c with SMTP id 38308e7fff4ca-2ec17a9d142mr11560241fa.47.1718364882776; Fri, 14 Jun 2024 04:34:42 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a2e:81d4:0:b0:2eb:e49e:d605 with SMTP id 38308e7fff4ca-2ec0284bfe6ls11543051fa.0.-pod-prod-05-eu; Fri, 14 Jun 2024 04:34:41 -0700 (PDT) X-Received: by 2002:a05:651c:8e:b0:2db:a9c9:4c5e with SMTP id 38308e7fff4ca-2ec0e482856mr19818061fa.21.1718364880759; Fri, 14 Jun 2024 04:34:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1718364880; cv=none; d=google.com; s=arc-20160816; b=dBMAu09GsclrthdzwULnPAycpOXTfS0cc1t2NKCg70miJkWOPYkTzb55xj/FEw176I GS1Crc7vXj3yM5PkpsNzub461Vn0eEJTGJlUBl0Sps/dftnqSbMU9HmMhCqt9swK9x4T HpUQG7BzewzBSiU4oCfepoyC1M5H9JGxI9DYoDzcxX9MlBNDLsVNaR3X/SYjhbtDj69M 4ec3kvntyRZvB0w/Bbbk51fLSByZvR3hrS+uxNVjQgkVAYeRG+HW/HsP1k4xtt3KE6on t//FpFpuzK720x+3Lj7oMEN4ELGrdnSpCD/tbw+nytDvyxeZ5fxSXiu2pGA4w8hpm0fo lWAw== 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=lvwF6WKv3P8yYcwuDcop6W4F//6PVxPP1jXGzzC+HQA=; fh=/h9QQkzJ8EboVkWg45aWwpaUro6WMavIVd2OhN45RtE=; b=DxPJ4+iAXpdYw1VRDOkPq0/Y4sypDyvpY/2E0RNiNyY1XtU5yxLXgq8otyMblXkEts Gi+UUb+EHp+1T5VGgmSBq7ZfsCk9aRqQZyQOW8FLzitpc5faedK0jyoLyRhc6avFcTOJ WVdep6VgwTfnu+9xuThkx26mgkkZpRfEHdeWPpBRWcbtlZWB7GudosXPTtP7nyWqbK5M y/UfT6B76DkvW/b+gYxoQxE6tjAqd3DQJGw73YZ1JU5FMlDuC51T7Chcr+y3bjsHwwOJ abUTIfaL9SuWlplwQXr+2KbAAawD7HLthrK9ggs9QFZGLyFg+15ohdXO51fatBF+7pyE AoLA==; 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-422874def6bsi1185705e9.2.2024.06.14.04.34.40 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Fri, 14 Jun 2024 04:34:40 -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 localhost.localdomain (r154-240-38-77-broadband.btv.lv [77.38.240.154] (may be forged)) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPSA id 45EBYZP5032043 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 14 Jun 2024 13:34:40 +0200 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v9 8/8] user_manual.md: Update boostrap related documentation Date: Fri, 14 Jun 2024 14:34:25 +0300 Message-Id: <20240614113425.122722-9-amikan@ilbers.de> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240614113425.122722-1-amikan@ilbers.de> References: <20240614113425.122722-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 b12c7692..d3b41ae8 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 ```