From patchwork Sun Dec 1 17:38:06 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 53437 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 6729DD4977C for ; Sun, 1 Dec 2024 17:38:13 +0000 (UTC) Received: from buffalo.birch.relay.mailchannels.net (buffalo.birch.relay.mailchannels.net [23.83.209.24]) by mx.groups.io with SMTP id smtpd.web11.156374.1733074690737535727 for ; Sun, 01 Dec 2024 09:38:11 -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=EJ6UCSte; spf=pass (domain: rootcommit.com, ip: 23.83.209.24, 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 E61072C128A for ; Sun, 1 Dec 2024 17:38:09 +0000 (UTC) Received: from fr-int-smtpout2.hostinger.io (100-121-72-110.trex-nlb.outbound.svc.cluster.local [100.121.72.110]) (Authenticated sender: hostingeremail) by relay.mailchannels.net (Postfix) with ESMTPA id 14BCE2C25CF for ; Sun, 1 Dec 2024 17:38:08 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1733074689; a=rsa-sha256; cv=none; b=Ib4Fu6d1Z3CNExSh4YKnq2OO7CRpcqkp8EB1Y1DyEPXi808URVMHiiiy1i4DwH5vNrT1H3 83kq63qZj/LIdPR3O7Oot7VOME3cD7h6SlUnbQGCa8ExzfvRruxmL4YGJdsSitLncVxUFg 4nNGCgVzK4oAYJItPspfv713tkmM3AKKNpnMWhuf8JH7pzWbOccO3tDHM7jmASeE31JYhU b+DJk8qJeXNvtYenVgGECDXw/5WsZ93whFY55SnU/UEfPKge35HjgmfKqstRjALTi9AT4S ncIvkMow+ElNqecJNFcjO+Noz8jQmDCu5TtNg+7CJRN9Dux3eAnDMooVeily/Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1733074689; 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:dkim-signature; bh=tuYbANDKHrRWjlNKYjvsZ01FXTJgnd2oY5gTaqqSZLU=; b=+RNJ5VDexsjvec3dakn1p1/R1b3mPAJJnBxE0+hdR3TYaqU+ZA9vWWIGv6f01hXWQ6fmne a219L8SFCjQrbZFtQ0/HkFMVyreP3xknvMZWdNFzueZ6uEPDUcGXMeWpSJ6A6XbZCkGeMW eaINWsrEbihrTaQJGRea5a/vd+xlqIVTD2cgYmWp7KEIS/HedQLQt9jGOcTmpARJwk7R/E UFe6kh3CHLEPjxpCgk6qQuvJSY+wbc8qLhMLJqvS6Kc8USpuIStRJkGM9TDaoV9AIgJ2p5 j5R0c9DYqEJBsOKieFkBJAz8KabESis91bKVwUlSKP+Ylxy5WkcOY66BGhRDvg== ARC-Authentication-Results: i=1; rspamd-fc7fd4597-nz5rb; 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-Celery-Abortive: 66f9808d78ba4725_1733074689585_1731694822 X-MC-Loop-Signature: 1733074689585:4162474094 X-MC-Ingress-Time: 1733074689585 Received: from fr-int-smtpout2.hostinger.io (fr-int-smtpout2.hostinger.io [89.116.146.81]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.121.72.110 (trex/7.0.2); Sun, 01 Dec 2024 17:38:09 +0000 From: michael.opdenacker@rootcommit.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rootcommit.com; s=hostingermail-a; t=1733074687; 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; bh=tuYbANDKHrRWjlNKYjvsZ01FXTJgnd2oY5gTaqqSZLU=; b=EJ6UCSteKm9u2mvZ7P6dw4+sk+TOQPGBqaFMOt+D6t78GIpu2E7GXpmmedWWLjGqmJp3v9 gZx5MUSI9LwEQ0ENS7P03EjUxm0vAVAMgo6Vlv4+MDuV/L5ODbZr1czpBIfeqyeIFY6OyL sDCD+Zve3U7ry4g7YlKjxhvK+gUxZNISg1ecZp3X4N+w6Nhin+0T7xpeI+JnEkU+GCR8JS K89itgsK9Q/K1rtutd0JL3XY8Dtf+r0aZgU+EeR3R/rdC7fZGf4Gvz7MCyZszEvT3XWwjL eI303uJCBtNPGCTVdKedOSm7pExI6iXYJ70MXlCUU+HSZswf5WjpnBk5uwBK0Q== To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH 1/3] dev-manual: fix styling of references to bmaptool Message-ID: <20241201173801.3290796-1-michael.opdenacker@rootcommit.com> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 Date: Sun, 01 Dec 2024 17:38:06 +0000 (UTC) X-CM-Analysis: v=2.4 cv=HfJGTTE8 c=1 sm=1 tr=0 ts=674c9eff a=uS5QZ7/yp/8NfNiMt4lERQ==:617 a=xqWC_Br6kY4A:10 a=d70CFdQeAAAA:8 a=lk4ATzALKvHUNUYlx5wA:9 a=NcxpMcIZDGm-g932nG_k:22 X-CM-Envelope: MS4xfJ1Yw0wIcjQCVYc8hbkB6G2riM/ATufLTJDYf5ppqBTJWW6nnBQpcrYFYGoFq5tTtp3V5VEn+g3T1c3xEfRQ+xw9rDq49Xw5jvHM+BgcIZQ/Eqeh2XX0 z/pWUn1N9Pripspv5Ue/RF5hRPKjyaxJPBbtZGi9t820+YQa4m2TG9r0jrYgyn0Ja9TS1VtBHtQDQbAAz0ZScwCRL1JfloNwWlzM6LH/eFW5k9nXpYAsIjHn 8vQpRi7qsSp2M1dmIOmmZqL/ZBTP5ddRPfyP9FPSULe+dDiAquM9rn5SuGTXwkqcLtMEQ4K1oc+UpScZWau/PA== 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 ; Sun, 01 Dec 2024 17:38:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5858 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 Sun Dec 1 17:38:09 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 53439 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 4405FD4977B for ; Sun, 1 Dec 2024 17:38:23 +0000 (UTC) Received: from bumble.maple.relay.mailchannels.net (bumble.maple.relay.mailchannels.net [23.83.214.25]) by mx.groups.io with SMTP id smtpd.web11.156375.1733074693200330553 for ; Sun, 01 Dec 2024 09:38:13 -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=iY5Xxh4F; spf=pass (domain: rootcommit.com, ip: 23.83.214.25, 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 B3BC0C1355 for ; Sun, 1 Dec 2024 17:38:12 +0000 (UTC) Received: from fr-int-smtpout2.hostinger.io (trex-5.trex.outbound.svc.cluster.local [100.125.48.165]) (Authenticated sender: hostingeremail) by relay.mailchannels.net (Postfix) with ESMTPA id 12D56C1CB0 for ; Sun, 1 Dec 2024 17:38:11 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1733074692; a=rsa-sha256; cv=none; b=NxAS8VWOryirnW3yV4LXnErr5Drds9+IIxgTYiQyTEpK6cHQkeVgSaRyW+WyLIiGvfn85j Y53/l7j5hNE6fhFMHSweWmQhzxeEfLyHbmmPK77mq4Fnc0qlfKikqLnfavcG677VRz5dEU P4syx82eD/cbw3cqunGHP9nsSF6TpFwQ4F4BaXji2W5L2JFnC/jO3l10Ow5Lzn/7cZsNga 7kbseNajakA/b1r4l82DQbr46YsLefkQpIBMHShVzuzYXmzj67f3F6Q0Pp6vv/0tATItCk Ra1SDPYhumN+tLcoRimN6wc8iq4q54TNaEojMamm5SRb0G51+DIcSYjyIXPoIg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1733074692; 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=2vG40j1uZgiehIhXY+PuTQaPpqoCuV5wwV9FLFcYrqI=; b=yz79VARZZANvq9dRCQVX6wo6WOELf6dGULykPT1PYP0+bLA6FTxOJUQm0bG3Au9zV2Sqqf 1TQ47UA/qW94+0EHJzKNLWwFk1rceuLbrkd3kpSVePVe/fe7bRORZDWGz/4kQm0Lt7WJ9p VEOtVDd9m6aHDb/HYoSSLTlsfiePOoSicNLbbOaOKIWfDTZoBUHXm2tEm0SqVrrDYu6OPI uzL5Aqz4eRPxCtAALwIcm1dASaX1qElql9u66feuCCsyHxjs3j00VpfW0CW+H84/zGcrTt drHw7vqkJO+1WIPUqYMK1ye9wVg2KcSmUXwI8/1Q/iAabGfERc68SeEan8DV6A== ARC-Authentication-Results: i=1; rspamd-fc7fd4597-7h2gj; 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-Whimsical: 56196ae560922b8f_1733074692606_58731269 X-MC-Loop-Signature: 1733074692606:2481312418 X-MC-Ingress-Time: 1733074692606 Received: from fr-int-smtpout2.hostinger.io (fr-int-smtpout2.hostinger.io [89.116.146.81]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.125.48.165 (trex/7.0.2); Sun, 01 Dec 2024 17:38:12 +0000 From: michael.opdenacker@rootcommit.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rootcommit.com; s=hostingermail-a; t=1733074690; 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=2vG40j1uZgiehIhXY+PuTQaPpqoCuV5wwV9FLFcYrqI=; b=iY5Xxh4FqMDbgCa1NT+kd2GILgblZbTj7m6M6lF+6zHzk3HI73WjsSgVsxx5VTPbJAFFZJ noPRFneWjVJR9JIP4+gklq1/A+4ERJcZSsiKaW51WfUpGClQNBxZOTmgilk3yVpWW5TH8g 3d5yXDjH6rEc0D145bvdgyaUqa1BPQ86mCXRQlouzIxIge4WrNhehqMT9ea7hDlIloCmkj kcUTUKUCDpiXnAco6Yr0Y0KCPEZ6vI4v+vaCVIBUC9GA5J8xeIXrLB47R82XDV1HN3K6M3 CXiMDNjJets5memdxK6GIvLtPRaSiTGXAizc+N8ZUgnDRBDGf4VatCy63//ghw== To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH 2/3] dev-manual/bmaptool.rst: add missing command for bmaptool-native Message-ID: <20241201173801.3290796-2-michael.opdenacker@rootcommit.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241201173801.3290796-1-michael.opdenacker@rootcommit.com> References: <20241201173801.3290796-1-michael.opdenacker@rootcommit.com> MIME-Version: 1.0 Date: Sun, 01 Dec 2024 17:38:09 +0000 (UTC) X-CM-Envelope: MS4xfNf85IS+KEXXGTAMd0zVlyZc7mFn+WnVUb5GENEBRw/bB8xsPLhta8qSYr7/d+4XnRJLwX/7PExoRfwbHPOIswouk/c2CcSLCIAWluyQ5/W2CG8SMmZz 5kqZM3k57z9UKdHyrMP5SFbp4Objb1Gs0mHHfEKj1BZjq6Bi2Q9PSZ27uqIMOegvsBoXq6qhIRhE+efEK4r9zkNcnJVEPfbbNTS6mKwtuEBNvSbpq1eJVuDq FEM4tzoPHVfl1PvQz/d82PTxPlXkZ0oQTXV40EdWUX08+hsR5XuK6r452L+Y5K7e33/CmVWYsc4Ex8Mlh2/djQ== X-CM-Analysis: v=2.4 cv=HfJGTTE8 c=1 sm=1 tr=0 ts=674c9f02 a=uS5QZ7/yp/8NfNiMt4lERQ==:617 a=xqWC_Br6kY4A:10 a=d70CFdQeAAAA:8 a=ktER-WpcwBuqhVnq6sEA: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 ; Sun, 01 Dec 2024 17:38:23 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5859 From: Michael Opdenacker Otherwise, running "oe-run-native bmaptool-native bmaptool ..." fails as follows: Error: Have you run 'bitbake bmaptool-native -caddto_recipe_sysroot'? Signed-off-by: Michael Opdenacker --- documentation/dev-manual/bmaptool.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/dev-manual/bmaptool.rst b/documentation/dev-manual/bmaptool.rst index 493abf7607..5fc46c7792 100644 --- a/documentation/dev-manual/bmaptool.rst +++ b/documentation/dev-manual/bmaptool.rst @@ -23,6 +23,7 @@ system image files much faster. 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 Sun Dec 1 17:38:10 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 53438 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 41FC2D49780 for ; Sun, 1 Dec 2024 17:38:23 +0000 (UTC) Received: from bird.aspen.relay.mailchannels.net (bird.aspen.relay.mailchannels.net [23.83.221.17]) by mx.groups.io with SMTP id smtpd.web11.156377.1733074694759276846 for ; Sun, 01 Dec 2024 09:38:14 -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=CX4uZqRP; spf=pass (domain: rootcommit.com, ip: 23.83.221.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 C374F842D32 for ; Sun, 1 Dec 2024 17:38:13 +0000 (UTC) Received: from fr-int-smtpout2.hostinger.io (trex-7.trex.outbound.svc.cluster.local [100.122.114.61]) (Authenticated sender: hostingeremail) by relay.mailchannels.net (Postfix) with ESMTPA id 16289842D1E for ; Sun, 1 Dec 2024 17:38:12 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1733074693; a=rsa-sha256; cv=none; b=nkIW6bjkBfC653AFNCJN1KvWO7Uha2rYHuuqCl5Rw0J3IZC4JWQBzTYbn92FqIMLtLOIAg 8Iez0GlKv6ZBzkpUNP4dQYKLY009DRQgD304bw++yxt/936plKPHvQLfL2KYlDlaUKUfkG S/G6kM2jFvvBkvafh5ZG4lPKLPJ9A41kUoQKfgv9l03R5Fy+M6t7khugTng0H4mXdz36vz 1fmmIeMtQNKJd7SA9l/suhRXQ79VurRrq0B8PnDtGeaXsUoVOQeAwue7GIJvR83aPDmMvd GrXg+9cr2akQRUXHPrsNwYVzn94WA5oIRej2HR1gP1I4F9TGNGiMrwQEZik/Aw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1733074693; 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=XL11T/92g25Li99Hds/gzR38tA3QmUk09XOfVfk2HjY=; b=eRqQbxa5RD9teQKS9W2M8Ey632uN39RXJF0QHCSIXnNdMdwXZK7yFdfmT+GS2wLLRuCyhM Wj8Qhpk3WORDuIqvM8eY/U6M6SHjLyyZYZSYFZMbJnY8/F+QZ3ucNU5qWUluCyz4NMKn0A 3dTq6VY/iE4OQmJ8UlSXz8XFq+fE+RNjIkUAw2I2EFofuEXDfY14EG8qjSkP3Glavv9Tad Ws8HznWgbsek8LDKKL2sQMz4S5gmQ2/Inva/r8YNd4H0WfdB0un7bYHN6A66WfRvw3YIgl l6ROXeGkKMY8FTSU0mFrjlcS2tjy/PeAzyA+/lPLE0wWu+VZyTB5hKTo5y8rng== ARC-Authentication-Results: i=1; rspamd-5d9d86ff64-v6wfl; auth=pass smtp.auth=hostingeremail smtp.mailfrom=michael.opdenacker@rootcommit.com X-Sender-Id: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com X-MC-Relay: Bad X-MailChannels-SenderId: hostingeremail|x-authuser|michael.opdenacker@rootcommit.com X-MailChannels-Auth-Id: hostingeremail X-Industry-Supply: 786141fe650b3ba5_1733074693574_2055758595 X-MC-Loop-Signature: 1733074693574:1595686961 X-MC-Ingress-Time: 1733074693574 Received: from fr-int-smtpout2.hostinger.io (fr-int-smtpout2.hostinger.io [89.116.146.81]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.122.114.61 (trex/7.0.2); Sun, 01 Dec 2024 17:38:13 +0000 From: michael.opdenacker@rootcommit.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rootcommit.com; s=hostingermail-a; t=1733074691; 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=XL11T/92g25Li99Hds/gzR38tA3QmUk09XOfVfk2HjY=; b=CX4uZqRPE0I8fcZApRDETzLdWx+28EjXgMuSh9mFVDVg35LnAbDb3JHXGFxfxhC+/H9Uln DNyv+oFU6cPA/UFfQNkCr1ICXdgrkbUnVBg8rtJagFgAgW8y6DQwZfer2z5vdAZzwIRrgk 010GmgF0KJxHfthqGPsAUDxzVUKFHo5kpSJqK2e2lAIhssJ7xtjR5i+WyEk6TLtBQdFdGc YAC+VlZzbwvFK0EPxv5/tN1FCpvyk0/S42wc2TQUZWIU1NQwmVBg/dlcWKqzZOAawOUcev /dE5UE7v6WD1SSpPAGLnYauRLRgYJRgiUuj5wa9VKEUGkOiX4XWRFHaACf6FUg== To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH 3/3] dev-manual/bmaptool.rst: simplify and fix instructions Message-ID: <20241201173801.3290796-3-michael.opdenacker@rootcommit.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241201173801.3290796-1-michael.opdenacker@rootcommit.com> References: <20241201173801.3290796-1-michael.opdenacker@rootcommit.com> MIME-Version: 1.0 Date: Sun, 01 Dec 2024 17:38:10 +0000 (UTC) X-CM-Analysis: v=2.4 cv=HfJGTTE8 c=1 sm=1 tr=0 ts=674c9f03 a=uS5QZ7/yp/8NfNiMt4lERQ==:617 a=xqWC_Br6kY4A:10 a=d70CFdQeAAAA:8 a=K0np5UDMr5CNkJvIeKUA:9 a=NcxpMcIZDGm-g932nG_k:22 X-CM-Envelope: MS4xfLW0mTTpgvojuDwYEDfrt9CVCNZL6J9GLrXUiutDHwl0jI8rbiYKnSglbFKmB94h2b7X314TebqAuNXhBSpR4L+/NdM1eJgvBb8Jkw+oK0CK9Sk5HZ44 R5cWASkoJGUAVQvFMzn4AWeWUtD5rjB4vql0WiRULj2SR5HN7nt/FmDDjUQNZ0DnWBsE/UqkoC3LH2JiU5PSnroBUOpglU6ckOxVjnGPDb8wjZ1nfps7TPLx zt57jUFESGhjBdhrevmQQWn1wGfPE4KsCnrQaa5s9xNOKnpx5lG6IEEhHOxwdwyfnIeCSn1Qg6o4pN+HfVdTbA== 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 ; Sun, 01 Dec 2024 17:38:23 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5860 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 5fc46c7792..e17074b65b 100644 --- a/documentation/dev-manual/bmaptool.rst +++ b/documentation/dev-manual/bmaptool.rst @@ -44,14 +44,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 + $ such chmod 666 /dev/sdX + + - If you installed the package for `bmaptool`, you can directly run:: + + $ sudo bmaptool copy build-directory/tmp/deploy/images/machine/image.wic /dev/sdX - - If you do not have write access to the media, set your permissions - first and then use the same command form:: + - 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::