From patchwork Wed Dec 4 10:44:48 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 53599 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 412DEE7716D for ; Wed, 4 Dec 2024 10:44:53 +0000 (UTC) Received: from bird.elm.relay.mailchannels.net (bird.elm.relay.mailchannels.net [23.83.212.17]) by mx.groups.io with SMTP id smtpd.web11.10998.1733309092082623393 for ; Wed, 04 Dec 2024 02:44:52 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@rootcommit.com header.s=hostingermail-a header.b=rGl4i/fw; spf=pass (domain: rootcommit.com, ip: 23.83.212.17, mailfrom: michael.opdenacker@rootcommit.com) X-Sender-Id: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id 99B251A36C6 for ; Wed, 4 Dec 2024 10:44:51 +0000 (UTC) Received: from fr-int-smtpout8.hostinger.io (100-122-114-61.trex-nlb.outbound.svc.cluster.local [100.122.114.61]) (Authenticated sender: hostingeremail) by relay.mailchannels.net (Postfix) with ESMTPA id E34A91A298B for ; Wed, 4 Dec 2024 10:44:50 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1733309091; a=rsa-sha256; cv=none; b=m3jsPTuO01iIU26u8BCny0POimG1ZgddTwZm1LU2g1Cx0W+uqxzqpDap4Mb6nV9FUJMxea 56wVeCTugQmzoEk4Q0pc2ToDLiIU1mBWkUEUsuALTkv+ZbrAS9ZkdzILnr5p5RWEcZleUh G+QjhSMjc68iSFvvTknsQkc5rZ64yGY/gVbQuTiB1+BrhehTibbczW/5gZulx3hGgdfcs4 r2lGc2aT6kDw21u9L5JtbERXrC0+9VYqSaUrr4ORAoH6RtZfUh3SrycoVemG4JgUTIIC05 1/pmEcmAK3uvPHIQgBaQTQJt2K2dvk0XXmrfOp6jyGKBaSzRtF5f+8fbBGzp4Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1733309091; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=tuYbANDKHrRWjlNKYjvsZ01FXTJgnd2oY5gTaqqSZLU=; b=2mRSCbzMKYqBS2/xzUpQgihBT9p4B7aK+7mA69N6pwXBE4Vfna0FAF+JQ4Fn0FKCv4s4QI K0DaJnTtJeRjMTJgJnB1D84UYWADFt+XVfzv5+h876JdROsZ4QdcnMFlI+4uS9uN3m6sFq 21enPRK2h7w3U8UOFyEraBtrHpjLJK1EncCMV54G3Bd8hQzEqJWBPQBYzEKCf4l9dEEReP AyO74I3iP5hVIQR8R3j6kfB8mbxWDCZaL5yTYEiP+zDARsJzAyFE2eYxn2RwU8MGzkV+Gv G/X9yG4UtkNRVIFla6oRgR57By3qz8KRzRMZ9qIjk28OGhW97nRW7rqx28gxRw== ARC-Authentication-Results: i=1; rspamd-5d9d86ff64-njkxj; auth=pass smtp.auth=hostingeremail smtp.mailfrom=michael.opdenacker@rootcommit.com X-Sender-Id: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com X-MC-Relay: Neutral X-MailChannels-SenderId: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com X-MailChannels-Auth-Id: hostingeremail X-Army-Ruddy: 00c3538666bda0a1_1733309091466_2774032485 X-MC-Loop-Signature: 1733309091466:3192398247 X-MC-Ingress-Time: 1733309091466 Received: from fr-int-smtpout8.hostinger.io (fr-int-smtpout8.hostinger.io [89.116.146.204]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.122.114.61 (trex/7.0.2); Wed, 04 Dec 2024 10:44:51 +0000 From: michael.opdenacker@rootcommit.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rootcommit.com; s=hostingermail-a; t=1733309088; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=tuYbANDKHrRWjlNKYjvsZ01FXTJgnd2oY5gTaqqSZLU=; b=rGl4i/fwfwLbtsjBa93pjAyg1XeiQUdkCRddirJ+bIOCesVj3kpq7dRLNnpvIhZOdicm4n dG2AUtV+vGVhz9yN2RObgzLOXA/b9yJ19Z4zl+u32vF615MH8ERPUaSRVtxKFN8pNUX7WV 3SdqO+0BX6DZkr2iRyz9Cto2yqDnRpJW9P/E9zGsMYBqxrCmg+S7v+m4GP7kytlmEKMuTS 8kXWoEkz/+CXY9/Y8xwxQMM0GLyEI+ndZQw6EkX+uSal4/uQMF0mfOP5Jbd9ablOm6fiQY GYeG6KgdeB+HnSrzd8SMChn0ARZlGanKJnluoukMSh7u26jjw3Y84hRIeSa7yA== To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH v2 1/3] dev-manual: fix styling of references to bmaptool Message-ID: <20241204104432.2094236-2-michael.opdenacker@rootcommit.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241204104432.2094236-1-michael.opdenacker@rootcommit.com> References: <20241204104432.2094236-1-michael.opdenacker@rootcommit.com> MIME-Version: 1.0 Date: Wed, 04 Dec 2024 10:44:48 +0000 (UTC) X-CM-Envelope: MS4xfEwYeLb2eKUhU4aNYHKJ3RXbsETCJdraS/Rbna3Z9JvMBU8ZopmGK1EZ6J5OsAhhualwy4tqmQ0zje7WFyqiE7dVZ1Xjf3PsOy5BVviWq5FoJRIt1Kon w38cojzT3twEAVRkdvvnnEd1D6vGiZBGItVglugSDbix3luSge4nNLmtM9TSj4uXNpX+p94lLGsJORVUbP9K4aPchfnpqYuxnwAFetf3qvJddqksKoU/r6wD FuNRRWM6RO05vEX7k/0RxJo8qd2URKA0TXZv+x8VWJZ5psUFj0jdGIupSkG8dlGJXth2eN1H79MkZcqGiE16fSOIgrmLRjtqKF9CxeT8rSc= X-CM-Analysis: v=2.4 cv=dOX0m/Zb c=1 sm=1 tr=0 ts=675032a0 a=3JjwsiTUxCxireyYQgRi/g==:617 a=xqWC_Br6kY4A:10 a=d70CFdQeAAAA:8 a=lk4ATzALKvHUNUYlx5wA:9 a=NcxpMcIZDGm-g932nG_k:22 X-AuthUser: michael.opdenacker@rootcommit.com List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 04 Dec 2024 10:44:53 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5877 From: Michael Opdenacker To follow the styling conventions when we are refering to the name of a tool instead of the command itself (documentation/standards.md). This also improves the HTML rendering of the bmaptools subsection. Signed-off-by: Michael Opdenacker --- documentation/dev-manual/bmaptool.rst | 18 +++++++++--------- documentation/dev-manual/wic.rst | 4 ++-- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/documentation/dev-manual/bmaptool.rst b/documentation/dev-manual/bmaptool.rst index f6f0e6afaf..493abf7607 100644 --- a/documentation/dev-manual/bmaptool.rst +++ b/documentation/dev-manual/bmaptool.rst @@ -1,13 +1,13 @@ .. SPDX-License-Identifier: CC-BY-SA-2.0-UK -Flashing Images Using ``bmaptool`` -********************************** +Flashing Images Using `bmaptool` +******************************** A fast and easy way to flash an image to a bootable device is to use -bmaptool, which is integrated into the OpenEmbedded build system. -bmaptool is a generic tool that creates a file's block map (bmap) and +`bmaptool`, which is integrated into the OpenEmbedded build system. +`bmaptool` is a generic tool that creates a file's block map (bmap) and then uses that map to copy the file. As compared to traditional tools -such as dd or cp, bmaptool can copy (or flash) large files like raw +such as `dd` or `cp`, `bmaptool` can copy (or flash) large files like raw system image files much faster. .. note:: @@ -20,13 +20,13 @@ system image files much faster. $ sudo apt install bmap-tools - If you are unable to install the ``bmap-tools`` package, you will - need to build bmaptool before using it. Use the following command:: + need to build `bmaptool` before using it. Use the following command:: $ bitbake bmaptool-native Following, is an example that shows how to flash a Wic image. Realize -that while this example uses a Wic image, you can use bmaptool to flash -any type of image. Use these steps to flash an image using bmaptool: +that while this example uses a Wic image, you can use `bmaptool` to flash +any type of image. Use these steps to flash an image using `bmaptool`: #. *Update your local.conf File:* You need to have the following set in your ``local.conf`` file before building your image:: @@ -39,7 +39,7 @@ any type of image. Use these steps to flash an image using bmaptool: $ bitbake image -#. *Flash the Device:* Flash the device with the image by using bmaptool +#. *Flash the Device:* Flash the device with the image by using `bmaptool` depending on your particular setup. The following commands assume the image resides in the :term:`Build Directory`'s ``deploy/images/`` area: diff --git a/documentation/dev-manual/wic.rst b/documentation/dev-manual/wic.rst index a3880f3a1c..fced0e170c 100644 --- a/documentation/dev-manual/wic.rst +++ b/documentation/dev-manual/wic.rst @@ -513,7 +513,7 @@ or :: For more information on how to use the ``bmaptool`` to flash a device with an image, see the - ":ref:`dev-manual/bmaptool:flashing images using \`\`bmaptool\`\``" + ":ref:`dev-manual/bmaptool:flashing images using \`bmaptool\``" section. Using a Modified Kickstart File @@ -721,7 +721,7 @@ the existing kernel, and then inserts a new kernel: Once the new kernel is added back into the image, you can use the ``dd`` command or :ref:`bmaptool - ` + ` commands to flash your wic image onto an SD card or USB stick and test your target. From patchwork Wed Dec 4 10:44:52 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 53601 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2AAFCE77171 for ; Wed, 4 Dec 2024 10:45:23 +0000 (UTC) Received: from fly.ash.relay.mailchannels.net (fly.ash.relay.mailchannels.net [23.83.222.61]) by mx.groups.io with SMTP id smtpd.web10.11129.1733309115019486320 for ; Wed, 04 Dec 2024 02:45:15 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@rootcommit.com header.s=hostingermail-a header.b=gJyoKACB; spf=pass (domain: rootcommit.com, ip: 23.83.222.61, mailfrom: michael.opdenacker@rootcommit.com) X-Sender-Id: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id 3BC0B2C4286 for ; Wed, 4 Dec 2024 10:45:14 +0000 (UTC) Received: from fr-int-smtpout8.hostinger.io (trex-4.trex.outbound.svc.cluster.local [100.122.114.114]) (Authenticated sender: hostingeremail) by relay.mailchannels.net (Postfix) with ESMTPA id 7CD9A2C4BF3 for ; Wed, 4 Dec 2024 10:45:13 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1733309113; a=rsa-sha256; cv=none; b=B+J12OyDuXP/XexQfEv414wTKFOm257FwoNIL2hsjUb8DbkSzTA6UcFfNx88lcOfNODmzN nssTc6fR3w6uW1uqOY/5LhD6Ie24vQfa0yff5s+tEXd6cJzpRLiFJDbgxNhoTRwJ5TgUma 2SWeYm+JWzD3Sd3RViLPma1Q+Zhzs+/Tmj8OLzjVCCVqsFpm3DjTI2gZuih6xT4gr4WONN ZjNZktpugbDBujrevKBfvFTYE8SX10iTsZ/r3tGEI03lqllgfFNJjLHb83O0p5i9+qRFso 8R2LaBUrCA+WxQ6c8l9Pvbgfx8nVWeYtU81Zz/w8j9dOLiWdHmdPtLhpsbuYnw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1733309113; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=DWBh/o7JwRzXE787Ccd4WPFFCi3kbF3CyzQerGOVQNk=; b=bS0wEZqT5Hey+A9839uezXxJxGRwPasoB+VdMzfOP9L8JTFcTB5hzsipV2yJXHVSeHx6BA tnnQJ1vYTOOiDRlK7+gZDgVWkIhFETLqYT+Xs9E7qrO+xZtkQKYLgNbc/6+yAnehiKXvfO JDReAaT+qEqrFGhzdPCoEfTZZorbiIolh5bGnJx+nYmHnqA8eu0aPEuG7GdRwHjoruFB6/ Nf9NHnM/vTN6CY3Ev1ob1o4bowldcTuOCggu20YoLh3UGAEOkKFs64aU8LOFQ0NarXpx5j Dxd7zb8jbit94qdq1CtRV7CVgMS4fNjh8luFWtG2B3SmsGqzCZ79fJxmhZe26w== ARC-Authentication-Results: i=1; rspamd-5d9d86ff64-mpgqg; auth=pass smtp.auth=hostingeremail smtp.mailfrom=michael.opdenacker@rootcommit.com X-Sender-Id: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com X-MC-Relay: Neutral X-MailChannels-SenderId: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com X-MailChannels-Auth-Id: hostingeremail X-Duck-Gusty: 7b134a2e4a971549_1733309114061_2229850244 X-MC-Loop-Signature: 1733309114061:1094663191 X-MC-Ingress-Time: 1733309114061 Received: from fr-int-smtpout8.hostinger.io (fr-int-smtpout8.hostinger.io [89.116.146.204]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.122.114.114 (trex/7.0.2); Wed, 04 Dec 2024 10:45:14 +0000 From: michael.opdenacker@rootcommit.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rootcommit.com; s=hostingermail-a; t=1733309092; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=DWBh/o7JwRzXE787Ccd4WPFFCi3kbF3CyzQerGOVQNk=; b=gJyoKACBp7x95oxQMDjIXNc/wrTvpDxcDLyv75muBRJJp11fhDr+lxkuZggnN0vNu/RkXc j83IcNrRcOje3YNF1RoPOdwmn41ahg7kV0nTT0ktlPDeq0+tm/MDTeYSLMibwsiAWtCGnE IDHNLgUCCltV1SFVC6aluppcepQp3newjGT7jLG1QHC/qjJf7KzkMG1Qi13m7ryhZDOCBp 5j80TEW/3o8H7rlYBCSWh10KQ1ZKcMhrFX2gFX6wISLrfq3ManhEXSiQleDeXRSsGl7+5Q ClaxLFPcU/tgSO9QGseHwvUhaB9uaZv6KFw+Wy0Rfz42E7FHMMw71HvGqvd0IA== To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH v2 2/3] dev-manual/bmaptool.rst: correct command for bmaptool-native Message-ID: <20241204104432.2094236-3-michael.opdenacker@rootcommit.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241204104432.2094236-1-michael.opdenacker@rootcommit.com> References: <20241204104432.2094236-1-michael.opdenacker@rootcommit.com> MIME-Version: 1.0 Date: Wed, 04 Dec 2024 10:44:52 +0000 (UTC) X-CM-Analysis: v=2.4 cv=dOX0m/Zb c=1 sm=1 tr=0 ts=675032a4 a=3JjwsiTUxCxireyYQgRi/g==:617 a=xqWC_Br6kY4A:10 a=d70CFdQeAAAA:8 a=rJ4S2n_EE8Q4mpNx-akA:9 a=NcxpMcIZDGm-g932nG_k:22 X-CM-Envelope: MS4xfO+Ssk4bHQDIVU/ucLhSUD8ZF1uxFeXgUXHGDPR7ysGlPJ+ZndDxfeaUlgHZVmG5P628MjcwpEa+a+7Z53p0JGcJjkIn4sFfYoZbHfBI8m31yyyzDnXM JxQmoGyucbo8D9e3iB+XU5KuoOJH7TlVUK5wgdrarCH+4rca/LKAr1J4ve5BTwFkZJHiDA6lPYp4oS/m8uCFfgc4YcREhQYup4H6LBwjU59L7oRzM3dfI3I4 L9i3Mn7XeR2KTNi+ueHYdZhxzLYgAs7gXEiIAcXJnTMldYxSq+6y1gE9iuMGkMAmK/cmFCO2wwWKfGtfRsXoAOSy4PbKGoP6/6jL/Latp+s= X-AuthUser: michael.opdenacker@rootcommit.com List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 04 Dec 2024 10:45:23 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5878 From: Michael Opdenacker Using only "bitbake bmaptool-native", running "oe-run-native bmaptool-native bmaptool ..." fails as follows: Error: Have you run 'bitbake bmaptool-native -caddto_recipe_sysroot'? Running the "bitbake bmaptool-native -caddto_recipe_sysroot" target is actually sufficient. Signed-off-by: Michael Opdenacker --- documentation/dev-manual/bmaptool.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-manual/bmaptool.rst b/documentation/dev-manual/bmaptool.rst index 493abf7607..37083c9c64 100644 --- a/documentation/dev-manual/bmaptool.rst +++ b/documentation/dev-manual/bmaptool.rst @@ -22,7 +22,7 @@ system image files much faster. - If you are unable to install the ``bmap-tools`` package, you will need to build `bmaptool` before using it. Use the following command:: - $ bitbake bmaptool-native + $ bitbake bmaptool-native -caddto_recipe_sysroot Following, is an example that shows how to flash a Wic image. Realize that while this example uses a Wic image, you can use `bmaptool` to flash From patchwork Wed Dec 4 10:44:56 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 53600 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2B519E7716B for ; Wed, 4 Dec 2024 10:45:23 +0000 (UTC) Received: from skyblue.cherry.relay.mailchannels.net (skyblue.cherry.relay.mailchannels.net [23.83.223.167]) by mx.groups.io with SMTP id smtpd.web10.11130.1733309116790916046 for ; Wed, 04 Dec 2024 02:45:16 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@rootcommit.com header.s=hostingermail-a header.b=ftQzUfL4; spf=pass (domain: rootcommit.com, ip: 23.83.223.167, mailfrom: michael.opdenacker@rootcommit.com) X-Sender-Id: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id 436D18A3C07 for ; Wed, 4 Dec 2024 10:45:16 +0000 (UTC) Received: from fr-int-smtpout8.hostinger.io (trex-11.trex.outbound.svc.cluster.local [100.122.94.224]) (Authenticated sender: hostingeremail) by relay.mailchannels.net (Postfix) with ESMTPA id 7CB248A3C8C for ; Wed, 4 Dec 2024 10:45:15 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1733309115; a=rsa-sha256; cv=none; b=Fer2I9qPZLCh3+497lYgtviFx8ZE3ac9CIX7Bn8zdC0dG2ZzIIS7U4eBE7ZeGkQdE2niCU ZgZ54Jd6P48NMrwq5wOsFh4o2CmNKl4KsYAKkOE8AUi3oLrczHPQVDV5JrYlM9x+SgVJh3 95Lt6Bq3JBUBk5kiFz4OZvOjn4Uw4RqJzNNBX/n0atWIHMxwPPHIoz1H/iK0+aAuHYU41k ii50K2GL4Xazkf/G7Q8UezcMXc+t5fDHXgMgNgtPg85DNSy7P1U2ur9mj17M2VSkD4t/q4 YguqEANcbtx690TfWBixrYAUunwjXDztVfrO4Yojj6g3i5RAhVhXZLASTHKS4g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1733309115; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=bZZvhwhvfDzQ7p2VXk7mQlF1QcxVbR6RN29pcbzKdZE=; b=A9FRXTAGGkrP6EAC/Cu4X12m88wcMw1G09CBObGmwzBVlH5n713hW2f9zkDz2qUb3E6ZEl 3MweD8LKAuL16mXMfizFGN0PYKgCDBolRvXo2l+r07OyicTFXwBOSEttYJUCEOdl19G1Et oRSQXiWEPK6JdPkMLyTb+CxcY7hhPN2OMTB5Yh7t+WrCScmh66qDcBvWAHs0OfQFJo/5cb XjCgbdYq4+TfFbfSfsVZ4j9bx1/Dg2lDyVN9Ko4r6ww+d7p0pMAb8S+Lh5IZDJBQQrYCqK UvJBrkzTAGbcrtv4K3UGLVRuDgL4NlLV53XgMAVGOYTgldF5l87CGcZj7vpEVg== ARC-Authentication-Results: i=1; rspamd-5d9d86ff64-qcw6v; auth=pass smtp.auth=hostingeremail smtp.mailfrom=michael.opdenacker@rootcommit.com X-Sender-Id: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com X-MC-Relay: Neutral X-MailChannels-SenderId: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com X-MailChannels-Auth-Id: hostingeremail X-Minister-Squirrel: 58ec386836e8147c_1733309116047_245046235 X-MC-Loop-Signature: 1733309116047:802047336 X-MC-Ingress-Time: 1733309116047 Received: from fr-int-smtpout8.hostinger.io (fr-int-smtpout8.hostinger.io [89.116.146.204]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.122.94.224 (trex/7.0.2); Wed, 04 Dec 2024 10:45:16 +0000 From: michael.opdenacker@rootcommit.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rootcommit.com; s=hostingermail-a; t=1733309096; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=bZZvhwhvfDzQ7p2VXk7mQlF1QcxVbR6RN29pcbzKdZE=; b=ftQzUfL45PND6QGaSCJH9rt41mp7vzxvJ0Rm37v51EPS1WGyl9ZEfKAze6Gwe5Zot2sJUD N+fEfr6MbbENwsugygoIuTJkp1FBk5na+MyLaQWen1aFrAM0BHqDODG+Vp/9XhhyZO6dyB 7nnSMQ0R6/NaY5w5YILyFeVQLGu8KMtOaJFEs0Qj85CBsPpROj64wbmaH1GgliOfAFJpAM 3V0mNLc91kQ/4OY6ZjSK7k9qNLPkq1QUTUOApnxTebD8t5bTrr4RkKm7tk+L/r0uUfxisn Pw1kB1rDnngqWEuIKPWv9EDQF/fA85T1GWRKcRa91aPWp2IutYXo0hlwCcSAfQ== To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH v2 3/3] dev-manual/bmaptool.rst: simplify and fix instructions Message-ID: <20241204104432.2094236-4-michael.opdenacker@rootcommit.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241204104432.2094236-1-michael.opdenacker@rootcommit.com> References: <20241204104432.2094236-1-michael.opdenacker@rootcommit.com> MIME-Version: 1.0 Date: Wed, 04 Dec 2024 10:44:56 +0000 (UTC) X-CM-Envelope: MS4xfNabmKnaCRPmv4rq/tOjbWwfpJOud8kn6DCiuEgJU/ZVel2spMsRjTUhVhXeebFZaX8zVpx0ZJaEsmQKArynhOQLwqqS5mOV1Sf6CfY3ggi/TZV94SMa NMKuTkn31ubpDo9vF8hnnOMliwd037GBhDgCw+TnT8iUivjsmDbucAtcS07xbkFN7S58PBl5tLp8Sgbx7589jeLyXjJbeOrONo5RtgD30vLE+YenC8N120wu 1cW7GBPz3Fgtb10x0+snKFRey4Z9PcsfrjziibRW0e4wwvUODmbOidwtzZ9xHioKkPrEFr5b0wVa2YgPOrV3QWlhqzwlEoMpcSJbpHaL9sg= X-CM-Analysis: v=2.4 cv=dOX0m/Zb c=1 sm=1 tr=0 ts=675032a8 a=3JjwsiTUxCxireyYQgRi/g==:617 a=xqWC_Br6kY4A:10 a=d70CFdQeAAAA:8 a=K0np5UDMr5CNkJvIeKUA:9 a=NcxpMcIZDGm-g932nG_k:22 X-AuthUser: michael.opdenacker@rootcommit.com List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 04 Dec 2024 10:45:23 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5879 From: Michael Opdenacker - Remove duplicate instructions - Detail how to run bmaptool directly if you installed it on your host instead of building it through the ``bmaptool-native`` recipe, as running "oe-run-native bmaptool-native bmaptool ..." won't work in this case. Signed-off-by: Michael Opdenacker --- documentation/dev-manual/bmaptool.rst | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/documentation/dev-manual/bmaptool.rst b/documentation/dev-manual/bmaptool.rst index 37083c9c64..93c8d3a45e 100644 --- a/documentation/dev-manual/bmaptool.rst +++ b/documentation/dev-manual/bmaptool.rst @@ -43,14 +43,16 @@ any type of image. Use these steps to flash an image using `bmaptool`: depending on your particular setup. The following commands assume the image resides in the :term:`Build Directory`'s ``deploy/images/`` area: - - If you have write access to the media, use this command form:: + - If needed, set permissions to get write access to the media:: - $ oe-run-native bmaptool-native bmaptool copy build-directory/tmp/deploy/images/machine/image.wic /dev/sdX + $ sudo chmod 666 /dev/sdX - - If you do not have write access to the media, set your permissions - first and then use the same command form:: + - If you installed the package for `bmaptool`, you can directly run:: + + $ sudo bmaptool copy build-directory/tmp/deploy/images/machine/image.wic /dev/sdX + + - Otherwise, if you built `bmaptool` with BitBake, run:: - $ sudo chmod 666 /dev/sdX $ oe-run-native bmaptool-native bmaptool copy build-directory/tmp/deploy/images/machine/image.wic /dev/sdX For help on the ``bmaptool`` command, use the following command::