From 002a6bbf66924e2d485710a8caad96f127d01bc8 Mon Sep 17 00:00:00 2001 From: Trevor Woerner Date: Tue, 5 Mar 2024 17:07:49 -0500 Subject: dev-manual: bmaptool: rename What was previously known variously as Bmaptool, bmaptools, bmap-tool, and/or bmap-tools has been updated to the singular name: bmaptool. Update all references to suit. Since we are not in charge of debian's package naming policy, any references that relate to debian package(s) will stay as "bmap-tools". (From yocto-docs rev: 9c1505eabd69af548652381cf996d44f40a4fa8a) Signed-off-by: Trevor Woerner Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/dev-manual/bmaptool.rst | 20 ++++++++++---------- documentation/dev-manual/wic.rst | 2 +- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/documentation/dev-manual/bmaptool.rst b/documentation/dev-manual/bmaptool.rst index 9add72cf3b..f6f0e6afaf 100644 --- a/documentation/dev-manual/bmaptool.rst +++ b/documentation/dev-manual/bmaptool.rst @@ -4,10 +4,10 @@ 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 bmap-tools-native + $ 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,19 +39,19 @@ 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: - If you have write access to the media, use this command form:: - $ oe-run-native bmap-tools-native bmaptool copy build-directory/tmp/deploy/images/machine/image.wic /dev/sdX + $ oe-run-native bmaptool-native 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:: $ sudo chmod 666 /dev/sdX - $ oe-run-native bmap-tools-native bmaptool copy build-directory/tmp/deploy/images/machine/image.wic /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:: diff --git a/documentation/dev-manual/wic.rst b/documentation/dev-manual/wic.rst index 312f78c403..05e9cb381b 100644 --- a/documentation/dev-manual/wic.rst +++ b/documentation/dev-manual/wic.rst @@ -503,7 +503,7 @@ Continuing with the example, you can now write the image from the built your image, and boot from the media. You can write the image by using ``bmaptool`` or ``dd``:: - $ oe-run-native bmap-tools-native bmaptool copy mkefidisk-201804191017-sda.direct /dev/sdX + $ oe-run-native bmaptool-native bmaptool copy mkefidisk-201804191017-sda.direct /dev/sdX or :: -- cgit v1.2.3-54-g00ecf