From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6948713968808493056 X-Received: by 2002:a2e:885a:: with SMTP id z26mr4922922ljj.316.1617873545667; Thu, 08 Apr 2021 02:19:05 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:6512:3d16:: with SMTP id d22ls4341174lfv.1.gmail; Thu, 08 Apr 2021 02:19:04 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxL7aMjPPw2J+Me/lZgBZjBXupIEj4WImmEhSIjxEFF94k6DWxE7SZYlJHz3CjdbPEAAJNh X-Received: by 2002:ac2:43a3:: with SMTP id t3mr5371107lfl.340.1617873544597; Thu, 08 Apr 2021 02:19:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1617873544; cv=none; d=google.com; s=arc-20160816; b=ZJHj8jyQssDP9ImQ49tTyjc35sJjKKjB4XFP7XxgflgNV5sfqUcf7U0/mSu66qEQ3p g+lMdHiWw7SNwtEag7FkTLXosKppkftNFZfhi/obuLgs2ZgXnm/WSbb1OSKZykbwxoAi h7Pk0Gy5KUNLSswV8Cmf2w+VA173B7/QR2476nkt0HBPId1IeoyNu1TroUbj7AwWQlYm GcG3asq293gMfdJlFGgGmuen0LqwmfMToro9vvqLPLANr4QTtmmSTHJokJ3RreYzePtp 9mfDBgeya4TXZMRTTce0mSBgR3S0idGpOfT7h9QzlUuOZa8AJkrsoXNZiW2i4jYkT6Do FYPw== 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=kxhzXr4qhl/OPhkL93Ssstya6HQoDrQvJc2wMvNg1q4=; b=ZuCrS8LkhJRFUX9ERVtOmILkZIlDuseeUXzSW6OZ3TNyPL89kRkWiT+bFERaD/MI+6 b8mJp+jfw32cc+OT+x5sFobYYlM4v+qFc+pnI7A5jWA27CCXaGtLf+cY4WzHRG/IymLp cH8znPoiaaWwMzJkgULOXsiCw8lxN7MtbFkoaxMFdqkets/NUmDMWGFZodiQowZw84m7 p7UhcSTNRM53O2vxzsSDI+xp3e5Y7P83AQTNExteLMoxFSRkdr8MVD8GVsBAgwbpToWa x6MVGwt5QN4HzFj/xNNOhgPkgD3lXouKJR+dT1WUU5JlOo2/Mr5+w60a27th0/Q7ZvTR in9A== 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 c17si1948967ljn.7.2021.04.08.02.19.04 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 08 Apr 2021 02:19:04 -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 mail1.sbs.de (mail1.sbs.de [192.129.41.35]) by lizzard.sbs.de (8.15.2/8.15.2) with ESMTPS id 1389J39Z006106 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 8 Apr 2021 11:19:03 +0200 Received: from localhost.localdomain ([167.87.8.3]) by mail1.sbs.de (8.15.2/8.15.2) with ESMTP id 1389J3lx002239; Thu, 8 Apr 2021 11:19:03 +0200 From: Henning Schild To: isar-users@googlegroups.com Cc: Jan Kiszka , Henning Schild Subject: [PATCH] doc: add a section on flashing images Date: Thu, 8 Apr 2021 11:19:00 +0200 Message-Id: <20210408091900.26115-1-henning.schild@siemens.com> X-Mailer: git-send-email 2.26.3 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-TUID: lZgxMNYLL8Mm 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. + ### Generate container image with root filesystem A runnable container image is generated if you set IMAGE_TYPE to -- 2.26.3