From patchwork Wed Sep 27 04:33:19 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Uladzimir Bely X-Patchwork-Id: 3141 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Wed, 27 Sep 2023 06:33:35 +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 38R4XYUc022043 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 27 Sep 2023 06:33:34 +0200 Received: by mail-lj1-f184.google.com with SMTP id 38308e7fff4ca-2b6fdb8d0acsf28959041fa.0 for ; Tue, 26 Sep 2023 21:33:34 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1695789207; cv=pass; d=google.com; s=arc-20160816; b=XfM8m0vg8Te1/yZS793EgPTsi1on2qoZalt38YF4Vi36GoH0uBOojhL6oezOwRwsQx dM1K9HiJ9Ofnp61vMbnrAFyX0IT/D6OksTHWllxM2SZuCaTIxzGvG7tBbsr29OdXstIN GDQpCaWH7nJ4E+3ZBj2K3m9PvFmtXIaFFPyRv6DZlHExcNlhjmS+wwH0hGfJFBrsujGT vB+mX/cV5mmJBVyQwxBqy7W5AGPgD6OnPFgkkJ6edbD7SbTKri3BXt2jD/7LkUzxnl18 wkFqlS4+KJOxX/AjnlqSWdNbQYd+3McedB9YbZqbGae+ZLR6jFJx1vkCSryGMSyaHvxy DgbA== 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:to:from:sender:dkim-signature; bh=3r94B7jLDzjafVXqUe2nx7NOIv7Blt4Hh0U2ZTBVSW8=; fh=7tclEdh7YbwSQowgJ6LNq720O7H5HTEaqj22NJWRE2E=; b=RHw34YV+Il+wfz3txIZ+kY5xqADsZNm+gk4IC68KAZe6LkJI3kEUG4FDNU1Lqr2yy0 ZP9L7K3mqjxKHeiIjSRDU1QSLo1SRAap6XaBtSiUgiyB1SqTQpJ6SomsuQg3gCSHdW3W AWbwK6RiX4VPq54XNCI1aQ7ikLaL20wazFh3I69sdmwCsgtam3ODLCCWLjpSICB6aV0D pEqs8jvANoDGDZU4h+3H/cuo2/+G8sibnmBnXSlaekWV1CFHKZGYMWdkYU9wufKFV7+o KEMfbs4jq6agPjvwzzOoj+puv94eOVd/4/02jObhBDKhV9gybOCPwrz+sgPWxBhOiCXV sMWw== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20230601; t=1695789207; x=1696394007; 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:to:from:sender:from:to:cc:subject:date:message-id :reply-to; bh=3r94B7jLDzjafVXqUe2nx7NOIv7Blt4Hh0U2ZTBVSW8=; b=LrNz83Z3aDFJHqwkGIDP4rq8r9xO/u29qHYRjw0t1wwe47b6y3rFNrWletjliKApse N2DHYgxRBDneOHMxvnWg2UR0zMciY5hQ0DBbxAJt8q5lnh8vJyPiDMghQRuhpDTVwl95 a2sip4vjoAyTv61fhRKSsO+9s0S2GOFcvk3kD2BgMsQ1BhdHntOdXUV4iKllpPUJSKyW hNpVBAaYGErLnXXGIeOo06M9SeDrBJL3d4HwtRy8FMsMNC9MR1Og9VMfwrbFNCFMYpiD VTtLAtqL0ApBAJ+iurX92adKwk8E7NG1BB0WAGxVLWHOc/AmMOOBYOWRwGobA5fxKGiy 2npg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695789207; x=1696394007; 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:to:from:x-beenthere :x-gm-message-state:sender:from:to:cc:subject:date:message-id :reply-to; bh=3r94B7jLDzjafVXqUe2nx7NOIv7Blt4Hh0U2ZTBVSW8=; b=vlPBwPu+Ngtlr7+EsOeCNEUdYWoGObZl644OQEUtfL2PLOD+pSmGZ8i7mWXJ5PPiCg EcpRu0wVz5ULThjtZpYhKdOwJvLdDmSHD7Fz7c3Xu7L0IoCg74yKF6Fzn+MUfQslzcup BGDr8glJHG2o9DbpUE61fgBqxiXDO7Heg3+xajqz4zhRQ7DgmMsFv8muF88fDIkPvZxZ GnHte4qyGS6YUW+atDfA2pYEYotnXBmLM6NobZ+HzmLJllbVhez5K6oQ11RJW2pyxSsL CJkc+SGMcaz3hxf8t/GL8oPk2Vdg/myx/RKbbfWA+yzvIvByEBYBx0TVxJbJlPqJ87fE YLDg== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOJu0Yx5Mnn2FqLVn1V85AyN4c28kga7+0nLmgMOjkpo5Fi5HejmQ9I8 idtvih5SsWIa+3nX/tro7Wg= X-Google-Smtp-Source: AGHT+IGAZAPaD4rPkdkEt2EHaaxPRkHq+fLRTQ7wst3ikMuSGChUbE2iuL24NDkIN8KJpqssbMe1iw== X-Received: by 2002:a05:651c:1034:b0:2be:5485:4a99 with SMTP id w20-20020a05651c103400b002be54854a99mr794794ljm.4.1695789205733; Tue, 26 Sep 2023 21:33:25 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a2e:bcc4:0:b0:2bf:f477:198c with SMTP id z4-20020a2ebcc4000000b002bff477198cls4196ljp.2.-pod-prod-07-eu; Tue, 26 Sep 2023 21:33:23 -0700 (PDT) X-Received: by 2002:a05:651c:218:b0:2bd:133c:2d71 with SMTP id y24-20020a05651c021800b002bd133c2d71mr835608ljn.52.1695789203628; Tue, 26 Sep 2023 21:33:23 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1695789203; cv=none; d=google.com; s=arc-20160816; b=Gu6F2YY4I26B2Ash0u2xunKixgpBGdR47Szf8MKvkgsAJ7VuNxuIBRMQFtQcYSqs7W 97bzWzgVjnuKfRJqsSymldqS9sMbEo3oz4OxIxhoH9XkBc+W88RwpmA6hbwDy+ohGr5U xlvDdKEIF+CVwjryC6VXKZk878t+qqYc4i5lqtW99nl0pEe8blMKQxZ0dd0fYxq+GyfN eh74tBe3dCnwTOZtm5sP/H9Dr8UETZ1zPSaDynxbngW96ywZkqAALy5w+WFrNVjF08+B CNz9sqx2Zcf9Cq589K4fjz87HxgN/B4GY18KOf1iY8cvOWgNhrA3ORPFimSAFKt7Qc5V sLEA== 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:to:from; bh=3QqEdqH70IxgsAEllZ7tsWRWak8UN0Dpz2tqmapAX+s=; fh=7tclEdh7YbwSQowgJ6LNq720O7H5HTEaqj22NJWRE2E=; b=LduQoDMMQVmWXbLIYb9sfrxCti/pzXNKJ1MkQStVo2+Y0w8U/t+43XwnbTcF09Cgtz yQyRIFEp6XwkBYPsx/zgFn4axRUqt/gXF48geBfwJfyhgCxSMmh2mbdzc9AoOA6GzW+C ZfNIzr35u6nkESidpSt02tZSOPywfBhmK/hxijMJc5AMrcrapKO1VjuFhYHHtzTSDHs3 Tnr3srDyw6LBB16y0mCEF9oo7wSVVCTUbJg9sabm3tl/SGgejo6w/pAGsfHch3OUAIbe 9AxLz4E12yTF56f6XvEodLYN7tSjS7epCkEQOQg5YRy/C0buuQ0IUud/IUA67irLGqb9 HQAQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id u3-20020a17090657c300b009adbab54deesi897024ejr.2.2023.09.26.21.33.23 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Tue, 26 Sep 2023 21:33:23 -0700 (PDT) Received-SPF: pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Received: from baighyz.m.ilbers.de (host-80-81-17-52.static.customer.m-online.net [80.81.17.52]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPSA id 38R4XKXp021959 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 27 Sep 2023 06:33:22 +0200 From: Uladzimir Bely To: isar-users@googlegroups.com Subject: [PATCH v4 5/6] user_manual.md: Update minimal host requirements Date: Wed, 27 Sep 2023 06:33:19 +0200 Message-Id: <20230927043320.6264-6-ubely@ilbers.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20230927043320.6264-1-ubely@ilbers.de> References: <20230927043320.6264-1-ubely@ilbers.de> MIME-Version: 1.0 X-Spam-Status: No, score=-0.9 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,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: ubely@ilbers.de X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@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?= From: Anton Mikanovich Using mmdebstrap requires at least Debian Bullseye on host. Update user manual with the new minimal host distro. Also remove all Buster-related notes. Signed-off-by: Anton Mikanovich --- doc/user_manual.md | 35 ++++++++++++----------------------- 1 file changed, 12 insertions(+), 23 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index dc7ed4c8..02cb471b 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -48,7 +48,7 @@ For demonstration purposes, Isar provides support for the following configurations: - QEMU ARM with Debian Buster - - QEMU ARM64 with Debian Buster (for host >= buster) + - QEMU ARM64 with Debian Buster - QEMU i386 with Debian Buster - QEMU amd64 with Debian Buster - Raspberry Pi various models with Raspberry OS Bullseye @@ -60,7 +60,7 @@ The steps below describe how to build the images provided by default. ### Install Host Tools -The supported host system is >= buster. +The minimal supported host system is Debian Bullseye. Install the following packages: ``` @@ -74,6 +74,7 @@ apt install \ gettext-base \ git \ python3 \ + python3-distutils \ quilt \ qemu-user-static \ reprepro \ @@ -87,28 +88,19 @@ apt install \ zstd ``` -If your host is >= buster, also install the following package. -``` -apt install python3-distutils -``` - -**NOTE:** sbuild version (<=0.78.1) packaged in Debian Buster doesn't support -`$apt_keep_downloaded_packages` option which is required in Isar for -populating `${DL_DIR}/deb`. So, host `sbuild` in this case should be manually -upgraded to >=0.81.2 version from Debian Bullseye. - Next, the user who should run Isar needs to be added to `sbuild` group. ``` sudo gpasswd -a sbuild ``` If you want to generate containerized SDKs, also install the following -packages: `umoci` and `skopeo`. -Umoci is provided by Debian Buster and can be installed with -`apt install umoci`, Skopeo is provided by Debian Bullseye/Unstable and has to -be installed either manually downloading the DEB and installing it (no other -packages required) or with `apt install -t bullseye skopeo` (if -unstable/bullseye included in `/etc/apt/sources.list[.d]`). +packages: + +``` +apt install \ + umoci \ + skopeo +``` Notes: @@ -234,9 +226,6 @@ Variables may be used in `.wks.in` files; Isar will expand them and generate a r In order to run the EFI images with `qemu`, an EFI firmware is required and available at the following address: https://github.com/tianocore/edk2/tree/3858b4a1ff09d3243fea8d07bd135478237cb8f7 -Note that the `ovmf` package in Debian Buster contains a pre-compiled firmware, but doesn't seem to be recent -enough to allow images to be testable under `qemu`. - ``` # AMD64 image, EFI qemu-system-x86_64 -m 256M -nographic -bios edk2/Build/OvmfX64/RELEASE_*/FV/OVMF.fd -hda tmp/deploy/images/qemuamd64/isar-image-base-debian-buster-qemuamd64.wic @@ -963,8 +952,8 @@ put into Isar apt. Debian cross-compilation works out of the box. Currently the following build configurations are supported in Isar: - buster armhf - - buster arm64 (for host >= buster) - - buster mipsel (for host >= buster) + - buster arm64 + - buster mipsel - bullseye armhf - bullseye arm64 - bullseye mipsel