diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 95289c990f..811c23e810 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -4824,36 +4824,23 @@
Continuing with the example, you can now write the
- image to a USB stick, or whatever media for which
- you built your image, and boot the resulting media.
-
-
-
- The following example uses dd
- to write the image to a USB stick:
+ image to a USB stick, or whatever media for which you
+ built your image, and boot the resulting media.
+ You can write the image by using
+ bmaptool or
+ dd:
- $ sudo dd if=/var/tmp/wic/build/mkefidisk-201310230946-sda.direct of=/dev/sdb
- [sudo] password for trz:
- 182274+0 records in
- 182274+0 records out
- 93324288 bytes (93 MB) copied, 14.4777 s, 6.4 MB/s
- [trz at empanada ~]$ sudo eject /dev/sdb
+ $ oe-run-native bmaptool copy /var/tmp/wic/build/mkefidisk-201310230946-sda.direct /dev/sdX
-
-
-
- This next example uses the
- bmap-tool.
- For this example, it is assumed you have write
- access:
+ or
- $ oe-run-native bmap-tool copy /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/mkefidisk.wks /dev/sdb
+ $ sudo dd if=/var/tmp/wic/build/mkefidisk-201310230946-sda.direct of=/dev/sdX
For more information on how to use the
- bmap-tool to flash a device
+ bmaptool to flash a device
with an image, see the
- "Flashing Images Using bmap-tool"
+ "Flashing Images Using bmaptool"
section.
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml
index bcee11ba22..fd7e03f1aa 100644
--- a/documentation/dev-manual/dev-manual-start.xml
+++ b/documentation/dev-manual/dev-manual-start.xml
@@ -328,29 +328,39 @@
-
- Flashing Images Using bmap-tool
+
+ Flashing Images Using bmaptool
An easy way to flash an image to a bootable device is to use
- bmap-tool, which is integrated into the
+ bmaptool, which is integrated into the
OpenEmbedded build system.
Following, is an example that shows how to flash a Wic image.
- You can use bmap-tool to flash any
+ You can use bmaptool to flash any
type of image.
Use these steps to flash an image using
- bmap-tool:
+ bmaptool:
+
+ Unless you are able to install the
+ bmap-tools package as mentioned in the note
+ in the second bullet of step 3 further down, you will need to build
+ bmaptool before using it.
+ Build the tool using the following command:
+
+ $ bitbake bmap-tools-native
+
+
Add the following to your local.conf
file:
- IMAGE_FSTYPES += "WIC WIC.BMAP"
+ IMAGE_FSTYPES += "wic wic.bmap"
@@ -361,33 +371,35 @@
- Flash the image to the media by using the
- bmap-tool depending on your particular
+ Flash the image to the media by using
+ bmaptool depending on your particular
setup:
- If you have write access, use this command form:
+ If you have write access to the media,
+ use this command form:
- $ oe-run-native bmap-tool copy ./tmp/deploy/images/qemux86-64/core-image-minimal-machine.wic /dev/sdX
+ $ oe-run-native bmaptool copy ./tmp/deploy/images/qemux86-64/core-image-minimal-machine.wic /dev/sdX
- If you do not have write access, use the following
+ If you do not have write access to
+ the media, use the following
commands:
$ sudo bash
$ PATH=tmp/sysroots/x86_64-linux/usr/bin/ bmaptool copy ./tmp/deploy/images/qemux86-64/core-image-minimal-machine.wic /dev/sdX
- If you are using Ubuntu 16.10 or Debian,
- you can install
- bmaptool using the
+ If you are using Ubuntu or Debian distributions,
+ you can install the
+ bmap-tools package using the
following command and then use the tool
without specifying
PATH even from the
root account:
- $ sudo apt-get install bmap-tool
+ $ sudo apt-get install bmap-tools
@@ -397,26 +409,11 @@
- For help on the bmaptool command, use
- bmaptool --help:
+ For help on the bmaptool command, use either of
+ the following commands:
$ bmaptool --help
- usage: bmaptool [-h] [--version] [-q] [-d] {create,copy} ...
-
- Create block map (bmap) and copy files using bmap. The documentation can be
- found here: source.tizen.org/documentation/reference/bmaptool
-
- optional arguments:
- -h, --help show this help message and exit
- --version show program's version number and exit
- -q, --quiet be quiet
- -d, --debug print debugging information
-
- subcommands:
- {create,copy}
- create generate bmap for an image file (which should be a sparse
- file)
- copy write an image to a block device using bmap
+ $ oe-run-native bmaptool --help