From patchwork Wed Dec 18 14:47:00 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 54285 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 283C4E7718B for ; Wed, 18 Dec 2024 14:47:06 +0000 (UTC) Received: from cheetah.ash.relay.mailchannels.net (cheetah.ash.relay.mailchannels.net [23.83.222.34]) by mx.groups.io with SMTP id smtpd.web10.107010.1734533224608264009 for ; Wed, 18 Dec 2024 06:47:04 -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=f7hM9vIM; spf=pass (domain: rootcommit.com, ip: 23.83.222.34, 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 C4B7D4E3775 for ; Wed, 18 Dec 2024 14:47:03 +0000 (UTC) Received: from nl-srv-smtpout3.hostinger.io (trex-5.trex.outbound.svc.cluster.local [100.106.32.31]) (Authenticated sender: hostingeremail) by relay.mailchannels.net (Postfix) with ESMTPA id 291814E3781 for ; Wed, 18 Dec 2024 14:47:03 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1734533223; a=rsa-sha256; cv=none; b=aInuLfKA6TrDZtnDcbMPq4TcNEewjpnSlwSdBMZ1wbOcTWu1kennI5rTbP7vrGtSn7E9XH boZPMFqJKm5jNx8xBn4cVzknQtZFZnvNE8MLJ1Mxay76XhgkbfJNYujoZKkgOdTz0tHqcc Cb9J39/CHZQuIphUlzzw5PRGHEq0PeYe+hhCPwyAN8S9GacEweE0PLk6WYbuNozhPwjfnK bgLO7b+gOUsXJbTRmxQBCxrix1w9Sf0RNsh/JH3RtFx6Di/a/5lNAYNWowI+rUlb+ZmPEG aIncjeI8chKDIDjlNYVExTi9fnlTwwExxbHAUbzf/1XnB1pt9Vv5Orq+drW4ww== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1734533223; 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=CUsqylXtdj2bH7R5mx1qlKecERrMBkgbCt7Mj3yUV8aS28vT8bsBQJTe0M8wUrD5pJr8BX RBzO46/hm08fBkk5KSG7C3lQPrat0BhqjVETzLcQwqXwU+xtlBh4FqrKNx0BGzKwDFUNAr R74YArI00iMigZy6iV69CcQL6dIej6Sokw1aT8McSKPC7664PCWFQeexSVABwd3qryCh3M TQ/jeXnwix3AcT7OPZ9J/GuQwSkrLBjJlnXx5jIrw+irUjwmRZUNYZmdn5mOELarxiOm+L OCLTYE7XBzNfegO8w7pc68gYWMTEqT/S3JbJgmdNpXmO6baK/lsqP8rgAfbrZw== ARC-Authentication-Results: i=1; rspamd-65b7488cc6-w8n9b; 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-Fearful-Quick: 58de20731df41b5b_1734533223678_1107655055 X-MC-Loop-Signature: 1734533223678:2589807859 X-MC-Ingress-Time: 1734533223677 Received: from nl-srv-smtpout3.hostinger.io (nl-srv-smtpout3.hostinger.io [145.14.159.43]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.106.32.31 (trex/7.0.2); Wed, 18 Dec 2024 14:47:03 +0000 From: michael.opdenacker@rootcommit.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rootcommit.com; s=hostingermail-a; t=1734533221; 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=f7hM9vIMF3ozSVol+8ws/X6NVz6jJZ3Ztfif9SBsV9uGF2C9RIROWMPLa8z2vfxpb4LUWC Ls37XQjJlxnZsOgwpHpZ/SycXN3jrDGwkz2TCZGPFAK/0Cvm9C8yCYtj7zxUoyynvtXyC0 EV7pA5FyrycimxOPOWwtM5OMApnGc/NqccQBzMTS+FvJhrxg0h/unsMORWVuLuPIih2Fgr 54FN65iMwqyVZIQQnbAK0WLdB+h2whykOyxvDdL2oevIHiWH2LEe9n/cjf26cnoPrzfKfY b2R61u5uXgdy6rEGPG82XL8dgLmpMBbABeSjEu8D4XAG3pAmhfCmOQ0eBi4SLg== To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH v3 1/3] dev-manual: fix styling of references to bmaptool Message-ID: <20241218144654.852310-2-michael.opdenacker@rootcommit.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241218144654.852310-1-michael.opdenacker@rootcommit.com> References: <20241218144654.852310-1-michael.opdenacker@rootcommit.com> MIME-Version: 1.0 Date: Wed, 18 Dec 2024 14:47:00 +0000 (UTC) X-CM-Envelope: MS4xfKYLYXCYaLoXnbTaRIR15kLikeyoQvED5b8GHr5msp7m2LXR74AFL4cg4pJgqWSoysJggw/0may7JuV6vzyPMKIMirHWedGNYYIiVP1xgzNi5LW2uj5p Ycb3bSxXjypjhsL8d5kjU+JC2Mc9GMI/uPL+32qgSS7mIus3eBT4MU+jNq31rwyJOX4o/ZWBx5mQOhO8ssLF2dJBzjBs+PLgDhBFotgByXE9LOeZw1cNMqDz g+4aQpfkkcd0n/YMW6X/SczCCLpijIRbdUbbHaTKmpKFiAFlS83rm33Yam6M+WIBuRI/v/wouuwMN8vdzME9Iw== X-CM-Analysis: v=2.4 cv=c/P5Qg9l c=1 sm=1 tr=0 ts=6762e065 a=gK8Kn/iQ+cr19mtFy27wxg==: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, 18 Dec 2024 14:47:06 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5978 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 18 14:47:02 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 54287 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 0BAF6E77187 for ; Wed, 18 Dec 2024 14:47:16 +0000 (UTC) Received: from fuchsia.ash.relay.mailchannels.net (fuchsia.ash.relay.mailchannels.net [23.83.222.64]) by mx.groups.io with SMTP id smtpd.web10.107012.1734533226021038642 for ; Wed, 18 Dec 2024 06:47:06 -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=oITzdoYe; spf=pass (domain: rootcommit.com, ip: 23.83.222.64, 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 DF4171A3DB8 for ; Wed, 18 Dec 2024 14:47:04 +0000 (UTC) Received: from nl-srv-smtpout3.hostinger.io (trex-2.trex.outbound.svc.cluster.local [100.98.196.143]) (Authenticated sender: hostingeremail) by relay.mailchannels.net (Postfix) with ESMTPA id 433431A3D0B for ; Wed, 18 Dec 2024 14:47:04 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1734533224; a=rsa-sha256; cv=none; b=4EKOaD8hbmBeV9s0X3MUpjooea02rAvgqHtqIPOdCQSJdW0ljEdJK3OwnjKOI7x92BP2v6 PK0bcj01R8YJzMSfd9xc6yH6P9nBOREBWh+kJOplJHQjmrDiDAyw4c47S3hWR7YynmCJBz 2vvNxlhtHo93uR3dTk2WPLemyTzeM87l33+HT1P+GDnebSUjHZ+ivGolkVOmBfLWUOMBf0 ehyfo+5aFbzswq+Gx8Zxnxh9xfqFy+5dOZb2SFGBGcY0MmgEynauiM5SkkGptsxExEXocg tc5cUtp79Kboee0AAPs4A+5Vr5yeXPu3ZY87Y+1QL17AcYDLuQ+v3IOhcD8CBw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1734533224; 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=mHGjxQ9IApJ/lwpONwl6K4QuHlYchRtgjqdOGW6FiDWWlcZZM74TLYwkK0FIHORAKaPs58 JyYVPvSRTa8WwagRxOq+Pjw6d4zsnLwItPK7fIU8dG6iKDZe+IT5V1ZmNJy77ofjms19Q4 jtfo53ceywponSJOzIR0RuT3v6BpjH9JRF3qn520xEBJBB8yOfHFt2jvqAR8H/Aa4SI9YH +R7P+wN9FiYwCl+cF5ZvmGoJPJaQmFcvDHaqGlP6l/iRI+5fPdcDNw5m/puoTE9bR4EonS 6DYoVEY00N/VneS+JmVcx37mLpcNqRxN2JnjGQ3GiAoQ9Q7AQhd9RFyZ6xxpeA== ARC-Authentication-Results: i=1; rspamd-65b7488cc6-vknhc; 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-Reaction: 5569f1594ef73b94_1734533224791_2026880605 X-MC-Loop-Signature: 1734533224791:2610746854 X-MC-Ingress-Time: 1734533224791 Received: from nl-srv-smtpout3.hostinger.io (nl-srv-smtpout3.hostinger.io [145.14.159.43]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.98.196.143 (trex/7.0.2); Wed, 18 Dec 2024 14:47:04 +0000 From: michael.opdenacker@rootcommit.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rootcommit.com; s=hostingermail-a; t=1734533222; 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=oITzdoYe+JaXt4olWTrhOWJyNdCTu+B9pgkQw5TBOZb+sruwzKQhrpX+T8KHUKPJT3fYwa X2/lfA++x+HU55Pm/+WJD1kJqD9KAONazDuaomiigtO1K1VuxtMQjo9Wn8MHZx0CafFHU7 DQFeyYLxcweMPPqL8b6eOIM8nV4WcvfV9+cIrFwCrDiyY/3GlwCz+apvHInE3zpS8EvaoB EaRfdxWM+fOxA88DGwc3F0Eyn0Dd+AK7mzWcXc9l+b7rOZQLROsx5pOIjAOo4HzLdcINJ6 ymKaktDagzwQH4RF/gQagYTZ6tFvevpPtEpa9cTpqnxnwT7Vzp2Oj5ykClyCSA== To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH v3 2/3] dev-manual/bmaptool.rst: correct command for bmaptool-native Message-ID: <20241218144654.852310-3-michael.opdenacker@rootcommit.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241218144654.852310-1-michael.opdenacker@rootcommit.com> References: <20241218144654.852310-1-michael.opdenacker@rootcommit.com> MIME-Version: 1.0 Date: Wed, 18 Dec 2024 14:47:02 +0000 (UTC) X-CM-Analysis: v=2.4 cv=c/P5Qg9l c=1 sm=1 tr=0 ts=6762e066 a=gK8Kn/iQ+cr19mtFy27wxg==:617 a=xqWC_Br6kY4A:10 a=d70CFdQeAAAA:8 a=rJ4S2n_EE8Q4mpNx-akA:9 a=NcxpMcIZDGm-g932nG_k:22 X-CM-Envelope: MS4xfEDKJkAfaIR+5UyborfAHAvEau66vLKrewdNwvO5gQvTYn+sHEP1qJy9Vxpo9hZLciD1WmBwgnmpcdwk5cuZUQONvzIDkdKm8Dr5f+1vh9xlyMO+Pbx8 5OsoHFZqT5hX2/JvjJL96u5jPKYEakrzJ6i2L01HZQLjXbRskCanDTKK19w2e3gFGhxhLUa6+R9v65a7P4B+w+JN6b7HQsED95A7r7vY03xA/snGyoWghejX pU2TTLRq8+G6Wa6s1sY5dAiZ0CLH/LKNUqV8/nICghCsjvBbz9pGVttnS9IKOFRURGj/SbRNPs046jmeZMxlWw== 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, 18 Dec 2024 14:47:16 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5979 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 18 14:47:03 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Opdenacker X-Patchwork-Id: 54286 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 0BB4AE77188 for ; Wed, 18 Dec 2024 14:47:16 +0000 (UTC) Received: from toucan.tulip.relay.mailchannels.net (toucan.tulip.relay.mailchannels.net [23.83.218.254]) by mx.groups.io with SMTP id smtpd.web10.107013.1734533226821557282 for ; Wed, 18 Dec 2024 06:47:06 -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=Nby65/j6; spf=pass (domain: rootcommit.com, ip: 23.83.218.254, 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 5CA6724E8A for ; Wed, 18 Dec 2024 14:47:06 +0000 (UTC) Received: from nl-srv-smtpout3.hostinger.io (trex-2.trex.outbound.svc.cluster.local [100.98.196.143]) (Authenticated sender: hostingeremail) by relay.mailchannels.net (Postfix) with ESMTPA id B538A23072 for ; Wed, 18 Dec 2024 14:47:05 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1734533226; a=rsa-sha256; cv=none; b=wx1How6MvjiENyff9JimVaxcMvsj7kLIyGbEe0yBd4HFQL1xc/ECI1GmtBv86Ioa0z9MhQ NgZK8XE8u5t+hnfJFlNfT/irLFunOta+36IzwjOE22X4K5YhzkhqmJUmZH5NyrMaJfyEI1 F9RecsYHD+QiQ5pujlCwY0a/cJAE21FzZ2QHMsvD5xq67hj/rQIZQbmJEXMykYZsNC60kN E56sKv1kw44VOcv/GsXxVxkdLrCtNNuPRYpmdX0wSiW8jzjhLP5nPsK3ygnVieHmFSwPN6 TrdhTnqFcUnj8T4GoV5vw2sEAZCPkYUagfzJewS4LunfwUfdn1WjYyycpG5Uow== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1734533226; 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=3HAWkifi4EJI7oRLPjU4/Ca4RgpGGJOb04fx5ctlIXQ=; b=np9NOnVtLY8DyjcSyAf6Qk0P1QHziy3myPbWFwrnssrbOiZOQZxjD00jDIfkfcvvBDO8PC /dTaAyaKZ30w13h8t6wVJotbWlUOcrdf10+zUr+dkwguHJL3hmjFtLQewQoMR7xigUjbdS GGanGZwYiuk+du55tgk0R4F2tmas13eCjIlWqFwp4lxf8XqeiZTruibWuhzW1guqjC3BLl 4Q9k+bz+q8wqhvF5wuHedNPdbEfdA+mS308vpSeW/8zRZ9ht/fvqe68pBW8434Y9572iPQ ic/dKSshRp9oJaYhDzlQicNL+Ldnb4nebIxN1XNpfOW/VKtn4uJjmwpFPz6WWw== ARC-Authentication-Results: i=1; rspamd-65b7488cc6-blkm4; 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-Abiding-Tank: 68b4623247c2c831_1734533226251_720600406 X-MC-Loop-Signature: 1734533226251:1144832522 X-MC-Ingress-Time: 1734533226250 Received: from nl-srv-smtpout3.hostinger.io (nl-srv-smtpout3.hostinger.io [145.14.159.43]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.98.196.143 (trex/7.0.2); Wed, 18 Dec 2024 14:47:06 +0000 From: michael.opdenacker@rootcommit.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rootcommit.com; s=hostingermail-a; t=1734533223; 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=3HAWkifi4EJI7oRLPjU4/Ca4RgpGGJOb04fx5ctlIXQ=; b=Nby65/j6ZgEwYRABPhd/CxFKU31FpXyDExA7HRlMYTWWn8s9Ckc/5seP2Z+YTjLKN5c1cA 8TENoC+kgM4sDD9S5RwndKoYaWswID36Y8kjIQE5mDF3hDk4KLHqzKBk33zvebDZ1LSNWq p0G8ER5H8Wn4H/qyL1IMjFn2flQzgv+oylbfCgu/dZawNPK85jX+AbT3Wvzr8fDeLkv9/8 2CfCi5qD0ZPpyEeXXK3Fmner6O9a4siPeWXldALI3u1OhCgA0k28gQXdjP7PS8Kx7YOGnw 5eHlaF8vp3eygEQm6yshxK23oh3hCyxUaQe2Lyj/ViyESEWknfZ7jRJPnJWxyA== To: docs@lists.yoctoproject.org Cc: Michael Opdenacker Subject: [PATCH v3 3/3] dev-manual/bmaptool.rst: simplify and fix instructions Message-ID: <20241218144654.852310-4-michael.opdenacker@rootcommit.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241218144654.852310-1-michael.opdenacker@rootcommit.com> References: <20241218144654.852310-1-michael.opdenacker@rootcommit.com> MIME-Version: 1.0 Date: Wed, 18 Dec 2024 14:47:03 +0000 (UTC) X-CM-Envelope: MS4xfMaOopHY+eU93ETr52ShORJtGIa/zztxon7w+j9sZPbyREPsMt8KkrmuXwVANgNjS7wg3oa60CmztZRUu8P32AyS19wSkLEwTANi8rDH+jacxtVF03hH cZahlJw1rTsAjhcC3IADel79DKcpgZq6ZSL6TbhjIC6JDQo4GIP0taeLGMYKMKWJyjfz+hOwGPFcepTukH0D6n4LN2ivB2ITuaCugRZIB9xET+rKpz8tPp29 bRaQ7VSakZewlUPW4yMx8S9OTrVtbJ4MzrXyhf+Q+nTjlFHXO3389u3iJ/7vegwIbPjZ/t5M/KEvmB30KTS8XQ== X-CM-Analysis: v=2.4 cv=c/P5Qg9l c=1 sm=1 tr=0 ts=6762e067 a=gK8Kn/iQ+cr19mtFy27wxg==: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, 18 Dec 2024 14:47:16 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5980 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. - Use "chmod a+w" instead of "chmod 666", better advice, and only run "chmod" in the option that runs "oe-run-native" Signed-off-by: Michael Opdenacker --- documentation/dev-manual/bmaptool.rst | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/documentation/dev-manual/bmaptool.rst b/documentation/dev-manual/bmaptool.rst index 37083c9c64..87162a49c9 100644 --- a/documentation/dev-manual/bmaptool.rst +++ b/documentation/dev-manual/bmaptool.rst @@ -43,14 +43,13 @@ 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 you installed the package for `bmaptool`, you can directly run:: - $ oe-run-native bmaptool-native bmaptool copy build-directory/tmp/deploy/images/machine/image.wic /dev/sdX + $ 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 + $ sudo chmod a+w /dev/sdX # get write access to the media, needed only once after booting $ 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::