Man page - bmap2simg(1)

Packages contains this manual

Package:  bmap2simg
apt-get install bmap2simg

Manuals in package:
• bmap2simg(1)
Documentations in package:
• bmap2simg

Manual

bmap2simg

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES

---

NAME

bmap2simg - Converts disk image files with block map (bmap) information to Android sparse images

SYNOPSIS

bmap2simg [ -i | --input-img ] [ -o | --output-simg ] [ -h | --help ] [ -V | --version ] < BMAP >

DESCRIPTION

Converts disk image files with block map (bmap) information to Android sparse images

Reads from stdin and writes to stdout by default, but input/output files can be specified.

OPTIONS

-i , --input-img = FILE

Input image file (default: stdin)

-o , --output-simg = FILE

Output sparse image file (default: stdout)

-h , --help

Print help (see a summary with '-h')

-V , --version

Print version

< BMAP >

Block map file (.bmap)

EXAMPLES

Basic usage (stdin/stdout):
bmap2simg file.bmap < input.img > output.simg

With input file flag:
bmap2simg file.bmap -i input.img > output.simg

With output file flag:
bmap2simg file.bmap -o output.simg < input.img

With both flags:
bmap2simg file.bmap -i input.img -o output.simg

Pipeline with XZ compression:
xzcat 2025-10-01-raspios-trixie-arm64.img.xz \
| bmap2simg 2025-10-01-raspios-trixie-arm64.bmap \
| xz -6 \
> 2025-10-01-raspios-trixie-arm64.simg.xz

This example demonstrates efficient processing of compressed images: decompress the XZ-compressed image on-the-fly, convert it to sparse format using the block map, then recompress the sparse image. This avoids storing the full uncompressed image on disk while creating a compressed sparse image that preserves the original block structure.

---