From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7136107964992061440 X-Received: by 2002:ac2:4e15:0:b0:48b:3ad2:42c8 with SMTP id e21-20020ac24e15000000b0048b3ad242c8mr6842786lfr.391.1661768768799; Mon, 29 Aug 2022 03:26:08 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:651c:238d:b0:25d:9c9e:d165 with SMTP id bk13-20020a05651c238d00b0025d9c9ed165ls1464612ljb.7.-pod-prod-gmail; Mon, 29 Aug 2022 03:26:07 -0700 (PDT) X-Google-Smtp-Source: AA6agR6N86+6oJbbO1QH4HVk9SVzLcU5gndMInP9860N17TGZlX1N+BgXGH/B+gEy62vTHhB+HDy X-Received: by 2002:a05:651c:1044:b0:261:dfbd:c433 with SMTP id x4-20020a05651c104400b00261dfbdc433mr5827125ljm.391.1661768767175; Mon, 29 Aug 2022 03:26:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1661768767; cv=none; d=google.com; s=arc-20160816; b=zcLwf058uDhDcNVrDhzofgWieAWhJWTFvgJHsA02Jc4qKaz6zuJPK3VlvzF+ZsyCTI FT/YZlD9JT8YiZeFVv8ER7pTS38hR8vfGRJplIZA/z82UJikqqNsxWXlnl897m7PCApX cN+pkVR6MFerckj2JsyYQk/9Toef3q2AfoQNVRL4IHpuionTcIDQrKkF61hXVEMi/tZ8 OM8B2R+PgR1Cr8/IL9n2fTPQdviEWV8zt3K0iKQleUxBMhdDTdhSBb3YMUGUMVq3Snz8 0HcHxXFIkFczIdbxg15qqZSPX7JL2kWfCY7T0irTLhkH8c/U2ddZ9D8exknoPV2q/1g3 rQ+A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=in-reply-to:from:references:to:content-language:subject:user-agent :mime-version:date:message-id; bh=z5xKQM7a5guGVWJIFcrYAJmuXLuP0qqBpkBYd5bd7Og=; b=Jf7caH2OpygAt365Ir/od089iUCE0wYfmd/JMFzidqKZqe9CRiMwdYmF1dvJcId+Gg dJyY4GbsxNTN3+nBZwhL87aRHM1vwjZ3RSB7hKF+jO45Bt1GzGNkgMj/NTm6UvKWF0NX KuvDPUVNFrW+JyE9niPauGTp1JWyYAAOZwRPx45OmBoT7o69HlMwVgckiJo4afLrJXbP 6W2jGe04FZ4hWjLEG7IX4w3p4nriOlmB8enMeQ6irTqNTdNjR+rgkynqevkPxz2o3ku5 Z3e/8pNUAcDHCcGQilxZs+qfhwRBUuUm3hgWoqaJiI1i3Pp5T5pMYOBEP/HAxa9bxVqu xi7A== 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 u21-20020ac258d5000000b0048b33ac1b9csi351425lfo.1.2022.08.29.03.26.06 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Mon, 29 Aug 2022 03:26:07 -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 [127.0.0.1] (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 27TAQ4xf022294 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 29 Aug 2022 12:26:05 +0200 Content-Type: multipart/alternative; boundary="------------FdCq9nJYI5yRFjGYWR1T1bT7" Message-ID: <019dfeef-2eea-6077-181c-705433134124@ilbers.de> Date: Mon, 29 Aug 2022 13:26:03 +0300 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.11.0 Subject: Re: [PATCH] doc: Rework description of build dependencies installation Content-Language: en-US To: Jan Kiszka , isar-users References: <2fd9b2b0-72ec-ac67-1f4c-42fc38589a07@web.de> From: Anton Mikanovich In-Reply-To: <2fd9b2b0-72ec-ac67-1f4c-42fc38589a07@web.de> X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED,HTML_MESSAGE 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: yhcFLa6bo20j This is a multi-part message in MIME format. --------------FdCq9nJYI5yRFjGYWR1T1bT7 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit 26.08.2022 12:03, Jan Kiszka wrote: > From: Jan Kiszka > > Fold in sbuild and schroot packages so that everything needed for > building is in one list. > > Move qemu out of this list because it is only optional. > > Reorder the note about adding the user to the sbuild group so that it > introduces the related command. > > Signed-off-by: Jan Kiszka > --- > doc/user_manual.md | 24 +++++++++++------------- > 1 file changed, 11 insertions(+), 13 deletions(-) > > diff --git a/doc/user_manual.md b/doc/user_manual.md > index 546ae75c..5b2387d8 100644 > --- a/doc/user_manual.md > +++ b/doc/user_manual.md > @@ -78,37 +78,30 @@ apt install \ > parted \ > python3 \ > quilt \ > - qemu \ > qemu-user-static \ > reprepro \ > sudo \ > git-buildpackage \ > - pristine-tar > + pristine-tar \ > + sbuild \ > + schroot > ``` > > -Additional setup is required since `sbuild` is now used for package build. > -Install the following packages: > +If your host is >= buster, also install the following package. > ``` > -apt install \ > - sbuild \ > - schroot > +apt install python3-distutils > ``` > -Also, user who runs isar should be added to `sbuild` group. > > **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 your host is >= buster, also install the following package. > -``` > -apt install python3-distutils > -``` > - > 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 > @@ -129,6 +122,11 @@ Notes: > handled by QEMU (check e.g. `qemu-arm` in `/usr/sbin/update-binfmts > --display`). > > +To run images built for QEMU, you also need to install the related package: > +``` > +apt install qemu > +``` > + > ### Setup Sudo > > Isar requires `sudo` rights without password to work with `chroot` and `debootstrap`. To add them, use the following steps: > -- > 2.35.3 > Hello Jan, How did you generate this patch? It looks like some endline whitespaces were missed in the end of the first chunk, so the patch became inapplicable. There is no need to resend this one, just wanted to warn for the future commits. --------------FdCq9nJYI5yRFjGYWR1T1bT7 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 7bit
26.08.2022 12:03, Jan Kiszka wrote:
From: Jan Kiszka <jan.kiszka@siemens.com>

Fold in sbuild and schroot packages so that everything needed for
building is in one list.

Move qemu out of this list because it is only optional.

Reorder the note about adding the user to the sbuild group so that it
introduces the related command.

Signed-off-by: Jan Kiszka <jan.kiszka@siemens.com>
---
 doc/user_manual.md | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/doc/user_manual.md b/doc/user_manual.md
index 546ae75c..5b2387d8 100644
--- a/doc/user_manual.md
+++ b/doc/user_manual.md
@@ -78,37 +78,30 @@ apt install \
   parted \
   python3 \
   quilt \
-  qemu \
   qemu-user-static \
   reprepro \
   sudo \
   git-buildpackage \
-  pristine-tar
+  pristine-tar \
+  sbuild \
+  schroot
 ```

-Additional setup is required since `sbuild` is now used for package build.
-Install the following packages:
+If your host is >= buster, also install the following package.
 ```
-apt install \
-  sbuild \
-  schroot
+apt install python3-distutils
 ```
-Also, user who runs isar should be added to `sbuild` group.

 **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 <username> sbuild
 ```

-If your host is >= buster, also install the following package.
-```
-apt install python3-distutils
-```
-
 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
@@ -129,6 +122,11 @@ Notes:
   handled by QEMU (check e.g. `qemu-arm` in `/usr/sbin/update-binfmts
   --display`).

+To run images built for QEMU, you also need to install the related package:
+```
+apt install qemu
+```
+
 ### Setup Sudo

 Isar requires `sudo` rights without password to work with `chroot` and `debootstrap`. To add them, use the following steps:
--
2.35.3

Hello Jan,

How did you generate this patch?
It looks like some endline whitespaces were missed in the end of the first chunk,
so the patch became inapplicable.

There is no need to resend this one, just wanted to warn for the future commits.

--------------FdCq9nJYI5yRFjGYWR1T1bT7--