dirty-bitmap · shipping · also block dirty bitmap, QEMU dirty bitmap

Dirty bitmap

A dirty bitmap is a bit vector that marks storage regions written during a tracked interval.

Related Observatory article: Dirty bitmap on hesela.com

For block-change tracking, one bit covers a configured byte range. A smaller write still marks that range; the map is not a byte-by-byte content comparison. QEMU identifies a bitmap by its block node and name. [1]

QEMU v10.1.0 supports transient tracking across image formats; persistence uses QCOW2. An unclean close can make the reloaded bitmap inconsistent and unusable for continued incrementals, without invalidating completed backups. [1]

The QCOW2 in_use flag can indicate outdated tracking data even when bitmap metadata remains structurally well formed. Bitmap data need not be synchronized to the image after every guest write. This does not by itself establish guest-data corruption. [3]

With bitmap-based backup selection, QEMU distinguishes on-success, never and always synchronization policies. Do not generalize incremental backup failure handling to every policy. [2]

Multi-disk scope: QEMU transaction acceptance is not completion of its asynchronous backup jobs. Default individual completion can leave successful and failed disks at different tracking boundaries under on-success bitmap handling; retain a successful incremental that later backups require. Grouped completion coordinates job outcomes, not application quiescing. [1] [4]

Relations

related
Changed block tracking, Incremental backup, QCOW2, Backup verification

Citations

  1. QEMU v10.1.0: dirty bitmaps, granularity, persistence and incremental backup recovery (accessed 2026-10-28)
  2. QEMU v10.1.0 QAPI: BitmapSyncMode and BackupCommon (accessed 2026-10-28)
  3. QEMU v10.1.0 QCOW2 format: bitmap directory and dirty tracking bitmaps (accessed 2026-10-28)
  4. QEMU v10.1.0 QAPI: asynchronous transaction completion, individual and grouped modes (accessed 2026-10-28)

JSON: /data/terms/dirty-bitmap.json

Published by Hesela team · Updated

Report a correction · Editorial standards · Reuse guidance

Cite this page
Hesela team. Dirty bitmap. Hesela. 2026-10-28. https://hesela.dev/terms/dirty-bitmap/