From patchwork Thu Apr 8 01:19:00 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Henning Schild X-Patchwork-Id: 405 Return-Path: Delivered-To: ilbers.mnt@gmail.com Received: by 2002:a4a:378f:0:0:0:0:0 with SMTP id r137csp380315oor; Thu, 8 Apr 2021 02:19:06 -0700 (PDT) X-Received: by 2002:a19:24d4:: with SMTP id k203mr5022254lfk.249.1617873546268; Thu, 08 Apr 2021 02:19:06 -0700 (PDT) ARC-Seal: i=3; a=rsa-sha256; t=1617873546; cv=pass; d=google.com; s=arc-20160816; b=ejru0kThx6lnsQF2ihax95jR8oPg9yqf2RrpvZRbNshHb/9RTcgafSg+y8XgYJf+0m NK9tKseUWIXD18ygyBPvHdByl+SKqRQ20ZtCT2McxvI9uinBKMckUuPYAjhqlGwnuaEm Sq88G6Hrns9sKFDY6DxdWE0//6tcZhKyffV4Rjewdt2Hl+MUDfG1C+X7bpdR/+lH7oAm /J4mwf23DXnqcLmIWlYH9pXkMP9ZriJpLfwWwD0CgKPyvUBRl2G5+HvcQQloqlZJkel2 Q9JPT8RohECEK1IBdbTSkwps9Hmwx1QBff1sHrtKQ/7mWkt5XxQcih8hPxwe3Z5AQJAe aIWw== ARC-Message-Signature: i=3; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:content-transfer-encoding :mime-version:message-id:date:subject:cc:to:from:sender :dkim-signature; bh=NE3j4FUchAOOtPVNuq+dWvX8nAAuZ5Je0gPl66gvUdA=; b=Xl+m/7FEwKlPcQiWHmYgiRjLipbY0uNZknYuJec8iUmPGT9xFWGJxEge2FLL7ft6EF JBXWxl4OfMPfsYSZktBWAmAA8DN6VyVyv7bJlamBRtR/FIKrFZRLe+Pc7AJLOMj/eX60 q/FSRUg0vToRJdsDkJm1hSg0iJGboYJkn3R3o5E4PnMp+hBskHXu/Tm3jZqneboN4rcq zRjqNv7OVnvLR0ELMBc4m9A4OhsB12/zkxybzLsTXXInSTE9IOjWCJqS4F7nAsjKX0gl TCT24zlt1Yv1lpFaayddw+sBDpNShBXjINlzDv2Abg1yDAprtb3iW0SGPP0hC0TC6pWz OhGQ== ARC-Authentication-Results: i=3; mx.google.com; dkim=pass header.i=@googlegroups.com header.s=20161025 header.b="tBfi0/Ec"; arc=pass (i=2 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of isar-users+bncbdjmjpgy2mgrbcmvxobqmgqem2v2r7q@googlegroups.com designates 209.85.220.55 as permitted sender) smtp.mailfrom=isar-users+bncBDJMJPGY2MGRBCMVXOBQMGQEM2V2R7Q@googlegroups.com; dmarc=fail (p=NONE sp=NONE dis=NONE arc=pass) header.from=siemens.com Received: from mail-sor-f55.google.com (mail-sor-f55.google.com. [209.85.220.55]) by mx.google.com with SMTPS id i10sor5764851lfe.92.2021.04.08.02.19.05 (Google Transport Security); Thu, 08 Apr 2021 02:19:06 -0700 (PDT) Received-SPF: pass (google.com: domain of isar-users+bncbdjmjpgy2mgrbcmvxobqmgqem2v2r7q@googlegroups.com designates 209.85.220.55 as permitted sender) client-ip=209.85.220.55; Authentication-Results: mx.google.com; dkim=pass header.i=@googlegroups.com header.s=20161025 header.b="tBfi0/Ec"; arc=pass (i=2 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of isar-users+bncbdjmjpgy2mgrbcmvxobqmgqem2v2r7q@googlegroups.com designates 209.85.220.55 as permitted sender) smtp.mailfrom=isar-users+bncBDJMJPGY2MGRBCMVXOBQMGQEM2V2R7Q@googlegroups.com; dmarc=fail (p=NONE sp=NONE dis=NONE arc=pass) header.from=siemens.com ARC-Seal: i=2; a=rsa-sha256; t=1617873545; cv=pass; d=google.com; s=arc-20160816; b=TjMMQogRQRwylwdBb8V0iSbwR2rZyjdu2JAU/wspXwcUNnWe4T19kaWLk8ZVyFBWBa RKxZAns+Fo793RjChyTqmcVhvQwDb3mhO7tqOklBsx2kt0cKh+bRJhDA8iGwd8byKEnB cebbKD7FOfY1APaKcpwVs40H0oXKeEkDbeLrzyJhyIS4VQva6vb32a8ltQMN/JNHRK/L 6XvOnypq1q/JNf7gG9/KaJqAg30Rjbh3u871kUJlNiffIgiN738MApo5nIvpAhD9jrGa NWYr07eGTJ+ncXu+chSE5E+tYY/GryfSt3sH17r9174EfVCUWiq3+e/DkqGxNj7pR7nv dyJA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:content-transfer-encoding :mime-version:message-id:date:subject:cc:to:from:sender :dkim-signature; bh=NE3j4FUchAOOtPVNuq+dWvX8nAAuZ5Je0gPl66gvUdA=; b=eXfJHWrrKNN485Z7vaMgLlt/vH8O5qnPA+/V8JSI9gJ04TnVPiXsVvHNv7zy88nXe/ b0ptm6T9jZwE2c4O/UsEvp3n4Nl2hU7jsk1diTEsnAvJB8IPjDElGiPBv5HKOyJBEH7f KDFGaF3JDuqNqmmxwvLHFJQTyP5A5+No7FGNoJTmwzV3z1o4g6H7dRMwgoAu9JaPm+J3 CmCD0dNdsgH05uboYBKH+lXbmmBP80h0mSbxT+W2wTVFqSQxEJU5LYScjYCa9nyXt+38 zdKIN38CaWUJqoccisEJvcf6csRFWPkoURDQon67LC4F7/FA+Dtdgw7wCYUXYePzBI9V 5+CA== ARC-Authentication-Results: i=2; 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 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :list-post:list-help:list-archive:list-subscribe:list-unsubscribe; bh=NE3j4FUchAOOtPVNuq+dWvX8nAAuZ5Je0gPl66gvUdA=; b=tBfi0/Eco7kt6liuzofqNPyHeIQetlPW5gmO8WgguP5sRuEaT+ZVP4881iZYXIs97K JrzfVNKMG+cInXhZlraAoj1swsust4gXkhdtx6sNAGt6W1qLjrllCsRCT/7bUILb2HMM U5KeXoKQYl8IriHuwUrPEjygYvWodX71HKpfJKFGdZH1uQfVp8OO5qcMJw+dRUnwYWyZ siJPyxuaW8n3BtHal8mtul4MXlMLTE0sx8js/DnFCOHkQyBXd0GxZnqVCiqLGTXIhyT9 DN0mSgMEC3YK+u4bhATJKU+AZ/l+wUnoc1f+PiELb1jT83frr3k9awNijQyWfKqcTs4a M1TQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:from:to:cc:subject:date:message-id :mime-version:content-transfer-encoding:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=NE3j4FUchAOOtPVNuq+dWvX8nAAuZ5Je0gPl66gvUdA=; b=FHOpC5mRI+FZlash+U8SWGnN/HFBX+4U+5XR2B1rF1x4wlPUnWhcdL2AfgtZ3NBxv6 Mxr9SIslXF65dDQr3n/e0yCEo70AbCH3azCcYnGOHc6VgeLJZEWVWhHplPLT65V2+WOO EmzD89V2EWyR/q8+vglbI7S6XrRi5M5Wyj2Dn9D557GzYNsg5NfQe/XkRDI8kUYdXR7s XoIT19QyHHlUdjxpI6CRstYNb62rrDNrRkd99YgaJpKvXNPtz/m7gkS29c4werEzs1cB 7QmkLDVq7+xx1SEs95weX5pJHvdMJxzH0bRFPrUjPUL6IyaA+vBCF1CVOGk8M1RosWqv PDEg== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOAM531DxB/ApA/9LD81TS45sTGGQydgbpGjfFhhf09+8FYUzsbG3Q+0 UgjOK8eIEbrAsuonFKvMw+M= X-Google-Smtp-Source: ABdhPJxDh5+JUSOkXFab8ekxbDW3J3rS0eRTa6BnraXYM9D/d+ybIGHr46f+LH6jY4GmJE/Pn8sgqg== X-Received: by 2002:a05:6512:3582:: with SMTP id m2mr5591560lfr.10.1617873545591; 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-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 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; 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 X-Original-Sender: henning.schild@siemens.com X-Original-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 Precedence: list Mailing-list: list isar-users@googlegroups.com; contact isar-users+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: isar-users@googlegroups.com X-Google-Group-Id: 914930254986 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: =?utf-8?q?1696463372082802908?= X-GMAIL-MSGID: =?utf-8?q?1696463372082802908?= 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