From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6719774909718855680 X-Received: by 2002:a1c:7f08:: with SMTP id a8mr62290101wmd.1.1564569517400; Wed, 31 Jul 2019 03:38:37 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a5d:4907:: with SMTP id x7ls19253923wrq.0.gmail; Wed, 31 Jul 2019 03:38:36 -0700 (PDT) X-Google-Smtp-Source: APXvYqyzUDOkj0yqYfm5zYmHW1q59/HskB/XSXUN1Vu/qr00KdubRh+uJHnGlyNUPH3v+EWBLfWI X-Received: by 2002:a5d:53c2:: with SMTP id a2mr56736780wrw.8.1564569516953; Wed, 31 Jul 2019 03:38:36 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1564569516; cv=none; d=google.com; s=arc-20160816; b=JdRAzssaAxNWNdn1x2IvUmyx/GOC8easEkotN2B2w+RYTBzFtiHTpOSUJjsdIzpPA5 C5nqyLBxwjxz1/ZPr/M/i9zF2wCTG87IJ1Tv6ktHHUwP3yFIwOQh734wj3hgjhYQdNf+ yishA/M5R5Wk73tGmFRr1mfiL4Hrq7A3TrjFHL3zgaTrV9uhWB8+fMzlUovHoBRDYZ40 sEobxd1iuwbFsvNDzKLyYA4pPkXPfH8S48LYbkk4p44mIBrWjmc8KkzJJzLBA9ntQ3Rt wGD/MyftiqZK6wCaHZXQL9Iai9nhDRhbuwvzFTYbFSwd2f0iXLT1t02s8KgEPyyqtwrZ W42Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from; bh=cmDQqYs7/EOfNfAHTwC4zPTn4JloYNHHHix4sT8dY4U=; b=R3xnZTySfIWzomSXO+jsz1BaYQ8/T4ZWF4H3yDwg6VIBE1zDuPKYN8fpJ9y24ElY3t O8tLgSueqlG3KW6eXaBLJXixr+ykx2ncNjarBzJG1zW1Z+LrfYR+Pf6kdwRUpwPUWT1W R4PGWx/YFvUMsynxqEIUUVnCbTlKDPAXvbCr/P7Dfpe6nLu28H6RIq2owyhG5hv6GPDo XUu1bMwbF8VfAWoH7ppyALcYI5Pk1j7/IW+jUdpppyCES2dGPYSnVVUhH13d4CkGkOSL jNlJoaBierHWXBplvKbnmJlfxXCGYhiEiAcGYcK7RBdE/4/pXLrVhPkaB7ApJxkXy46y y4Pw== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of henning.schild@siemens.com designates 192.35.17.14 as permitted sender) smtp.mailfrom=henning.schild@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Return-Path: Received: from david.siemens.de (david.siemens.de. [192.35.17.14]) by gmr-mx.google.com with ESMTPS id o4si341220wrp.4.2019.07.31.03.38.36 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 31 Jul 2019 03:38:36 -0700 (PDT) Received-SPF: pass (google.com: domain of henning.schild@siemens.com designates 192.35.17.14 as permitted sender) client-ip=192.35.17.14; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of henning.schild@siemens.com designates 192.35.17.14 as permitted sender) smtp.mailfrom=henning.schild@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Received: from mail2.sbs.de (mail2.sbs.de [192.129.41.66]) by david.siemens.de (8.15.2/8.15.2) with ESMTPS id x6VAcasE025438 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 31 Jul 2019 12:38:36 +0200 Received: from md1za8fc.ad001.siemens.net ([139.25.0.71]) by mail2.sbs.de (8.15.2/8.15.2) with ESMTP id x6VAca8u026606; Wed, 31 Jul 2019 12:38:36 +0200 From: Henning Schild To: isar-users Cc: Henning Schild , Henning Schild Subject: [PATCH 1/3] doc: make buster the new default suite Date: Wed, 31 Jul 2019 12:38:33 +0200 Message-Id: <20190731103835.21656-1-henning.schild@siemens.com> X-Mailer: git-send-email 2.21.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-TUID: cYD/dbKxe8rL From: Henning Schild Buster is the new stable release. Mention it in the docs to clearly state that we support it. And tell users to choose it for their next image. Signed-off-by: Henning Schild --- doc/user_manual.md | 38 +++++++++++++++++------------------ meta-isar/conf/conf-notes.txt | 4 ++-- 2 files changed, 21 insertions(+), 21 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index ed181aa..a301740 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -128,22 +128,22 @@ e.g.: ``` MACHINE ??= "qemuarm" -DISTRO ??= "debian-stretch" +DISTRO ??= "debian-buster" DISTRO_ARCH ??= "armhf" ``` Then, call `bitbake` with image names, e.g.: ``` -bitbake multiconfig:qemuarm-stretch:isar-image-base \ - multiconfig:qemuarm-stretch:isar-image-debug +bitbake multiconfig:qemuarm-buster:isar-image-base \ + multiconfig:qemuarm-buster:isar-image-debug ``` The following images are created: ``` -tmp/deploy/images/qemuarm/isar-image-base-qemuarm-debian-stretch.ext4.img -tmp/deploy/images/qemuarm/isar-image-debug-qemuarm-debian-stretch.ext4.img +tmp/deploy/images/qemuarm/isar-image-base-qemuarm-debian-buster.ext4.img +tmp/deploy/images/qemuarm/isar-image-debug-qemuarm-debian-buster.ext4.img ``` ### Building Target Images for Multiple Configurations @@ -197,9 +197,9 @@ tmp/deploy/images/rpi/isar-image-base.rpi-sdimg A bootable disk image is generated if you set IMAGE_TYPE to 'wic-img'. Behind the scenes a tool called `wic` is used to assemble the images. It is controlled by a `.wks` file which you can choose with changing WKS_FILE. Some examples in the tree use that feature already. ``` # Generate an image for the `i386` target architecture - $ bitbake multiconfig:qemui386-stretch:isar-image-base + $ bitbake multiconfig:qemui386-buster:isar-image-base # Similarly, for the `amd64` target architecture, in this case EFI - $ bitbake multiconfig:qemuamd64-stretch:isar-image-base + $ bitbake multiconfig:qemuamd64-buster:isar-image-base ``` Variables may be used in `.wks.in` files; Isar will expand them and generate a regular `.wks` file before generating the disk image using `wic`. @@ -212,9 +212,9 @@ 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-stretch-qemuamd64.wic.img +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.img # i386 image -qemu-system-i386 -m 256M -nographic -hda tmp/deploy/images/qemui386/isar-image-base-debian-stretch-qemui386.wic.img +qemu-system-i386 -m 256M -nographic -hda tmp/deploy/images/qemui386/isar-image-base-debian-buster-qemui386.wic.img ``` --- @@ -303,7 +303,7 @@ following variables define the default configuration to build for: - `DISTRO_ARCH` - The Debian architecture to build for (e.g., `armhf`). If BitBake is called with multiconfig targets (e.g., -`multiconfig:qemuarm-stretch:isar-image-base`), the following variable defines +`multiconfig:qemuarm-buster:isar-image-base`), the following variable defines all supported configurations: - `BBMULTICONFIG` - The list of the complete configuration definition files. @@ -708,7 +708,7 @@ One may chroot into the SDK and install required target packages with the help o - Trigger creation of SDK root filesystem ``` -bitbake -c do_populate_sdk multiconfig:qemuarm-stretch:isar-image-base +bitbake -c do_populate_sdk multiconfig:qemuarm-buster:isar-image-base ``` - Mount the following directories in chroot by passing resulting rootfs as an argument to the script `mount_chroot.sh`: @@ -726,14 +726,14 @@ mount devtmpfs $1/dev -t devtmpfs -o mode=0755,nosuid mount devpts $1/dev/pts -t devpts -o gid=5,mode=620 mount tmpfs $1/dev/shm -t tmpfs -o rw,seclabel,nosuid,nodev -$ sudo scripts/mount_chroot.sh ../build/tmp/deploy/images/qemuarm/sdk-debian-stretch-armhf +$ sudo scripts/mount_chroot.sh ../build/tmp/deploy/images/qemuarm/sdk-debian-buster-armhf ``` - chroot to isar SDK rootfs: ``` -$ sudo chroot build/tmp/deploy/images/qemuarm/sdk-debian-stretch-armhf +$ sudo chroot build/tmp/deploy/images/qemuarm/sdk-debian-buster-armhf ``` - Check that cross toolchains are installed @@ -790,7 +790,7 @@ BASE_REPO_KEY = "file://"' - Trigger creation of local apt caching Debian packages during image generation. ``` -bitbake -c cache_base_repo multiconfig:qemuarm-stretch:isar-image-base +bitbake -c cache_base_repo multiconfig:qemuarm-buster:isar-image-base ``` - Set `ISAR_USE_CACHED_BASE_REPO` in `conf/local.conf`: @@ -809,7 +809,7 @@ sudo rm -rf tmp - Trigger again generation of image (now using local caching repo): ``` -bitbake multiconfig:qemuarm-stretch:isar-image-base +bitbake multiconfig:qemuarm-buster:isar-image-base ``` ### Limitation @@ -830,10 +830,10 @@ Add a new sources list entry to fetch the package from, i.e. include a new apt s Add docker-ce from arm64: -Create a new layer containing `conf/distro/docker-stretch.list` with the following content: +Create a new layer containing `conf/distro/docker-buster.list` with the following content: ``` -deb [arch=arm64] https://download.docker.com/linux/debian stretch stable +deb [arch=arm64] https://download.docker.com/linux/debian buster stable ``` Include the layer in your project. @@ -843,11 +843,11 @@ To the local.conf add: ``` IMAGE_PREINSTALL += "docker-ce" THIRD_PARTY_APT_KEYS_append = " https://download.docker.com/linux/debian/gpg;md5sum=1afae06b34a13c1b3d9cb61a26285a15" -DISTRO_APT_SOURCES_append = " conf/distro/docker-stretch.list" +DISTRO_APT_SOURCES_append = " conf/distro/docker-buster.list" ``` And build the corresponding image target: ``` -bitbake multiconfig:qemuarm64-stretch:isar-image-base +bitbake multiconfig:qemuarm64-buster:isar-image-base ``` diff --git a/meta-isar/conf/conf-notes.txt b/meta-isar/conf/conf-notes.txt index ae9611e..74df97c 100644 --- a/meta-isar/conf/conf-notes.txt +++ b/meta-isar/conf/conf-notes.txt @@ -1,4 +1,4 @@ Common targets are: - multiconfig:qemuarm-stretch:isar-image-base - multiconfig:qemuamd64-stretch:isar-image-base + multiconfig:qemuarm-buster:isar-image-base + multiconfig:qemuamd64-buster:isar-image-base multiconfig:rpi-stretch:isar-image-base -- 2.21.0