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.