Skip to contentSkip to conversation

dev-manual: mention that "bmap-tools" is transitional package

PATCH In review Robert P. J. Day 3 participants 4 messages Jun 11 – Jun 22

lore
Share & tools
lore
#0 lore raw

PATCH v2 1/1 dev-manual: mention that "bmap-tools" is transitional package

For modern Debian and Ubuntu releases, mention that the "bmap-tools" package is transitional to the newer "bmaptool" package.

---

sorry about the earlier typo in the subject line

documentation/dev-manual/bmaptool.rst +6 -0
index 87162a49c..1e5ad2bba 100644
@@ -24,6 +24,12 @@ system image files much faster.
 
          $ bitbake bmaptool-native -caddto_recipe_sysroot
 
+   -  Finally, in modern Ubuntu and Debian releases, the ``bmap-tools``
+      package is a transitional package; it exists solely to ensure
+      backward compatibility and smooth upgrades from older installations.
+      You can safely remove it and install the active package, ``bmaptool``,
+      which contains the actual utilities for flashing block images.
+
 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`:
#1 lore raw

Hi Robert,

Quoted 15 lines · Robert P. J. Day via lists.yoctoproject.org

For modern Debian and Ubuntu releases, mention that the "bmap-tools" package is transitional to the newer "bmaptool" package.

---

sorry about the earlier typo in the subject line

documentation/dev-manual/bmaptool.rst +0 -0
index 87162a49c..1e5ad2bba 100644

documentation/dev-manual/bmaptool.rst system image files much faster. · line 32

Quoted 9 lines
documentation/dev-manual/bmaptool.rst +6 -0
@@ -24,6 +24,12 @@ system image files much faster.
 
           $ bitbake bmaptool-native -caddto_recipe_sysroot
 
+   -  Finally, in modern Ubuntu and Debian releases, the ``bmap-tools``
+      package is a transitional package; it exists solely to ensure
+      backward compatibility and smooth upgrades from older installations.
+      You can safely remove it and install the active package, ``bmaptool``,
+      which contains the actual utilities for flashing block images.
+

Just list this in the first bullet point which is related to Ubuntu and Debian distributions?

I could see switching the default package to install from bmap-tools to bmaptool and add a note (Sphinx note) that on older releases, it was named bmap-tools so install that package instead.

Note that Fedora 43+ has bmap-tools, and Leap 16+ python3-bmap-tools/python3-bmaptools.

Cheers,
Quentin

#2 lore raw
Quoted 33 lines · Quentin Schulz

Hi Robert,

Quoted 16 lines · Robert P. J. Day via lists.yoctoproject.org

For modern Debian and Ubuntu releases, mention that the "bmap-tools" package is transitional to the newer "bmaptool" package.

---

sorry about the earlier typo in the subject line

documentation/dev-manual/bmaptool.rst +0 -0
index 87162a49c..1e5ad2bba 100644

documentation/dev-manual/bmaptool.rst system image files much faster. · line 33

Quoted 10 lines
documentation/dev-manual/bmaptool.rst +6 -0
@@ -24,6 +24,12 @@ system image files much faster.
 
           $ bitbake bmaptool-native -caddto_recipe_sysroot
 
+   -  Finally, in modern Ubuntu and Debian releases, the ``bmap-tools``
+      package is a transitional package; it exists solely to ensure
+      backward compatibility and smooth upgrades from older installations.
+      You can safely remove it and install the active package,
 ``bmaptool``,
+      which contains the actual utilities for flashing block images.
+

Just list this in the first bullet point which is related to Ubuntu and Debian distributions?

Quoted 6 lines

I could see switching the default package to install from bmap-tools to bmaptool and add a note (Sphinx note) that on older releases, it was named bmap-tools so install that package instead.

Note that Fedora 43+ has bmap-tools, and Leap 16+
python3-bmap-tools/python3-bmaptools.

my patch was already merged into master-next, but i like your
suggestion so if antonin thinks it's worth it, he can revert that earlier patch and i can do it your way.

rday

#3 lore raw
Quoted 1 line · Robert P. J. Day

On Fri, 19 Jun 2026, Quentin Schulz wrote:

[...]

Quoted 15 lines
Quoted 15 lines

documentation/dev-manual/bmaptool.rst system image files much faster. · line 32

Quoted 7 lines
documentation/dev-manual/bmaptool.rst +4 -0
+   -  Finally, in modern Ubuntu and Debian releases, the ``bmap-tools``
+      package is a transitional package; it exists solely to ensure
+      backward compatibility and smooth upgrades from older installations.
+      You can safely remove it and install the active package,

``bmaptool``,

documentation/dev-manual/bmaptool.rst +2 -0
+      which contains the actual utilities for flashing block images.
+

Just list this in the first bullet point which is related to Ubuntu and Debian distributions?

I could see switching the default package to install from bmap-tools to bmaptool and add a note (Sphinx note) that on older releases, it was named bmap-tools so install that package instead.

Quoted 6 lines
Quoted 2 lines

Note that Fedora 43+ has bmap-tools, and Leap 16+
python3-bmap-tools/python3-bmaptools.

my patch was already merged into master-next, but i like your
suggestion so if antonin thinks it's worth it, he can revert that earlier patch and i can do it your way.

I dropped it, I also like Quentin's suggestion.

Thanks both,
Antonin