From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6948713968808493056 X-Received: by 2002:a05:6402:13ca:: with SMTP id a10mr30634781edx.320.1618252298849; Mon, 12 Apr 2021 11:31:38 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a17:906:4d10:: with SMTP id r16ls5548228eju.8.gmail; Mon, 12 Apr 2021 11:31:38 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwbNu76p46XSXDKTVbLiQl/F9jQy1ynJD5cU16xFVbC8B/PK5pRkGT6CeRAuZnWKGJdSpq/ X-Received: by 2002:a17:907:2cf1:: with SMTP id hz17mr22309837ejc.319.1618252298004; Mon, 12 Apr 2021 11:31:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1618252298; cv=none; d=google.com; s=arc-20160816; b=c+4C/ISuvv95FNiIP7xyY1MpVem72SoT4ge2PqiY7G/6tG7ou4nDxtC8ljjZJhZzYb otN1t2AVSRN83uL3V11b/dXu4etjExAPq3z2B188POlQnPTmoSOmoFpKcdsr2OoslQV2 nhuGFluKYwEm+HBRVtDi2pgfPz1RfZwxeQNATFJXiETJQU43elaRL7y7XsTh2MPp3Myv TM+kxiFlOnAVQEz+eXEfFWwOzGjlC5sxKdZqEozv7bFiKqo20pwqA/530AC6XIhxue7y UIfwwAJYJA9fpjHHreKT1yMcsSiKb/z2lBw/MYxHNuwiyEM2rwoUkChI/ENdo0D2x3N3 DF+A== 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=PZlkWYBnNmRyU5/OHUPQdrHGmclxu1LpntPF3J2tUMs=; b=VIsSfpIuUzGILJwgnqX5CMGnWpy0BY/ibrT0b1t2umX2WK5tGKi41+C0iPl0XhUs/j 026XxGCK82uJdB97xHtRX/r+M8XrNSgQxFJz+Lbsr6k+CDA3x7XQL+6hY1ZaSCCdTM7F xLkwd8LoMmB+xXLC8RLTQn3Ua6i8EcPVoZqJNF++2XQD0pVnom8k2YZi9CQmB3hW3PUq Wgh2xxNEY/h60cZmJjw66IgrWbDTYN7fCt/qizayIDCIYyuNyCOVW6H4H5bi03CHW8Qo UcJjuYg2aalTfbcCPUINfJrTpGWD1H86chwT4eRZVEXaH/xQ0+I7LUJGNWwtZ2I++UDG kbAg== 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 r21si937204ejo.0.2021.04.12.11.31.37 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 12 Apr 2021 11:31:37 -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 13CIVbVa007598 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 12 Apr 2021 20:31:37 +0200 Received: from localhost.localdomain ([139.22.41.180]) by mail2.sbs.de (8.15.2/8.15.2) with ESMTP id 13CIRxxk010035; Mon, 12 Apr 2021 20:27:59 +0200 From: Henning Schild To: isar-users@googlegroups.com Cc: Jan Kiszka , Henning Schild Subject: [PATCH v2] doc: add a section on flashing images Date: Mon, 12 Apr 2021 20:27:56 +0200 Message-Id: <20210412182756.1091-1-henning.schild@siemens.com> X-Mailer: git-send-email 2.26.3 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-TUID: Q4+rJ6juZt/i Signed-off-by: Henning Schild --- doc/user_manual.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/user_manual.md b/doc/user_manual.md index 70cf20a74828..c3c9e977f3fb 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -232,6 +232,17 @@ 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 might not warn if you choose the wrong target. + +`bmaptool` would be the best choice on a Linux/Unix system. It offers skipping of empty space and will flash much faster than `dd`, it also has some protection so you do not flash over a mounted drive by accident. Unfortunately it is not yet available on all Linux distributions. +https://github.com/intel/bmap-tools + +`dd` is the most generic option, available pretty much everywhere. But here you really need to make sure to not write to the wrong target. + ### Generate container image with root filesystem A runnable container image is generated if you set IMAGE_TYPE to -- 2.26.3