mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-06-02 13:29:49 +00:00
Code Issues Projects Releases Wiki Activity

dev-manual: bmaptool: rename

Browse Source 
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 <twoerner@gmail.com>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Trevor Woerner
2024-03-05 17:07:49 -05:00
committed by Richard Purdie
parent dbcb74ef81
commit 002a6bbf66
2 changed files with 11 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/dev-manual/bmaptool.rst
+10 -10
View File
@@ -4,10 +4,10 @@ Flashing Images Using ``bmaptool``
********************************** **********************************
A fast and easy way to flash an image to a bootable device is to use 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, which is integrated into the OpenEmbedded build system.
Bmaptool is a generic tool that creates a file's block map (bmap) and 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 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. system image files much faster.
.. note:: .. note::
@@ -20,13 +20,13 @@ system image files much faster.
$ sudo apt install bmap-tools $ sudo apt install bmap-tools
- If you are unable to install the ``bmap-tools`` package, you will - 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 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 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: 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 #. *Update your local.conf File:* You need to have the following set
in your ``local.conf`` file before building your image:: 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 $ 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 depending on your particular setup. The following commands assume the
image resides in the :term:`Build Directory`'s ``deploy/images/`` area: 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 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 - If you do not have write access to the media, set your permissions
first and then use the same command form:: first and then use the same command form::
$ sudo chmod 666 /dev/sdX $ 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:: For help on the ``bmaptool`` command, use the following command::
documentation/dev-manual/wic.rst
+1 -1
View File
@@ -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 built your image, and boot from the media. You can write the image by using
``bmaptool`` or ``dd``:: ``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 :: or ::