xref: /qemu/block/qcow2-bitmap.c (revision 37677d7d)
1 /*
2  * Bitmaps for the QCOW version 2 format
3  *
4  * Copyright (c) 2014-2017 Vladimir Sementsov-Ogievskiy
5  *
6  * This file is derived from qcow2-snapshot.c, original copyright:
7  * Copyright (c) 2004-2006 Fabrice Bellard
8  *
9  * Permission is hereby granted, free of charge, to any person obtaining a copy
10  * of this software and associated documentation files (the "Software"), to deal
11  * in the Software without restriction, including without limitation the rights
12  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13  * copies of the Software, and to permit persons to whom the Software is
14  * furnished to do so, subject to the following conditions:
15  *
16  * The above copyright notice and this permission notice shall be included in
17  * all copies or substantial portions of the Software.
18  *
19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
22  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
25  * THE SOFTWARE.
26  */
27 
28 #include "qemu/osdep.h"
29 #include "qapi/error.h"
30 #include "qemu/cutils.h"
31 
32 #include "qcow2.h"
33 
34 /* NOTICE: BME here means Bitmaps Extension and used as a namespace for
35  * _internal_ constants. Please do not use this _internal_ abbreviation for
36  * other needs and/or outside of this file. */
37 
38 /* Bitmap directory entry constraints */
39 #define BME_MAX_TABLE_SIZE 0x8000000
40 #define BME_MAX_PHYS_SIZE 0x20000000 /* restrict BdrvDirtyBitmap size in RAM */
41 #define BME_MAX_GRANULARITY_BITS 31
42 #define BME_MIN_GRANULARITY_BITS 9
43 #define BME_MAX_NAME_SIZE 1023
44 
45 #if BME_MAX_TABLE_SIZE * 8ULL > INT_MAX
46 #error In the code bitmap table physical size assumed to fit into int
47 #endif
48 
49 /* Bitmap directory entry flags */
50 #define BME_RESERVED_FLAGS 0xfffffffcU
51 #define BME_FLAG_IN_USE (1U << 0)
52 #define BME_FLAG_AUTO   (1U << 1)
53 
54 /* bits [1, 8] U [56, 63] are reserved */
55 #define BME_TABLE_ENTRY_RESERVED_MASK 0xff000000000001feULL
56 #define BME_TABLE_ENTRY_OFFSET_MASK 0x00fffffffffffe00ULL
57 #define BME_TABLE_ENTRY_FLAG_ALL_ONES (1ULL << 0)
58 
59 typedef struct QEMU_PACKED Qcow2BitmapDirEntry {
60     /* header is 8 byte aligned */
61     uint64_t bitmap_table_offset;
62 
63     uint32_t bitmap_table_size;
64     uint32_t flags;
65 
66     uint8_t type;
67     uint8_t granularity_bits;
68     uint16_t name_size;
69     uint32_t extra_data_size;
70     /* extra data follows  */
71     /* name follows  */
72 } Qcow2BitmapDirEntry;
73 
74 typedef struct Qcow2BitmapTable {
75     uint64_t offset;
76     uint32_t size; /* number of 64bit entries */
77     QSIMPLEQ_ENTRY(Qcow2BitmapTable) entry;
78 } Qcow2BitmapTable;
79 
80 typedef struct Qcow2Bitmap {
81     Qcow2BitmapTable table;
82     uint32_t flags;
83     uint8_t granularity_bits;
84     char *name;
85 
86     BdrvDirtyBitmap *dirty_bitmap;
87 
88     QSIMPLEQ_ENTRY(Qcow2Bitmap) entry;
89 } Qcow2Bitmap;
90 typedef QSIMPLEQ_HEAD(Qcow2BitmapList, Qcow2Bitmap) Qcow2BitmapList;
91 
92 typedef enum BitmapType {
93     BT_DIRTY_TRACKING_BITMAP = 1
94 } BitmapType;
95 
96 static inline bool can_write(BlockDriverState *bs)
97 {
98     return !bdrv_is_read_only(bs) && !(bdrv_get_flags(bs) & BDRV_O_INACTIVE);
99 }
100 
101 static int update_header_sync(BlockDriverState *bs)
102 {
103     int ret;
104 
105     ret = qcow2_update_header(bs);
106     if (ret < 0) {
107         return ret;
108     }
109 
110     return bdrv_flush(bs->file->bs);
111 }
112 
113 static inline void bitmap_table_to_be(uint64_t *bitmap_table, size_t size)
114 {
115     size_t i;
116 
117     for (i = 0; i < size; ++i) {
118         bitmap_table[i] = cpu_to_be64(bitmap_table[i]);
119     }
120 }
121 
122 static int check_table_entry(uint64_t entry, int cluster_size)
123 {
124     uint64_t offset;
125 
126     if (entry & BME_TABLE_ENTRY_RESERVED_MASK) {
127         return -EINVAL;
128     }
129 
130     offset = entry & BME_TABLE_ENTRY_OFFSET_MASK;
131     if (offset != 0) {
132         /* if offset specified, bit 0 is reserved */
133         if (entry & BME_TABLE_ENTRY_FLAG_ALL_ONES) {
134             return -EINVAL;
135         }
136 
137         if (offset % cluster_size != 0) {
138             return -EINVAL;
139         }
140     }
141 
142     return 0;
143 }
144 
145 static int check_constraints_on_bitmap(BlockDriverState *bs,
146                                        const char *name,
147                                        uint32_t granularity,
148                                        Error **errp)
149 {
150     BDRVQcow2State *s = bs->opaque;
151     int granularity_bits = ctz32(granularity);
152     int64_t len = bdrv_getlength(bs);
153 
154     assert(granularity > 0);
155     assert((granularity & (granularity - 1)) == 0);
156 
157     if (len < 0) {
158         error_setg_errno(errp, -len, "Failed to get size of '%s'",
159                          bdrv_get_device_or_node_name(bs));
160         return len;
161     }
162 
163     if (granularity_bits > BME_MAX_GRANULARITY_BITS) {
164         error_setg(errp, "Granularity exceeds maximum (%llu bytes)",
165                    1ULL << BME_MAX_GRANULARITY_BITS);
166         return -EINVAL;
167     }
168     if (granularity_bits < BME_MIN_GRANULARITY_BITS) {
169         error_setg(errp, "Granularity is under minimum (%llu bytes)",
170                    1ULL << BME_MIN_GRANULARITY_BITS);
171         return -EINVAL;
172     }
173 
174     if ((len > (uint64_t)BME_MAX_PHYS_SIZE << granularity_bits) ||
175         (len > (uint64_t)BME_MAX_TABLE_SIZE * s->cluster_size <<
176                granularity_bits))
177     {
178         error_setg(errp, "Too much space will be occupied by the bitmap. "
179                    "Use larger granularity");
180         return -EINVAL;
181     }
182 
183     if (strlen(name) > BME_MAX_NAME_SIZE) {
184         error_setg(errp, "Name length exceeds maximum (%u characters)",
185                    BME_MAX_NAME_SIZE);
186         return -EINVAL;
187     }
188 
189     return 0;
190 }
191 
192 static void clear_bitmap_table(BlockDriverState *bs, uint64_t *bitmap_table,
193                                uint32_t bitmap_table_size)
194 {
195     BDRVQcow2State *s = bs->opaque;
196     int i;
197 
198     for (i = 0; i < bitmap_table_size; ++i) {
199         uint64_t addr = bitmap_table[i] & BME_TABLE_ENTRY_OFFSET_MASK;
200         if (!addr) {
201             continue;
202         }
203 
204         qcow2_free_clusters(bs, addr, s->cluster_size, QCOW2_DISCARD_ALWAYS);
205         bitmap_table[i] = 0;
206     }
207 }
208 
209 static int bitmap_table_load(BlockDriverState *bs, Qcow2BitmapTable *tb,
210                              uint64_t **bitmap_table)
211 {
212     int ret;
213     BDRVQcow2State *s = bs->opaque;
214     uint32_t i;
215     uint64_t *table;
216 
217     assert(tb->size != 0);
218     table = g_try_new(uint64_t, tb->size);
219     if (table == NULL) {
220         return -ENOMEM;
221     }
222 
223     assert(tb->size <= BME_MAX_TABLE_SIZE);
224     ret = bdrv_pread(bs->file, tb->offset,
225                      table, tb->size * sizeof(uint64_t));
226     if (ret < 0) {
227         goto fail;
228     }
229 
230     for (i = 0; i < tb->size; ++i) {
231         table[i] = be64_to_cpu(table[i]);
232         ret = check_table_entry(table[i], s->cluster_size);
233         if (ret < 0) {
234             goto fail;
235         }
236     }
237 
238     *bitmap_table = table;
239     return 0;
240 
241 fail:
242     g_free(table);
243 
244     return ret;
245 }
246 
247 static int free_bitmap_clusters(BlockDriverState *bs, Qcow2BitmapTable *tb)
248 {
249     int ret;
250     uint64_t *bitmap_table;
251 
252     ret = bitmap_table_load(bs, tb, &bitmap_table);
253     if (ret < 0) {
254         return ret;
255     }
256 
257     clear_bitmap_table(bs, bitmap_table, tb->size);
258     qcow2_free_clusters(bs, tb->offset, tb->size * sizeof(uint64_t),
259                         QCOW2_DISCARD_OTHER);
260     g_free(bitmap_table);
261 
262     tb->offset = 0;
263     tb->size = 0;
264 
265     return 0;
266 }
267 
268 /* Return the disk size covered by a single qcow2 cluster of bitmap data. */
269 static uint64_t bytes_covered_by_bitmap_cluster(const BDRVQcow2State *s,
270                                                 const BdrvDirtyBitmap *bitmap)
271 {
272     uint64_t granularity = bdrv_dirty_bitmap_granularity(bitmap);
273     uint64_t limit = granularity * (s->cluster_size << 3);
274 
275     assert(QEMU_IS_ALIGNED(limit,
276                            bdrv_dirty_bitmap_serialization_align(bitmap)));
277     return limit;
278 }
279 
280 /* load_bitmap_data
281  * @bitmap_table entries must satisfy specification constraints.
282  * @bitmap must be cleared */
283 static int load_bitmap_data(BlockDriverState *bs,
284                             const uint64_t *bitmap_table,
285                             uint32_t bitmap_table_size,
286                             BdrvDirtyBitmap *bitmap)
287 {
288     int ret = 0;
289     BDRVQcow2State *s = bs->opaque;
290     uint64_t offset, limit;
291     uint64_t bm_size = bdrv_dirty_bitmap_size(bitmap);
292     uint8_t *buf = NULL;
293     uint64_t i, tab_size =
294             size_to_clusters(s,
295                 bdrv_dirty_bitmap_serialization_size(bitmap, 0, bm_size));
296 
297     if (tab_size != bitmap_table_size || tab_size > BME_MAX_TABLE_SIZE) {
298         return -EINVAL;
299     }
300 
301     buf = g_malloc(s->cluster_size);
302     limit = bytes_covered_by_bitmap_cluster(s, bitmap);
303     for (i = 0, offset = 0; i < tab_size; ++i, offset += limit) {
304         uint64_t count = MIN(bm_size - offset, limit);
305         uint64_t entry = bitmap_table[i];
306         uint64_t data_offset = entry & BME_TABLE_ENTRY_OFFSET_MASK;
307 
308         assert(check_table_entry(entry, s->cluster_size) == 0);
309 
310         if (data_offset == 0) {
311             if (entry & BME_TABLE_ENTRY_FLAG_ALL_ONES) {
312                 bdrv_dirty_bitmap_deserialize_ones(bitmap, offset, count,
313                                                    false);
314             } else {
315                 /* No need to deserialize zeros because the dirty bitmap is
316                  * already cleared */
317             }
318         } else {
319             ret = bdrv_pread(bs->file, data_offset, buf, s->cluster_size);
320             if (ret < 0) {
321                 goto finish;
322             }
323             bdrv_dirty_bitmap_deserialize_part(bitmap, buf, offset, count,
324                                                false);
325         }
326     }
327     ret = 0;
328 
329     bdrv_dirty_bitmap_deserialize_finish(bitmap);
330 
331 finish:
332     g_free(buf);
333 
334     return ret;
335 }
336 
337 static BdrvDirtyBitmap *load_bitmap(BlockDriverState *bs,
338                                     Qcow2Bitmap *bm, Error **errp)
339 {
340     int ret;
341     uint64_t *bitmap_table = NULL;
342     uint32_t granularity;
343     BdrvDirtyBitmap *bitmap = NULL;
344 
345     granularity = 1U << bm->granularity_bits;
346     bitmap = bdrv_create_dirty_bitmap(bs, granularity, bm->name, errp);
347     if (bitmap == NULL) {
348         goto fail;
349     }
350 
351     if (bm->flags & BME_FLAG_IN_USE) {
352         /* Data is unusable, skip loading it */
353         return bitmap;
354     }
355 
356     ret = bitmap_table_load(bs, &bm->table, &bitmap_table);
357     if (ret < 0) {
358         error_setg_errno(errp, -ret,
359                          "Could not read bitmap_table table from image for "
360                          "bitmap '%s'", bm->name);
361         goto fail;
362     }
363 
364     ret = load_bitmap_data(bs, bitmap_table, bm->table.size, bitmap);
365     if (ret < 0) {
366         error_setg_errno(errp, -ret, "Could not read bitmap '%s' from image",
367                          bm->name);
368         goto fail;
369     }
370 
371     g_free(bitmap_table);
372     return bitmap;
373 
374 fail:
375     g_free(bitmap_table);
376     if (bitmap != NULL) {
377         bdrv_release_dirty_bitmap(bs, bitmap);
378     }
379 
380     return NULL;
381 }
382 
383 /*
384  * Bitmap List
385  */
386 
387 /*
388  * Bitmap List private functions
389  * Only Bitmap List knows about bitmap directory structure in Qcow2.
390  */
391 
392 static inline void bitmap_dir_entry_to_cpu(Qcow2BitmapDirEntry *entry)
393 {
394     entry->bitmap_table_offset = be64_to_cpu(entry->bitmap_table_offset);
395     entry->bitmap_table_size = be32_to_cpu(entry->bitmap_table_size);
396     entry->flags = be32_to_cpu(entry->flags);
397     entry->name_size = be16_to_cpu(entry->name_size);
398     entry->extra_data_size = be32_to_cpu(entry->extra_data_size);
399 }
400 
401 static inline void bitmap_dir_entry_to_be(Qcow2BitmapDirEntry *entry)
402 {
403     entry->bitmap_table_offset = cpu_to_be64(entry->bitmap_table_offset);
404     entry->bitmap_table_size = cpu_to_be32(entry->bitmap_table_size);
405     entry->flags = cpu_to_be32(entry->flags);
406     entry->name_size = cpu_to_be16(entry->name_size);
407     entry->extra_data_size = cpu_to_be32(entry->extra_data_size);
408 }
409 
410 static inline int calc_dir_entry_size(size_t name_size, size_t extra_data_size)
411 {
412     int size = sizeof(Qcow2BitmapDirEntry) + name_size + extra_data_size;
413     return ROUND_UP(size, 8);
414 }
415 
416 static inline int dir_entry_size(Qcow2BitmapDirEntry *entry)
417 {
418     return calc_dir_entry_size(entry->name_size, entry->extra_data_size);
419 }
420 
421 static inline const char *dir_entry_name_field(Qcow2BitmapDirEntry *entry)
422 {
423     return (const char *)(entry + 1) + entry->extra_data_size;
424 }
425 
426 static inline char *dir_entry_copy_name(Qcow2BitmapDirEntry *entry)
427 {
428     const char *name_field = dir_entry_name_field(entry);
429     return g_strndup(name_field, entry->name_size);
430 }
431 
432 static inline Qcow2BitmapDirEntry *next_dir_entry(Qcow2BitmapDirEntry *entry)
433 {
434     return (Qcow2BitmapDirEntry *)((uint8_t *)entry + dir_entry_size(entry));
435 }
436 
437 static int check_dir_entry(BlockDriverState *bs, Qcow2BitmapDirEntry *entry)
438 {
439     BDRVQcow2State *s = bs->opaque;
440     uint64_t phys_bitmap_bytes;
441     int64_t len;
442 
443     bool fail = (entry->bitmap_table_size == 0) ||
444                 (entry->bitmap_table_offset == 0) ||
445                 (entry->bitmap_table_offset % s->cluster_size) ||
446                 (entry->bitmap_table_size > BME_MAX_TABLE_SIZE) ||
447                 (entry->granularity_bits > BME_MAX_GRANULARITY_BITS) ||
448                 (entry->granularity_bits < BME_MIN_GRANULARITY_BITS) ||
449                 (entry->flags & BME_RESERVED_FLAGS) ||
450                 (entry->name_size > BME_MAX_NAME_SIZE) ||
451                 (entry->type != BT_DIRTY_TRACKING_BITMAP);
452 
453     if (fail) {
454         return -EINVAL;
455     }
456 
457     phys_bitmap_bytes = (uint64_t)entry->bitmap_table_size * s->cluster_size;
458     len = bdrv_getlength(bs);
459 
460     if (len < 0) {
461         return len;
462     }
463 
464     if (phys_bitmap_bytes > BME_MAX_PHYS_SIZE) {
465         return -EINVAL;
466     }
467 
468     if (!(entry->flags & BME_FLAG_IN_USE) &&
469         (len > ((phys_bitmap_bytes * 8) << entry->granularity_bits)))
470     {
471         /*
472          * We've loaded a valid bitmap (IN_USE not set) or we are going to
473          * store a valid bitmap, but the allocated bitmap table size is not
474          * enough to store this bitmap.
475          *
476          * Note, that it's OK to have an invalid bitmap with invalid size due
477          * to a bitmap that was not correctly saved after image resize.
478          */
479         return -EINVAL;
480     }
481 
482     return 0;
483 }
484 
485 static inline void bitmap_directory_to_be(uint8_t *dir, size_t size)
486 {
487     uint8_t *end = dir + size;
488     while (dir < end) {
489         Qcow2BitmapDirEntry *e = (Qcow2BitmapDirEntry *)dir;
490         dir += dir_entry_size(e);
491 
492         bitmap_dir_entry_to_be(e);
493     }
494 }
495 
496 /*
497  * Bitmap List public functions
498  */
499 
500 static void bitmap_free(Qcow2Bitmap *bm)
501 {
502     if (bm == NULL) {
503         return;
504     }
505 
506     g_free(bm->name);
507     g_free(bm);
508 }
509 
510 static void bitmap_list_free(Qcow2BitmapList *bm_list)
511 {
512     Qcow2Bitmap *bm;
513 
514     if (bm_list == NULL) {
515         return;
516     }
517 
518     while ((bm = QSIMPLEQ_FIRST(bm_list)) != NULL) {
519         QSIMPLEQ_REMOVE_HEAD(bm_list, entry);
520         bitmap_free(bm);
521     }
522 
523     g_free(bm_list);
524 }
525 
526 static Qcow2BitmapList *bitmap_list_new(void)
527 {
528     Qcow2BitmapList *bm_list = g_new(Qcow2BitmapList, 1);
529     QSIMPLEQ_INIT(bm_list);
530 
531     return bm_list;
532 }
533 
534 static uint32_t bitmap_list_count(Qcow2BitmapList *bm_list)
535 {
536     Qcow2Bitmap *bm;
537     uint32_t nb_bitmaps = 0;
538 
539     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
540         nb_bitmaps++;
541     }
542 
543     return nb_bitmaps;
544 }
545 
546 /* bitmap_list_load
547  * Get bitmap list from qcow2 image. Actually reads bitmap directory,
548  * checks it and convert to bitmap list.
549  */
550 static Qcow2BitmapList *bitmap_list_load(BlockDriverState *bs, uint64_t offset,
551                                          uint64_t size, Error **errp)
552 {
553     int ret;
554     BDRVQcow2State *s = bs->opaque;
555     uint8_t *dir, *dir_end;
556     Qcow2BitmapDirEntry *e;
557     uint32_t nb_dir_entries = 0;
558     Qcow2BitmapList *bm_list = NULL;
559 
560     if (size == 0) {
561         error_setg(errp, "Requested bitmap directory size is zero");
562         return NULL;
563     }
564 
565     if (size > QCOW2_MAX_BITMAP_DIRECTORY_SIZE) {
566         error_setg(errp, "Requested bitmap directory size is too big");
567         return NULL;
568     }
569 
570     dir = g_try_malloc(size);
571     if (dir == NULL) {
572         error_setg(errp, "Failed to allocate space for bitmap directory");
573         return NULL;
574     }
575     dir_end = dir + size;
576 
577     ret = bdrv_pread(bs->file, offset, dir, size);
578     if (ret < 0) {
579         error_setg_errno(errp, -ret, "Failed to read bitmap directory");
580         goto fail;
581     }
582 
583     bm_list = bitmap_list_new();
584     for (e = (Qcow2BitmapDirEntry *)dir;
585          e < (Qcow2BitmapDirEntry *)dir_end;
586          e = next_dir_entry(e))
587     {
588         Qcow2Bitmap *bm;
589 
590         if ((uint8_t *)(e + 1) > dir_end) {
591             goto broken_dir;
592         }
593 
594         if (++nb_dir_entries > s->nb_bitmaps) {
595             error_setg(errp, "More bitmaps found than specified in header"
596                        " extension");
597             goto fail;
598         }
599         bitmap_dir_entry_to_cpu(e);
600 
601         if ((uint8_t *)next_dir_entry(e) > dir_end) {
602             goto broken_dir;
603         }
604 
605         if (e->extra_data_size != 0) {
606             error_setg(errp, "Bitmap extra data is not supported");
607             goto fail;
608         }
609 
610         ret = check_dir_entry(bs, e);
611         if (ret < 0) {
612             error_setg(errp, "Bitmap '%.*s' doesn't satisfy the constraints",
613                        e->name_size, dir_entry_name_field(e));
614             goto fail;
615         }
616 
617         bm = g_new0(Qcow2Bitmap, 1);
618         bm->table.offset = e->bitmap_table_offset;
619         bm->table.size = e->bitmap_table_size;
620         bm->flags = e->flags;
621         bm->granularity_bits = e->granularity_bits;
622         bm->name = dir_entry_copy_name(e);
623         QSIMPLEQ_INSERT_TAIL(bm_list, bm, entry);
624     }
625 
626     if (nb_dir_entries != s->nb_bitmaps) {
627         error_setg(errp, "Less bitmaps found than specified in header"
628                          " extension");
629         goto fail;
630     }
631 
632     if ((uint8_t *)e != dir_end) {
633         goto broken_dir;
634     }
635 
636     g_free(dir);
637     return bm_list;
638 
639 broken_dir:
640     ret = -EINVAL;
641     error_setg(errp, "Broken bitmap directory");
642 
643 fail:
644     g_free(dir);
645     bitmap_list_free(bm_list);
646 
647     return NULL;
648 }
649 
650 int qcow2_check_bitmaps_refcounts(BlockDriverState *bs, BdrvCheckResult *res,
651                                   void **refcount_table,
652                                   int64_t *refcount_table_size)
653 {
654     int ret;
655     BDRVQcow2State *s = bs->opaque;
656     Qcow2BitmapList *bm_list;
657     Qcow2Bitmap *bm;
658 
659     if (s->nb_bitmaps == 0) {
660         return 0;
661     }
662 
663     ret = qcow2_inc_refcounts_imrt(bs, res, refcount_table, refcount_table_size,
664                                    s->bitmap_directory_offset,
665                                    s->bitmap_directory_size);
666     if (ret < 0) {
667         return ret;
668     }
669 
670     bm_list = bitmap_list_load(bs, s->bitmap_directory_offset,
671                                s->bitmap_directory_size, NULL);
672     if (bm_list == NULL) {
673         res->corruptions++;
674         return -EINVAL;
675     }
676 
677     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
678         uint64_t *bitmap_table = NULL;
679         int i;
680 
681         ret = qcow2_inc_refcounts_imrt(bs, res,
682                                        refcount_table, refcount_table_size,
683                                        bm->table.offset,
684                                        bm->table.size * sizeof(uint64_t));
685         if (ret < 0) {
686             goto out;
687         }
688 
689         ret = bitmap_table_load(bs, &bm->table, &bitmap_table);
690         if (ret < 0) {
691             res->corruptions++;
692             goto out;
693         }
694 
695         for (i = 0; i < bm->table.size; ++i) {
696             uint64_t entry = bitmap_table[i];
697             uint64_t offset = entry & BME_TABLE_ENTRY_OFFSET_MASK;
698 
699             if (check_table_entry(entry, s->cluster_size) < 0) {
700                 res->corruptions++;
701                 continue;
702             }
703 
704             if (offset == 0) {
705                 continue;
706             }
707 
708             ret = qcow2_inc_refcounts_imrt(bs, res,
709                                            refcount_table, refcount_table_size,
710                                            offset, s->cluster_size);
711             if (ret < 0) {
712                 g_free(bitmap_table);
713                 goto out;
714             }
715         }
716 
717         g_free(bitmap_table);
718     }
719 
720 out:
721     bitmap_list_free(bm_list);
722 
723     return ret;
724 }
725 
726 /* bitmap_list_store
727  * Store bitmap list to qcow2 image as a bitmap directory.
728  * Everything is checked.
729  */
730 static int bitmap_list_store(BlockDriverState *bs, Qcow2BitmapList *bm_list,
731                              uint64_t *offset, uint64_t *size, bool in_place)
732 {
733     int ret;
734     uint8_t *dir;
735     int64_t dir_offset = 0;
736     uint64_t dir_size = 0;
737     Qcow2Bitmap *bm;
738     Qcow2BitmapDirEntry *e;
739 
740     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
741         dir_size += calc_dir_entry_size(strlen(bm->name), 0);
742     }
743 
744     if (dir_size == 0 || dir_size > QCOW2_MAX_BITMAP_DIRECTORY_SIZE) {
745         return -EINVAL;
746     }
747 
748     if (in_place) {
749         if (*size != dir_size || *offset == 0) {
750             return -EINVAL;
751         }
752 
753         dir_offset = *offset;
754     }
755 
756     dir = g_try_malloc0(dir_size);
757     if (dir == NULL) {
758         return -ENOMEM;
759     }
760 
761     e = (Qcow2BitmapDirEntry *)dir;
762     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
763         e->bitmap_table_offset = bm->table.offset;
764         e->bitmap_table_size = bm->table.size;
765         e->flags = bm->flags;
766         e->type = BT_DIRTY_TRACKING_BITMAP;
767         e->granularity_bits = bm->granularity_bits;
768         e->name_size = strlen(bm->name);
769         e->extra_data_size = 0;
770         memcpy(e + 1, bm->name, e->name_size);
771 
772         if (check_dir_entry(bs, e) < 0) {
773             ret = -EINVAL;
774             goto fail;
775         }
776 
777         e = next_dir_entry(e);
778     }
779 
780     bitmap_directory_to_be(dir, dir_size);
781 
782     if (!in_place) {
783         dir_offset = qcow2_alloc_clusters(bs, dir_size);
784         if (dir_offset < 0) {
785             ret = dir_offset;
786             goto fail;
787         }
788     }
789 
790     /* Actually, even in in-place case ignoring QCOW2_OL_BITMAP_DIRECTORY is not
791      * necessary, because we drop QCOW2_AUTOCLEAR_BITMAPS when updating bitmap
792      * directory in-place (actually, turn-off the extension), which is checked
793      * in qcow2_check_metadata_overlap() */
794     ret = qcow2_pre_write_overlap_check(
795             bs, in_place ? QCOW2_OL_BITMAP_DIRECTORY : 0, dir_offset, dir_size,
796             false);
797     if (ret < 0) {
798         goto fail;
799     }
800 
801     ret = bdrv_pwrite(bs->file, dir_offset, dir, dir_size);
802     if (ret < 0) {
803         goto fail;
804     }
805 
806     g_free(dir);
807 
808     if (!in_place) {
809         *size = dir_size;
810         *offset = dir_offset;
811     }
812 
813     return 0;
814 
815 fail:
816     g_free(dir);
817 
818     if (!in_place && dir_offset > 0) {
819         qcow2_free_clusters(bs, dir_offset, dir_size, QCOW2_DISCARD_OTHER);
820     }
821 
822     return ret;
823 }
824 
825 /*
826  * Bitmap List end
827  */
828 
829 static int update_ext_header_and_dir_in_place(BlockDriverState *bs,
830                                               Qcow2BitmapList *bm_list)
831 {
832     BDRVQcow2State *s = bs->opaque;
833     int ret;
834 
835     if (!(s->autoclear_features & QCOW2_AUTOCLEAR_BITMAPS) ||
836         bm_list == NULL || QSIMPLEQ_EMPTY(bm_list) ||
837         bitmap_list_count(bm_list) != s->nb_bitmaps)
838     {
839         return -EINVAL;
840     }
841 
842     s->autoclear_features &= ~(uint64_t)QCOW2_AUTOCLEAR_BITMAPS;
843     ret = update_header_sync(bs);
844     if (ret < 0) {
845         /* Two variants are possible here:
846          * 1. Autoclear flag is dropped, all bitmaps will be lost.
847          * 2. Autoclear flag is not dropped, old state is left.
848          */
849         return ret;
850     }
851 
852     /* autoclear bit is not set, so we can safely update bitmap directory */
853 
854     ret = bitmap_list_store(bs, bm_list, &s->bitmap_directory_offset,
855                             &s->bitmap_directory_size, true);
856     if (ret < 0) {
857         /* autoclear bit is cleared, so all leaked clusters would be removed on
858          * qemu-img check */
859         return ret;
860     }
861 
862     ret = update_header_sync(bs);
863     if (ret < 0) {
864         /* autoclear bit is cleared, so all leaked clusters would be removed on
865          * qemu-img check */
866         return ret;
867     }
868 
869     s->autoclear_features |= QCOW2_AUTOCLEAR_BITMAPS;
870     return update_header_sync(bs);
871     /* If final update_header_sync() fails, two variants are possible:
872      * 1. Autoclear flag is not set, all bitmaps will be lost.
873      * 2. Autoclear flag is set, header and directory are successfully updated.
874      */
875 }
876 
877 static int update_ext_header_and_dir(BlockDriverState *bs,
878                                      Qcow2BitmapList *bm_list)
879 {
880     BDRVQcow2State *s = bs->opaque;
881     int ret;
882     uint64_t new_offset = 0;
883     uint64_t new_size = 0;
884     uint32_t new_nb_bitmaps = 0;
885     uint64_t old_offset = s->bitmap_directory_offset;
886     uint64_t old_size = s->bitmap_directory_size;
887     uint32_t old_nb_bitmaps = s->nb_bitmaps;
888     uint64_t old_autocl = s->autoclear_features;
889 
890     if (bm_list != NULL && !QSIMPLEQ_EMPTY(bm_list)) {
891         new_nb_bitmaps = bitmap_list_count(bm_list);
892 
893         if (new_nb_bitmaps > QCOW2_MAX_BITMAPS) {
894             return -EINVAL;
895         }
896 
897         ret = bitmap_list_store(bs, bm_list, &new_offset, &new_size, false);
898         if (ret < 0) {
899             return ret;
900         }
901 
902         ret = qcow2_flush_caches(bs);
903         if (ret < 0) {
904             goto fail;
905         }
906 
907         s->autoclear_features |= QCOW2_AUTOCLEAR_BITMAPS;
908     } else {
909         s->autoclear_features &= ~(uint64_t)QCOW2_AUTOCLEAR_BITMAPS;
910     }
911 
912     s->bitmap_directory_offset = new_offset;
913     s->bitmap_directory_size = new_size;
914     s->nb_bitmaps = new_nb_bitmaps;
915 
916     ret = update_header_sync(bs);
917     if (ret < 0) {
918         goto fail;
919     }
920 
921     if (old_size > 0) {
922         qcow2_free_clusters(bs, old_offset, old_size, QCOW2_DISCARD_OTHER);
923     }
924 
925     return 0;
926 
927 fail:
928     if (new_offset > 0) {
929         qcow2_free_clusters(bs, new_offset, new_size, QCOW2_DISCARD_OTHER);
930     }
931 
932     s->bitmap_directory_offset = old_offset;
933     s->bitmap_directory_size = old_size;
934     s->nb_bitmaps = old_nb_bitmaps;
935     s->autoclear_features = old_autocl;
936 
937     return ret;
938 }
939 
940 /* for g_slist_foreach for GSList of BdrvDirtyBitmap* elements */
941 static void release_dirty_bitmap_helper(gpointer bitmap,
942                                         gpointer bs)
943 {
944     bdrv_release_dirty_bitmap(bs, bitmap);
945 }
946 
947 /* for g_slist_foreach for GSList of BdrvDirtyBitmap* elements */
948 static void set_readonly_helper(gpointer bitmap, gpointer value)
949 {
950     bdrv_dirty_bitmap_set_readonly(bitmap, (bool)value);
951 }
952 
953 /* qcow2_load_dirty_bitmaps()
954  * Return value is a hint for caller: true means that the Qcow2 header was
955  * updated. (false doesn't mean that the header should be updated by the
956  * caller, it just means that updating was not needed or the image cannot be
957  * written to).
958  * On failure the function returns false.
959  */
960 bool qcow2_load_dirty_bitmaps(BlockDriverState *bs, Error **errp)
961 {
962     BDRVQcow2State *s = bs->opaque;
963     Qcow2BitmapList *bm_list;
964     Qcow2Bitmap *bm;
965     GSList *created_dirty_bitmaps = NULL;
966     bool header_updated = false;
967     bool needs_update = false;
968 
969     if (s->nb_bitmaps == 0) {
970         /* No bitmaps - nothing to do */
971         return false;
972     }
973 
974     bm_list = bitmap_list_load(bs, s->bitmap_directory_offset,
975                                s->bitmap_directory_size, errp);
976     if (bm_list == NULL) {
977         return false;
978     }
979 
980     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
981         BdrvDirtyBitmap *bitmap = load_bitmap(bs, bm, errp);
982         if (bitmap == NULL) {
983             goto fail;
984         }
985 
986         bdrv_dirty_bitmap_set_persistence(bitmap, true);
987         if (bm->flags & BME_FLAG_IN_USE) {
988             bdrv_dirty_bitmap_set_inconsistent(bitmap);
989         } else {
990             /* NB: updated flags only get written if can_write(bs) is true. */
991             bm->flags |= BME_FLAG_IN_USE;
992             needs_update = true;
993         }
994         if (!(bm->flags & BME_FLAG_AUTO)) {
995             bdrv_disable_dirty_bitmap(bitmap);
996         }
997         created_dirty_bitmaps =
998             g_slist_append(created_dirty_bitmaps, bitmap);
999     }
1000 
1001     if (needs_update && can_write(bs)) {
1002         /* in_use flags must be updated */
1003         int ret = update_ext_header_and_dir_in_place(bs, bm_list);
1004         if (ret < 0) {
1005             error_setg_errno(errp, -ret, "Can't update bitmap directory");
1006             goto fail;
1007         }
1008         header_updated = true;
1009     }
1010 
1011     if (!can_write(bs)) {
1012         g_slist_foreach(created_dirty_bitmaps, set_readonly_helper,
1013                         (gpointer)true);
1014     }
1015 
1016     g_slist_free(created_dirty_bitmaps);
1017     bitmap_list_free(bm_list);
1018 
1019     return header_updated;
1020 
1021 fail:
1022     g_slist_foreach(created_dirty_bitmaps, release_dirty_bitmap_helper, bs);
1023     g_slist_free(created_dirty_bitmaps);
1024     bitmap_list_free(bm_list);
1025 
1026     return false;
1027 }
1028 
1029 
1030 static Qcow2BitmapInfoFlagsList *get_bitmap_info_flags(uint32_t flags)
1031 {
1032     Qcow2BitmapInfoFlagsList *list = NULL;
1033     Qcow2BitmapInfoFlagsList **plist = &list;
1034     int i;
1035 
1036     static const struct {
1037         int bme;  /* Bitmap directory entry flags */
1038         int info; /* The flags to report to the user */
1039     } map[] = {
1040         { BME_FLAG_IN_USE, QCOW2_BITMAP_INFO_FLAGS_IN_USE },
1041         { BME_FLAG_AUTO,   QCOW2_BITMAP_INFO_FLAGS_AUTO },
1042     };
1043 
1044     int map_size = ARRAY_SIZE(map);
1045 
1046     for (i = 0; i < map_size; ++i) {
1047         if (flags & map[i].bme) {
1048             Qcow2BitmapInfoFlagsList *entry =
1049                 g_new0(Qcow2BitmapInfoFlagsList, 1);
1050             entry->value = map[i].info;
1051             *plist = entry;
1052             plist = &entry->next;
1053             flags &= ~map[i].bme;
1054         }
1055     }
1056     /* Check if the BME_* mapping above is complete */
1057     assert(!flags);
1058 
1059     return list;
1060 }
1061 
1062 /*
1063  * qcow2_get_bitmap_info_list()
1064  * Returns a list of QCOW2 bitmap details.
1065  * In case of no bitmaps, the function returns NULL and
1066  * the @errp parameter is not set.
1067  * When bitmap information can not be obtained, the function returns
1068  * NULL and the @errp parameter is set.
1069  */
1070 Qcow2BitmapInfoList *qcow2_get_bitmap_info_list(BlockDriverState *bs,
1071                                                 Error **errp)
1072 {
1073     BDRVQcow2State *s = bs->opaque;
1074     Qcow2BitmapList *bm_list;
1075     Qcow2Bitmap *bm;
1076     Qcow2BitmapInfoList *list = NULL;
1077     Qcow2BitmapInfoList **plist = &list;
1078 
1079     if (s->nb_bitmaps == 0) {
1080         return NULL;
1081     }
1082 
1083     bm_list = bitmap_list_load(bs, s->bitmap_directory_offset,
1084                                s->bitmap_directory_size, errp);
1085     if (bm_list == NULL) {
1086         return NULL;
1087     }
1088 
1089     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
1090         Qcow2BitmapInfo *info = g_new0(Qcow2BitmapInfo, 1);
1091         Qcow2BitmapInfoList *obj = g_new0(Qcow2BitmapInfoList, 1);
1092         info->granularity = 1U << bm->granularity_bits;
1093         info->name = g_strdup(bm->name);
1094         info->flags = get_bitmap_info_flags(bm->flags & ~BME_RESERVED_FLAGS);
1095         obj->value = info;
1096         *plist = obj;
1097         plist = &obj->next;
1098     }
1099 
1100     bitmap_list_free(bm_list);
1101 
1102     return list;
1103 }
1104 
1105 int qcow2_reopen_bitmaps_rw_hint(BlockDriverState *bs, bool *header_updated,
1106                                  Error **errp)
1107 {
1108     BDRVQcow2State *s = bs->opaque;
1109     Qcow2BitmapList *bm_list;
1110     Qcow2Bitmap *bm;
1111     GSList *ro_dirty_bitmaps = NULL;
1112     int ret = 0;
1113 
1114     if (header_updated != NULL) {
1115         *header_updated = false;
1116     }
1117 
1118     if (s->nb_bitmaps == 0) {
1119         /* No bitmaps - nothing to do */
1120         return 0;
1121     }
1122 
1123     if (!can_write(bs)) {
1124         error_setg(errp, "Can't write to the image on reopening bitmaps rw");
1125         return -EINVAL;
1126     }
1127 
1128     bm_list = bitmap_list_load(bs, s->bitmap_directory_offset,
1129                                s->bitmap_directory_size, errp);
1130     if (bm_list == NULL) {
1131         return -EINVAL;
1132     }
1133 
1134     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
1135         BdrvDirtyBitmap *bitmap = bdrv_find_dirty_bitmap(bs, bm->name);
1136         if (bitmap == NULL) {
1137             continue;
1138         }
1139 
1140         if (!bdrv_dirty_bitmap_readonly(bitmap)) {
1141             error_setg(errp, "Bitmap %s was loaded prior to rw-reopen, but was "
1142                        "not marked as readonly. This is a bug, something went "
1143                        "wrong. All of the bitmaps may be corrupted", bm->name);
1144             ret = -EINVAL;
1145             goto out;
1146         }
1147 
1148         bm->flags |= BME_FLAG_IN_USE;
1149         ro_dirty_bitmaps = g_slist_append(ro_dirty_bitmaps, bitmap);
1150     }
1151 
1152     if (ro_dirty_bitmaps != NULL) {
1153         /* in_use flags must be updated */
1154         ret = update_ext_header_and_dir_in_place(bs, bm_list);
1155         if (ret < 0) {
1156             error_setg_errno(errp, -ret, "Can't update bitmap directory");
1157             goto out;
1158         }
1159         if (header_updated != NULL) {
1160             *header_updated = true;
1161         }
1162         g_slist_foreach(ro_dirty_bitmaps, set_readonly_helper, false);
1163     }
1164 
1165 out:
1166     g_slist_free(ro_dirty_bitmaps);
1167     bitmap_list_free(bm_list);
1168 
1169     return ret;
1170 }
1171 
1172 int qcow2_reopen_bitmaps_rw(BlockDriverState *bs, Error **errp)
1173 {
1174     return qcow2_reopen_bitmaps_rw_hint(bs, NULL, errp);
1175 }
1176 
1177 /* Checks to see if it's safe to resize bitmaps */
1178 int qcow2_truncate_bitmaps_check(BlockDriverState *bs, Error **errp)
1179 {
1180     BDRVQcow2State *s = bs->opaque;
1181     Qcow2BitmapList *bm_list;
1182     Qcow2Bitmap *bm;
1183     int ret = 0;
1184 
1185     if (s->nb_bitmaps == 0) {
1186         return 0;
1187     }
1188 
1189     bm_list = bitmap_list_load(bs, s->bitmap_directory_offset,
1190                                s->bitmap_directory_size, errp);
1191     if (bm_list == NULL) {
1192         return -EINVAL;
1193     }
1194 
1195     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
1196         BdrvDirtyBitmap *bitmap = bdrv_find_dirty_bitmap(bs, bm->name);
1197         if (bitmap == NULL) {
1198             /*
1199              * We rely on all bitmaps being in-memory to be able to resize them,
1200              * Otherwise, we'd need to resize them on disk explicitly
1201              */
1202             error_setg(errp, "Cannot resize qcow2 with persistent bitmaps that "
1203                        "were not loaded into memory");
1204             ret = -ENOTSUP;
1205             goto out;
1206         }
1207 
1208         /*
1209          * The checks against readonly and busy are redundant, but certainly
1210          * do no harm. checks against inconsistent are crucial:
1211          */
1212         if (bdrv_dirty_bitmap_check(bitmap, BDRV_BITMAP_DEFAULT, errp)) {
1213             ret = -ENOTSUP;
1214             goto out;
1215         }
1216     }
1217 
1218 out:
1219     bitmap_list_free(bm_list);
1220     return ret;
1221 }
1222 
1223 /* store_bitmap_data()
1224  * Store bitmap to image, filling bitmap table accordingly.
1225  */
1226 static uint64_t *store_bitmap_data(BlockDriverState *bs,
1227                                    BdrvDirtyBitmap *bitmap,
1228                                    uint32_t *bitmap_table_size, Error **errp)
1229 {
1230     int ret;
1231     BDRVQcow2State *s = bs->opaque;
1232     int64_t offset;
1233     uint64_t limit;
1234     uint64_t bm_size = bdrv_dirty_bitmap_size(bitmap);
1235     const char *bm_name = bdrv_dirty_bitmap_name(bitmap);
1236     uint8_t *buf = NULL;
1237     BdrvDirtyBitmapIter *dbi;
1238     uint64_t *tb;
1239     uint64_t tb_size =
1240             size_to_clusters(s,
1241                 bdrv_dirty_bitmap_serialization_size(bitmap, 0, bm_size));
1242 
1243     if (tb_size > BME_MAX_TABLE_SIZE ||
1244         tb_size * s->cluster_size > BME_MAX_PHYS_SIZE)
1245     {
1246         error_setg(errp, "Bitmap '%s' is too big", bm_name);
1247         return NULL;
1248     }
1249 
1250     tb = g_try_new0(uint64_t, tb_size);
1251     if (tb == NULL) {
1252         error_setg(errp, "No memory");
1253         return NULL;
1254     }
1255 
1256     dbi = bdrv_dirty_iter_new(bitmap);
1257     buf = g_malloc(s->cluster_size);
1258     limit = bytes_covered_by_bitmap_cluster(s, bitmap);
1259     assert(DIV_ROUND_UP(bm_size, limit) == tb_size);
1260 
1261     while ((offset = bdrv_dirty_iter_next(dbi)) >= 0) {
1262         uint64_t cluster = offset / limit;
1263         uint64_t end, write_size;
1264         int64_t off;
1265 
1266         /*
1267          * We found the first dirty offset, but want to write out the
1268          * entire cluster of the bitmap that includes that offset,
1269          * including any leading zero bits.
1270          */
1271         offset = QEMU_ALIGN_DOWN(offset, limit);
1272         end = MIN(bm_size, offset + limit);
1273         write_size = bdrv_dirty_bitmap_serialization_size(bitmap, offset,
1274                                                           end - offset);
1275         assert(write_size <= s->cluster_size);
1276 
1277         off = qcow2_alloc_clusters(bs, s->cluster_size);
1278         if (off < 0) {
1279             error_setg_errno(errp, -off,
1280                              "Failed to allocate clusters for bitmap '%s'",
1281                              bm_name);
1282             goto fail;
1283         }
1284         tb[cluster] = off;
1285 
1286         bdrv_dirty_bitmap_serialize_part(bitmap, buf, offset, end - offset);
1287         if (write_size < s->cluster_size) {
1288             memset(buf + write_size, 0, s->cluster_size - write_size);
1289         }
1290 
1291         ret = qcow2_pre_write_overlap_check(bs, 0, off, s->cluster_size, false);
1292         if (ret < 0) {
1293             error_setg_errno(errp, -ret, "Qcow2 overlap check failed");
1294             goto fail;
1295         }
1296 
1297         ret = bdrv_pwrite(bs->file, off, buf, s->cluster_size);
1298         if (ret < 0) {
1299             error_setg_errno(errp, -ret, "Failed to write bitmap '%s' to file",
1300                              bm_name);
1301             goto fail;
1302         }
1303 
1304         if (end >= bm_size) {
1305             break;
1306         }
1307 
1308         bdrv_set_dirty_iter(dbi, end);
1309     }
1310 
1311     *bitmap_table_size = tb_size;
1312     g_free(buf);
1313     bdrv_dirty_iter_free(dbi);
1314 
1315     return tb;
1316 
1317 fail:
1318     clear_bitmap_table(bs, tb, tb_size);
1319     g_free(buf);
1320     bdrv_dirty_iter_free(dbi);
1321     g_free(tb);
1322 
1323     return NULL;
1324 }
1325 
1326 /* store_bitmap()
1327  * Store bm->dirty_bitmap to qcow2.
1328  * Set bm->table_offset and bm->table_size accordingly.
1329  */
1330 static int store_bitmap(BlockDriverState *bs, Qcow2Bitmap *bm, Error **errp)
1331 {
1332     int ret;
1333     uint64_t *tb;
1334     int64_t tb_offset;
1335     uint32_t tb_size;
1336     BdrvDirtyBitmap *bitmap = bm->dirty_bitmap;
1337     const char *bm_name;
1338 
1339     assert(bitmap != NULL);
1340 
1341     bm_name = bdrv_dirty_bitmap_name(bitmap);
1342 
1343     tb = store_bitmap_data(bs, bitmap, &tb_size, errp);
1344     if (tb == NULL) {
1345         return -EINVAL;
1346     }
1347 
1348     assert(tb_size <= BME_MAX_TABLE_SIZE);
1349     tb_offset = qcow2_alloc_clusters(bs, tb_size * sizeof(tb[0]));
1350     if (tb_offset < 0) {
1351         error_setg_errno(errp, -tb_offset,
1352                          "Failed to allocate clusters for bitmap '%s'",
1353                          bm_name);
1354         ret = tb_offset;
1355         goto fail;
1356     }
1357 
1358     ret = qcow2_pre_write_overlap_check(bs, 0, tb_offset,
1359                                         tb_size * sizeof(tb[0]), false);
1360     if (ret < 0) {
1361         error_setg_errno(errp, -ret, "Qcow2 overlap check failed");
1362         goto fail;
1363     }
1364 
1365     bitmap_table_to_be(tb, tb_size);
1366     ret = bdrv_pwrite(bs->file, tb_offset, tb, tb_size * sizeof(tb[0]));
1367     if (ret < 0) {
1368         error_setg_errno(errp, -ret, "Failed to write bitmap '%s' to file",
1369                          bm_name);
1370         goto fail;
1371     }
1372 
1373     g_free(tb);
1374 
1375     bm->table.offset = tb_offset;
1376     bm->table.size = tb_size;
1377 
1378     return 0;
1379 
1380 fail:
1381     clear_bitmap_table(bs, tb, tb_size);
1382 
1383     if (tb_offset > 0) {
1384         qcow2_free_clusters(bs, tb_offset, tb_size * sizeof(tb[0]),
1385                             QCOW2_DISCARD_OTHER);
1386     }
1387 
1388     g_free(tb);
1389 
1390     return ret;
1391 }
1392 
1393 static Qcow2Bitmap *find_bitmap_by_name(Qcow2BitmapList *bm_list,
1394                                         const char *name)
1395 {
1396     Qcow2Bitmap *bm;
1397 
1398     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
1399         if (strcmp(name, bm->name) == 0) {
1400             return bm;
1401         }
1402     }
1403 
1404     return NULL;
1405 }
1406 
1407 void qcow2_remove_persistent_dirty_bitmap(BlockDriverState *bs,
1408                                           const char *name,
1409                                           Error **errp)
1410 {
1411     int ret;
1412     BDRVQcow2State *s = bs->opaque;
1413     Qcow2Bitmap *bm;
1414     Qcow2BitmapList *bm_list;
1415 
1416     if (s->nb_bitmaps == 0) {
1417         /* Absence of the bitmap is not an error: see explanation above
1418          * bdrv_remove_persistent_dirty_bitmap() definition. */
1419         return;
1420     }
1421 
1422     bm_list = bitmap_list_load(bs, s->bitmap_directory_offset,
1423                                s->bitmap_directory_size, errp);
1424     if (bm_list == NULL) {
1425         return;
1426     }
1427 
1428     bm = find_bitmap_by_name(bm_list, name);
1429     if (bm == NULL) {
1430         goto fail;
1431     }
1432 
1433     QSIMPLEQ_REMOVE(bm_list, bm, Qcow2Bitmap, entry);
1434 
1435     ret = update_ext_header_and_dir(bs, bm_list);
1436     if (ret < 0) {
1437         error_setg_errno(errp, -ret, "Failed to update bitmap extension");
1438         goto fail;
1439     }
1440 
1441     free_bitmap_clusters(bs, &bm->table);
1442 
1443 fail:
1444     bitmap_free(bm);
1445     bitmap_list_free(bm_list);
1446 }
1447 
1448 void qcow2_store_persistent_dirty_bitmaps(BlockDriverState *bs, Error **errp)
1449 {
1450     BdrvDirtyBitmap *bitmap;
1451     BDRVQcow2State *s = bs->opaque;
1452     uint32_t new_nb_bitmaps = s->nb_bitmaps;
1453     uint64_t new_dir_size = s->bitmap_directory_size;
1454     int ret;
1455     Qcow2BitmapList *bm_list;
1456     Qcow2Bitmap *bm;
1457     QSIMPLEQ_HEAD(, Qcow2BitmapTable) drop_tables;
1458     Qcow2BitmapTable *tb, *tb_next;
1459 
1460     if (!bdrv_has_changed_persistent_bitmaps(bs)) {
1461         /* nothing to do */
1462         return;
1463     }
1464 
1465     if (!can_write(bs)) {
1466         error_setg(errp, "No write access");
1467         return;
1468     }
1469 
1470     QSIMPLEQ_INIT(&drop_tables);
1471 
1472     if (s->nb_bitmaps == 0) {
1473         bm_list = bitmap_list_new();
1474     } else {
1475         bm_list = bitmap_list_load(bs, s->bitmap_directory_offset,
1476                                    s->bitmap_directory_size, errp);
1477         if (bm_list == NULL) {
1478             return;
1479         }
1480     }
1481 
1482     /* check constraints and names */
1483     for (bitmap = bdrv_dirty_bitmap_next(bs, NULL); bitmap != NULL;
1484          bitmap = bdrv_dirty_bitmap_next(bs, bitmap))
1485     {
1486         const char *name = bdrv_dirty_bitmap_name(bitmap);
1487         uint32_t granularity = bdrv_dirty_bitmap_granularity(bitmap);
1488         Qcow2Bitmap *bm;
1489 
1490         if (!bdrv_dirty_bitmap_get_persistence(bitmap) ||
1491             bdrv_dirty_bitmap_readonly(bitmap) ||
1492             bdrv_dirty_bitmap_inconsistent(bitmap)) {
1493             continue;
1494         }
1495 
1496         if (check_constraints_on_bitmap(bs, name, granularity, errp) < 0) {
1497             error_prepend(errp, "Bitmap '%s' doesn't satisfy the constraints: ",
1498                           name);
1499             goto fail;
1500         }
1501 
1502         bm = find_bitmap_by_name(bm_list, name);
1503         if (bm == NULL) {
1504             if (++new_nb_bitmaps > QCOW2_MAX_BITMAPS) {
1505                 error_setg(errp, "Too many persistent bitmaps");
1506                 goto fail;
1507             }
1508 
1509             new_dir_size += calc_dir_entry_size(strlen(name), 0);
1510             if (new_dir_size > QCOW2_MAX_BITMAP_DIRECTORY_SIZE) {
1511                 error_setg(errp, "Bitmap directory is too large");
1512                 goto fail;
1513             }
1514 
1515             bm = g_new0(Qcow2Bitmap, 1);
1516             bm->name = g_strdup(name);
1517             QSIMPLEQ_INSERT_TAIL(bm_list, bm, entry);
1518         } else {
1519             if (!(bm->flags & BME_FLAG_IN_USE)) {
1520                 error_setg(errp, "Bitmap '%s' already exists in the image",
1521                            name);
1522                 goto fail;
1523             }
1524             tb = g_memdup(&bm->table, sizeof(bm->table));
1525             bm->table.offset = 0;
1526             bm->table.size = 0;
1527             QSIMPLEQ_INSERT_TAIL(&drop_tables, tb, entry);
1528         }
1529         bm->flags = bdrv_dirty_bitmap_enabled(bitmap) ? BME_FLAG_AUTO : 0;
1530         bm->granularity_bits = ctz32(bdrv_dirty_bitmap_granularity(bitmap));
1531         bm->dirty_bitmap = bitmap;
1532     }
1533 
1534     /* allocate clusters and store bitmaps */
1535     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
1536         if (bm->dirty_bitmap == NULL) {
1537             continue;
1538         }
1539 
1540         ret = store_bitmap(bs, bm, errp);
1541         if (ret < 0) {
1542             goto fail;
1543         }
1544     }
1545 
1546     ret = update_ext_header_and_dir(bs, bm_list);
1547     if (ret < 0) {
1548         error_setg_errno(errp, -ret, "Failed to update bitmap extension");
1549         goto fail;
1550     }
1551 
1552     /* Bitmap directory was successfully updated, so, old data can be dropped.
1553      * TODO it is better to reuse these clusters */
1554     QSIMPLEQ_FOREACH_SAFE(tb, &drop_tables, entry, tb_next) {
1555         free_bitmap_clusters(bs, tb);
1556         g_free(tb);
1557     }
1558 
1559     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
1560         /* For safety, we remove bitmap after storing.
1561          * We may be here in two cases:
1562          * 1. bdrv_close. It's ok to drop bitmap.
1563          * 2. inactivation. It means migration without 'dirty-bitmaps'
1564          *    capability, so bitmaps are not marked with
1565          *    BdrvDirtyBitmap.migration flags. It's not bad to drop them too,
1566          *    and reload on invalidation.
1567          */
1568         if (bm->dirty_bitmap == NULL) {
1569             continue;
1570         }
1571 
1572         bdrv_release_dirty_bitmap(bs, bm->dirty_bitmap);
1573     }
1574 
1575     bitmap_list_free(bm_list);
1576     return;
1577 
1578 fail:
1579     QSIMPLEQ_FOREACH(bm, bm_list, entry) {
1580         if (bm->dirty_bitmap == NULL || bm->table.offset == 0) {
1581             continue;
1582         }
1583 
1584         free_bitmap_clusters(bs, &bm->table);
1585     }
1586 
1587     QSIMPLEQ_FOREACH_SAFE(tb, &drop_tables, entry, tb_next) {
1588         g_free(tb);
1589     }
1590 
1591     bitmap_list_free(bm_list);
1592 }
1593 
1594 int qcow2_reopen_bitmaps_ro(BlockDriverState *bs, Error **errp)
1595 {
1596     BdrvDirtyBitmap *bitmap;
1597     Error *local_err = NULL;
1598 
1599     qcow2_store_persistent_dirty_bitmaps(bs, &local_err);
1600     if (local_err != NULL) {
1601         error_propagate(errp, local_err);
1602         return -EINVAL;
1603     }
1604 
1605     for (bitmap = bdrv_dirty_bitmap_next(bs, NULL); bitmap != NULL;
1606          bitmap = bdrv_dirty_bitmap_next(bs, bitmap))
1607     {
1608         if (bdrv_dirty_bitmap_get_persistence(bitmap)) {
1609             bdrv_dirty_bitmap_set_readonly(bitmap, true);
1610         }
1611     }
1612 
1613     return 0;
1614 }
1615 
1616 bool qcow2_can_store_new_dirty_bitmap(BlockDriverState *bs,
1617                                       const char *name,
1618                                       uint32_t granularity,
1619                                       Error **errp)
1620 {
1621     BDRVQcow2State *s = bs->opaque;
1622     bool found;
1623     Qcow2BitmapList *bm_list;
1624 
1625     if (s->qcow_version < 3) {
1626         /* Without autoclear_features, we would always have to assume
1627          * that a program without persistent dirty bitmap support has
1628          * accessed this qcow2 file when opening it, and would thus
1629          * have to drop all dirty bitmaps (defeating their purpose).
1630          */
1631         error_setg(errp, "Cannot store dirty bitmaps in qcow2 v2 files");
1632         goto fail;
1633     }
1634 
1635     if (check_constraints_on_bitmap(bs, name, granularity, errp) != 0) {
1636         goto fail;
1637     }
1638 
1639     if (s->nb_bitmaps == 0) {
1640         return true;
1641     }
1642 
1643     if (s->nb_bitmaps >= QCOW2_MAX_BITMAPS) {
1644         error_setg(errp,
1645                    "Maximum number of persistent bitmaps is already reached");
1646         goto fail;
1647     }
1648 
1649     if (s->bitmap_directory_size + calc_dir_entry_size(strlen(name), 0) >
1650         QCOW2_MAX_BITMAP_DIRECTORY_SIZE)
1651     {
1652         error_setg(errp, "Not enough space in the bitmap directory");
1653         goto fail;
1654     }
1655 
1656     bm_list = bitmap_list_load(bs, s->bitmap_directory_offset,
1657                                s->bitmap_directory_size, errp);
1658     if (bm_list == NULL) {
1659         goto fail;
1660     }
1661 
1662     found = find_bitmap_by_name(bm_list, name);
1663     bitmap_list_free(bm_list);
1664     if (found) {
1665         error_setg(errp, "Bitmap with the same name is already stored");
1666         goto fail;
1667     }
1668 
1669     return true;
1670 
1671 fail:
1672     error_prepend(errp, "Can't make bitmap '%s' persistent in '%s': ",
1673                   name, bdrv_get_device_or_node_name(bs));
1674     return false;
1675 }
1676