From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6948713968808493056 X-Received: by 2002:a2e:864e:: with SMTP id i14mr18982090ljj.15.1618251981121; Mon, 12 Apr 2021 11:26:21 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a2e:a785:: with SMTP id c5ls343200ljf.8.gmail; Mon, 12 Apr 2021 11:26:20 -0700 (PDT) X-Google-Smtp-Source: ABdhPJy9QebP+c7RWTpoOkXqjuyz4ncILe0UIc26zTRoLsHapWe18KP1gmJUphy0SywO0kY/e7Og X-Received: by 2002:a2e:8987:: with SMTP id c7mr18185924lji.79.1618251980051; Mon, 12 Apr 2021 11:26:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1618251980; cv=none; d=google.com; s=arc-20160816; b=WbCSjLW8v8YUpcfPisYOXVDkuvTRF/UvCluhrlJlnO0pfjtCKgaDT0S9dprh+LwVgZ YcuSt9paW+hjGZ19WaAqC6qjZOksyAwvlopYAinn2Jm7/Vb8LOZDlBRqDW1u76NP8l76 +iSDLrYJQIW2B5t3HgKKN7a0+uLcFViK28Jp1x+qfYbKnoAiNIBtjEmZpxfncEz4Rw8n /CfK8RCTnHtmkb4a4w4yfZ2Re5RV5IVG026RBEBJ1PTExSa9oGf7G/G4RNmQyo2T0Csg y0kzQ5YP1aZTW3l8VpO3Gi7AF/csEWVnlEGM6aAVyiBfRPQZ7jWjvD2nME6ecStJkZwJ gNDQ== 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:subject:cc:to:from:date; bh=dIMTjGUc3o9hClT+lnl30JNWHOsAqxJUkhnHSqC7rpQ=; b=uzcVkbVC2h9/XEZvrfyE87yN8+Wjzfrk/2Taswe3GT27MmbpsCcu309knz8g1p5rae C62x9OyWMMmHmPXTJ7nvAurFpTXQaIjgaogxqSa97pnwsOrjJEiAA00TNoFQ+d+TXowd v88QmtfWWPIc7ONS2/sgBIMJcpAheMbVHXTISAkqBmgp4l24adF0CHAXhAed59ugi9E/ RX77964FEQDcQ3vnN7o+SGb/ndu7npUhlfK/1UXwUhBlzCr6eYcsTtDpVov3Y0jVcdG6 cMshe/lpz5MwSfjSG8hmNQEfFpccXXCz93fIJDVU4Kg0nojRy0y0Ni8hULH6czsnrr89 iAGQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of henning.schild@siemens.com designates 194.138.37.39 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 lizzard.sbs.de (lizzard.sbs.de. [194.138.37.39]) by gmr-mx.google.com with ESMTPS id b12si544449lfv.7.2021.04.12.11.26.19 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 12 Apr 2021 11:26:19 -0700 (PDT) Received-SPF: pass (google.com: domain of henning.schild@siemens.com designates 194.138.37.39 as permitted sender) client-ip=194.138.37.39; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of henning.schild@siemens.com designates 194.138.37.39 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 lizzard.sbs.de (8.15.2/8.15.2) with ESMTPS id 13CIQJM7001193 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 12 Apr 2021 20:26:19 +0200 Received: from md1za8fc.ad001.siemens.net ([139.22.41.180]) by mail2.sbs.de (8.15.2/8.15.2) with ESMTP id 13CIF29b030053; Mon, 12 Apr 2021 20:15:02 +0200 Date: Mon, 12 Apr 2021 20:15:01 +0200 From: Henning Schild To: Jan Kiszka Cc: Subject: Re: [PATCH] doc: add a section on flashing images Message-ID: <20210412201501.386f9384@md1za8fc.ad001.siemens.net> In-Reply-To: <2229cf56-88ff-57ac-4fb5-8b0903aa8e5f@siemens.com> References: <20210408091900.26115-1-henning.schild@siemens.com> <2229cf56-88ff-57ac-4fb5-8b0903aa8e5f@siemens.com> X-Mailer: Claws Mail 3.17.8 (GTK+ 2.24.32; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-TUID: dT8ZQBqRtiqw Am Mon, 12 Apr 2021 18:51:28 +0200 schrieb Jan Kiszka : > On 08.04.21 11:19, Henning Schild wrote: > > Signed-off-by: Henning Schild > > --- > > doc/user_manual.md | 8 ++++++++ > > 1 file changed, 8 insertions(+) > > > > diff --git a/doc/user_manual.md b/doc/user_manual.md > > index 70cf20a74828..e1d7166911e2 100644 > > --- a/doc/user_manual.md > > +++ b/doc/user_manual.md > > @@ -232,6 +232,14 @@ qemu-system-x86_64 -m 256M -nographic -bios > > edk2/Build/OvmfX64/RELEASE_*/FV/OVMF qemu-system-i386 -m 256M > > -nographic -hda > > tmp/deploy/images/qemui386/isar-image-base-debian-buster-qemui386.wic.img > > ``` +#### Flashing such images to a physical device > > + > > +wic images can be flashed in multiple ways. The most generic and > > easy way is probably with [ etcher ](https://etcher.io). That works > > on many operating systems and is relatively easy to use. On top it > > can decompress images on the fly, should they be compressed. It > > also offers some sort of protection so you do not write to the > > wrong device and maybe break your machine. + +If you have a unix > > shell there are other ways. Make sure to always double check the > > target device, those tools will not warn if you choose the wrong > > target. + +`dd` is the most generic option, available pretty much > > everywhere. For large images that contain a lot of empty space `dd` > > might be a little slow because it writes all that empty space. In > > that case `bmaptool` can be used instead. > > It's "bmap-tools" officially, a link to it would be good > (https://github.com/intel/bmap-tools). Some distros like Debian call > the package bmaptool. Still the tool itself will be called "bmaptool", this is not a documentation on where the command may be coming from. It is like "dd" probably not coming from a package called "d-d" or whatever ... > In general, would put it before mentioning dd, > also because "bmaptool copy" checks if the target device is mounted > before writing - which can be quite a mess if you didn't notice this. > We recommend it therefore in most of our end-user facing layers. I could reorder them, but "bmaptool" has an availability issue, it is simply not as readily available as "dd". That is why i ordered entries like i did, still recommending "bmaptool" where available. Maybe that mounting is another benefit of "bmaptool" over "dd". I will change the order to say "bmaptool" where available, "dd" as fallback. Reasons being speed and mount-check. Henning > Jan > > > + > > ### Generate container image with root filesystem > > > > A runnable container image is generated if you set IMAGE_TYPE to > > >