From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7291218501940805632 X-Received: by 2002:a2e:a9a7:0:b0:2c5:18ed:180a with SMTP id x39-20020a2ea9a7000000b002c518ed180amr8644859ljq.33.1698128655262; Mon, 23 Oct 2023 23:24:15 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a2e:b5c6:0:b0:2bc:b6ef:c3f4 with SMTP id g6-20020a2eb5c6000000b002bcb6efc3f4ls283498ljn.1.-pod-prod-07-eu; Mon, 23 Oct 2023 23:24:13 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEPYustEvUte3Fych0iC4LohiIa3pViPvPdjKiw7Yf3A+jb7AeBhArZMREbABLJPlLSsVWk X-Received: by 2002:a2e:9819:0:b0:2c5:234b:d1eb with SMTP id a25-20020a2e9819000000b002c5234bd1ebmr7235575ljj.50.1698128653135; Mon, 23 Oct 2023 23:24:13 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698128653; cv=none; d=google.com; s=arc-20160816; b=jSYQ80cuon2pLgCz3oodO4q4yyWJLnRXcCCkHG7+Z68j2Q8C2lZsSCVWNYEpak1/dP GuHz8olvu1/BQGdy6vtSlFOfiW/8Q+WRXZNm0z0zdNJ3qlinJUgQUsLe0PjxFc/MGe57 ZJq30kJTSbMlUu3mOfxp25HECvB90JPHTQ6/Wn7b60yNIPl4+Uu5meYuaA9rrIK9KOcT /kjEjGtSGGpnlAhKbg9hfy+p/1X+NTdqEzxDGud4WEpdEzBff0A/uYZ9kI4mmo78ci+P kX/L8LyelYIdv2DBvAkVrCowSQyIhXpKskChG4N3PheU2bkff1prMWNJ7IE6rGhP/502 Owwg== 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=yI1OqREYwSwCngNwxZLEfxLedaEp1zrUVGU1x1I90DM=; fh=/h9QQkzJ8EboVkWg45aWwpaUro6WMavIVd2OhN45RtE=; b=rbrCcf4G2/0kFLxLV9hrrfFzBC/Zbg9dSIqObq4oM1R3V5zWX3nCvUEmU9UWoHNImQ AjQct6Yw5kYIhoX9O8xSJDvs8YAnFNTb7lG5D71FhsnB+artBa348fv1XM/+1T8CvHpv bQGB/gfXIfEFf3akIsRnfvQYQuSS0v6ipL45NL8mH5pzZEyi/svitFG/ifxbBFOURQv1 G/3gD5Z7ikQfvKqJ54QGcTgY0gb6zyEzhLwmEcSQHegAaISDCMg+/aAXbB2QGpAMJGHI uGDCpv5rd2hP/KiWRJVKlexRqLVamSUoZruAT34syw/hWMlfsJ+eRg/4C8U+HrJTPy4e Zw9A== 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 Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id f17-20020a2e6a11000000b002bced4ef910si304650ljc.3.2023.10.23.23.24.12 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Mon, 23 Oct 2023 23:24:13 -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; 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 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 39O6O5WD024986 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 24 Oct 2023 08:24:11 +0200 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v6 6/8] user_manual.md: Update minimal host requirements Date: Tue, 24 Oct 2023 09:23:56 +0300 Message-Id: <20231024062358.252053-7-amikan@ilbers.de> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231024062358.252053-1-amikan@ilbers.de> References: <20231024062358.252053-1-amikan@ilbers.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED 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-TUID: KlA8CV8LEikg 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 6cbff8cf..512721c9 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 -- 2.34.1