include/block/dirty-bitmap.h

   1 #ifndef BLOCK_DIRTY_BITMAP_H
   2 #define BLOCK_DIRTY_BITMAP_H
   3
   4 #include "qapi/qapi-types-block-core.h"
   5 #include "qemu/hbitmap.h"
   6
   7 typedef enum BitmapCheckFlags {
   8     BDRV_BITMAP_BUSY = 1,
   9     BDRV_BITMAP_RO = 2,
  10     BDRV_BITMAP_INCONSISTENT = 4,
  11 } BitmapCheckFlags;
  12
  13 #define BDRV_BITMAP_DEFAULT (BDRV_BITMAP_BUSY | BDRV_BITMAP_RO |        \
  14                              BDRV_BITMAP_INCONSISTENT)
  15 #define BDRV_BITMAP_ALLOW_RO (BDRV_BITMAP_BUSY | BDRV_BITMAP_INCONSISTENT)
  16
  17 BdrvDirtyBitmap *bdrv_create_dirty_bitmap(BlockDriverState *bs,
  18                                           uint32_t granularity,
  19                                           const char *name,
  20                                           Error **errp);
  21 void bdrv_create_meta_dirty_bitmap(BdrvDirtyBitmap *bitmap,
  22                                    int chunk_size);
  23 void bdrv_release_meta_dirty_bitmap(BdrvDirtyBitmap *bitmap);
  24 int bdrv_dirty_bitmap_create_successor(BlockDriverState *bs,
  25                                        BdrvDirtyBitmap *bitmap,
  26                                        Error **errp);
  27 BdrvDirtyBitmap *bdrv_dirty_bitmap_abdicate(BlockDriverState *bs,
  28                                             BdrvDirtyBitmap *bitmap,
  29                                             Error **errp);
  30 BdrvDirtyBitmap *bdrv_reclaim_dirty_bitmap(BlockDriverState *bs,
  31                                            BdrvDirtyBitmap *bitmap,
  32                                            Error **errp);
  33 void bdrv_dirty_bitmap_enable_successor(BdrvDirtyBitmap *bitmap);
  34 BdrvDirtyBitmap *bdrv_find_dirty_bitmap(BlockDriverState *bs,
  35                                         const char *name);
  36 int bdrv_dirty_bitmap_check(const BdrvDirtyBitmap *bitmap, uint32_t flags,
  37                             Error **errp);
  38 void bdrv_release_dirty_bitmap(BlockDriverState *bs, BdrvDirtyBitmap *bitmap);
  39 void bdrv_release_named_dirty_bitmaps(BlockDriverState *bs);
  40 int bdrv_remove_persistent_dirty_bitmap(BlockDriverState *bs, const char *name,
  41                                         Error **errp);
  42 void bdrv_disable_dirty_bitmap(BdrvDirtyBitmap *bitmap);
  43 void bdrv_enable_dirty_bitmap(BdrvDirtyBitmap *bitmap);
  44 void bdrv_enable_dirty_bitmap_locked(BdrvDirtyBitmap *bitmap);
  45 BlockDirtyInfoList *bdrv_query_dirty_bitmaps(BlockDriverState *bs);
  46 uint32_t bdrv_get_default_bitmap_granularity(BlockDriverState *bs);
  47 uint32_t bdrv_dirty_bitmap_granularity(const BdrvDirtyBitmap *bitmap);
  48 bool bdrv_dirty_bitmap_enabled(BdrvDirtyBitmap *bitmap);
  49 bool bdrv_dirty_bitmap_has_successor(BdrvDirtyBitmap *bitmap);
  50 const char *bdrv_dirty_bitmap_name(const BdrvDirtyBitmap *bitmap);
  51 int64_t bdrv_dirty_bitmap_size(const BdrvDirtyBitmap *bitmap);
  52 DirtyBitmapStatus bdrv_dirty_bitmap_status(BdrvDirtyBitmap *bitmap);
  53 void bdrv_set_dirty_bitmap(BdrvDirtyBitmap *bitmap,
  54                            int64_t offset, int64_t bytes);
  55 void bdrv_reset_dirty_bitmap(BdrvDirtyBitmap *bitmap,
  56                              int64_t offset, int64_t bytes);
  57 BdrvDirtyBitmapIter *bdrv_dirty_meta_iter_new(BdrvDirtyBitmap *bitmap);
  58 BdrvDirtyBitmapIter *bdrv_dirty_iter_new(BdrvDirtyBitmap *bitmap);
  59 void bdrv_dirty_iter_free(BdrvDirtyBitmapIter *iter);
  60
  61 uint64_t bdrv_dirty_bitmap_serialization_size(const BdrvDirtyBitmap *bitmap,
  62                                               uint64_t offset, uint64_t bytes);
  63 uint64_t bdrv_dirty_bitmap_serialization_align(const BdrvDirtyBitmap *bitmap);
  64 void bdrv_dirty_bitmap_serialize_part(const BdrvDirtyBitmap *bitmap,
  65                                       uint8_t *buf, uint64_t offset,
  66                                       uint64_t bytes);
  67 void bdrv_dirty_bitmap_deserialize_part(BdrvDirtyBitmap *bitmap,
  68                                         uint8_t *buf, uint64_t offset,
  69                                         uint64_t bytes, bool finish);
  70 void bdrv_dirty_bitmap_deserialize_zeroes(BdrvDirtyBitmap *bitmap,
  71                                           uint64_t offset, uint64_t bytes,
  72                                           bool finish);
  73 void bdrv_dirty_bitmap_deserialize_ones(BdrvDirtyBitmap *bitmap,
  74                                         uint64_t offset, uint64_t bytes,
  75                                         bool finish);
  76 void bdrv_dirty_bitmap_deserialize_finish(BdrvDirtyBitmap *bitmap);
  77
  78 void bdrv_dirty_bitmap_set_readonly(BdrvDirtyBitmap *bitmap, bool value);
  79 void bdrv_dirty_bitmap_set_persistence(BdrvDirtyBitmap *bitmap,
  80                                        bool persistent);
  81 void bdrv_dirty_bitmap_set_inconsistent(BdrvDirtyBitmap *bitmap);
  82 void bdrv_dirty_bitmap_set_busy(BdrvDirtyBitmap *bitmap, bool busy);
  83 void bdrv_merge_dirty_bitmap(BdrvDirtyBitmap *dest, const BdrvDirtyBitmap *src,
  84                              HBitmap **backup, Error **errp);
  85 void bdrv_dirty_bitmap_skip_store(BdrvDirtyBitmap *bitmap, bool skip);
  86 bool bdrv_dirty_bitmap_get(BdrvDirtyBitmap *bitmap, int64_t offset);
  87
  88 /* Functions that require manual locking.  */
  89 void bdrv_dirty_bitmap_lock(BdrvDirtyBitmap *bitmap);
  90 void bdrv_dirty_bitmap_unlock(BdrvDirtyBitmap *bitmap);
  91 bool bdrv_dirty_bitmap_get_locked(BdrvDirtyBitmap *bitmap, int64_t offset);
  92 void bdrv_set_dirty_bitmap_locked(BdrvDirtyBitmap *bitmap,
  93                                   int64_t offset, int64_t bytes);
  94 void bdrv_reset_dirty_bitmap_locked(BdrvDirtyBitmap *bitmap,
  95                                     int64_t offset, int64_t bytes);
  96 int64_t bdrv_dirty_iter_next(BdrvDirtyBitmapIter *iter);
  97 void bdrv_set_dirty_iter(BdrvDirtyBitmapIter *hbi, int64_t offset);
  98 int64_t bdrv_get_dirty_count(BdrvDirtyBitmap *bitmap);
  99 int64_t bdrv_get_meta_dirty_count(BdrvDirtyBitmap *bitmap);
 100 void bdrv_dirty_bitmap_truncate(BlockDriverState *bs, int64_t bytes);
 101 bool bdrv_dirty_bitmap_readonly(const BdrvDirtyBitmap *bitmap);
 102 bool bdrv_has_readonly_bitmaps(BlockDriverState *bs);
 103 bool bdrv_dirty_bitmap_get_autoload(const BdrvDirtyBitmap *bitmap);
 104 bool bdrv_dirty_bitmap_get_persistence(BdrvDirtyBitmap *bitmap);
 105 bool bdrv_dirty_bitmap_inconsistent(const BdrvDirtyBitmap *bitmap);
 106 bool bdrv_has_changed_persistent_bitmaps(BlockDriverState *bs);
 107 BdrvDirtyBitmap *bdrv_dirty_bitmap_next(BlockDriverState *bs,
 108                                         BdrvDirtyBitmap *bitmap);
 109 char *bdrv_dirty_bitmap_sha256(const BdrvDirtyBitmap *bitmap, Error **errp);
 110 int64_t bdrv_dirty_bitmap_next_zero(BdrvDirtyBitmap *bitmap, uint64_t offset,
 111                                     uint64_t bytes);
 112 bool bdrv_dirty_bitmap_next_dirty_area(BdrvDirtyBitmap *bitmap,
 113                                        uint64_t *offset, uint64_t *bytes);
 114 BdrvDirtyBitmap *bdrv_reclaim_dirty_bitmap_locked(BlockDriverState *bs,
 115                                                   BdrvDirtyBitmap *bitmap,
 116                                                   Error **errp);
 117
 118 #endif