xref: /openbmc/qemu/block/qcow2-cluster.c (revision 14a650ec)
1 /*
2  * Block driver for the QCOW version 2 format
3  *
4  * Copyright (c) 2004-2006 Fabrice Bellard
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a copy
7  * of this software and associated documentation files (the "Software"), to deal
8  * in the Software without restriction, including without limitation the rights
9  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10  * copies of the Software, and to permit persons to whom the Software is
11  * furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in
14  * all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22  * THE SOFTWARE.
23  */
24 
25 #include <zlib.h>
26 
27 #include "qemu-common.h"
28 #include "block/block_int.h"
29 #include "block/qcow2.h"
30 #include "trace.h"
31 
32 int qcow2_grow_l1_table(BlockDriverState *bs, uint64_t min_size,
33                         bool exact_size)
34 {
35     BDRVQcowState *s = bs->opaque;
36     int new_l1_size2, ret, i;
37     uint64_t *new_l1_table;
38     int64_t old_l1_table_offset, old_l1_size;
39     int64_t new_l1_table_offset, new_l1_size;
40     uint8_t data[12];
41 
42     if (min_size <= s->l1_size)
43         return 0;
44 
45     if (exact_size) {
46         new_l1_size = min_size;
47     } else {
48         /* Bump size up to reduce the number of times we have to grow */
49         new_l1_size = s->l1_size;
50         if (new_l1_size == 0) {
51             new_l1_size = 1;
52         }
53         while (min_size > new_l1_size) {
54             new_l1_size = (new_l1_size * 3 + 1) / 2;
55         }
56     }
57 
58     if (new_l1_size > INT_MAX) {
59         return -EFBIG;
60     }
61 
62 #ifdef DEBUG_ALLOC2
63     fprintf(stderr, "grow l1_table from %d to %" PRId64 "\n",
64             s->l1_size, new_l1_size);
65 #endif
66 
67     new_l1_size2 = sizeof(uint64_t) * new_l1_size;
68     new_l1_table = g_malloc0(align_offset(new_l1_size2, 512));
69     memcpy(new_l1_table, s->l1_table, s->l1_size * sizeof(uint64_t));
70 
71     /* write new table (align to cluster) */
72     BLKDBG_EVENT(bs->file, BLKDBG_L1_GROW_ALLOC_TABLE);
73     new_l1_table_offset = qcow2_alloc_clusters(bs, new_l1_size2);
74     if (new_l1_table_offset < 0) {
75         g_free(new_l1_table);
76         return new_l1_table_offset;
77     }
78 
79     ret = qcow2_cache_flush(bs, s->refcount_block_cache);
80     if (ret < 0) {
81         goto fail;
82     }
83 
84     /* the L1 position has not yet been updated, so these clusters must
85      * indeed be completely free */
86     ret = qcow2_pre_write_overlap_check(bs, 0, new_l1_table_offset,
87                                         new_l1_size2);
88     if (ret < 0) {
89         goto fail;
90     }
91 
92     BLKDBG_EVENT(bs->file, BLKDBG_L1_GROW_WRITE_TABLE);
93     for(i = 0; i < s->l1_size; i++)
94         new_l1_table[i] = cpu_to_be64(new_l1_table[i]);
95     ret = bdrv_pwrite_sync(bs->file, new_l1_table_offset, new_l1_table, new_l1_size2);
96     if (ret < 0)
97         goto fail;
98     for(i = 0; i < s->l1_size; i++)
99         new_l1_table[i] = be64_to_cpu(new_l1_table[i]);
100 
101     /* set new table */
102     BLKDBG_EVENT(bs->file, BLKDBG_L1_GROW_ACTIVATE_TABLE);
103     cpu_to_be32w((uint32_t*)data, new_l1_size);
104     stq_be_p(data + 4, new_l1_table_offset);
105     ret = bdrv_pwrite_sync(bs->file, offsetof(QCowHeader, l1_size), data,sizeof(data));
106     if (ret < 0) {
107         goto fail;
108     }
109     g_free(s->l1_table);
110     old_l1_table_offset = s->l1_table_offset;
111     s->l1_table_offset = new_l1_table_offset;
112     s->l1_table = new_l1_table;
113     old_l1_size = s->l1_size;
114     s->l1_size = new_l1_size;
115     qcow2_free_clusters(bs, old_l1_table_offset, old_l1_size * sizeof(uint64_t),
116                         QCOW2_DISCARD_OTHER);
117     return 0;
118  fail:
119     g_free(new_l1_table);
120     qcow2_free_clusters(bs, new_l1_table_offset, new_l1_size2,
121                         QCOW2_DISCARD_OTHER);
122     return ret;
123 }
124 
125 /*
126  * l2_load
127  *
128  * Loads a L2 table into memory. If the table is in the cache, the cache
129  * is used; otherwise the L2 table is loaded from the image file.
130  *
131  * Returns a pointer to the L2 table on success, or NULL if the read from
132  * the image file failed.
133  */
134 
135 static int l2_load(BlockDriverState *bs, uint64_t l2_offset,
136     uint64_t **l2_table)
137 {
138     BDRVQcowState *s = bs->opaque;
139     int ret;
140 
141     ret = qcow2_cache_get(bs, s->l2_table_cache, l2_offset, (void**) l2_table);
142 
143     return ret;
144 }
145 
146 /*
147  * Writes one sector of the L1 table to the disk (can't update single entries
148  * and we really don't want bdrv_pread to perform a read-modify-write)
149  */
150 #define L1_ENTRIES_PER_SECTOR (512 / 8)
151 int qcow2_write_l1_entry(BlockDriverState *bs, int l1_index)
152 {
153     BDRVQcowState *s = bs->opaque;
154     uint64_t buf[L1_ENTRIES_PER_SECTOR];
155     int l1_start_index;
156     int i, ret;
157 
158     l1_start_index = l1_index & ~(L1_ENTRIES_PER_SECTOR - 1);
159     for (i = 0; i < L1_ENTRIES_PER_SECTOR; i++) {
160         buf[i] = cpu_to_be64(s->l1_table[l1_start_index + i]);
161     }
162 
163     ret = qcow2_pre_write_overlap_check(bs, QCOW2_OL_ACTIVE_L1,
164             s->l1_table_offset + 8 * l1_start_index, sizeof(buf));
165     if (ret < 0) {
166         return ret;
167     }
168 
169     BLKDBG_EVENT(bs->file, BLKDBG_L1_UPDATE);
170     ret = bdrv_pwrite_sync(bs->file, s->l1_table_offset + 8 * l1_start_index,
171         buf, sizeof(buf));
172     if (ret < 0) {
173         return ret;
174     }
175 
176     return 0;
177 }
178 
179 /*
180  * l2_allocate
181  *
182  * Allocate a new l2 entry in the file. If l1_index points to an already
183  * used entry in the L2 table (i.e. we are doing a copy on write for the L2
184  * table) copy the contents of the old L2 table into the newly allocated one.
185  * Otherwise the new table is initialized with zeros.
186  *
187  */
188 
189 static int l2_allocate(BlockDriverState *bs, int l1_index, uint64_t **table)
190 {
191     BDRVQcowState *s = bs->opaque;
192     uint64_t old_l2_offset;
193     uint64_t *l2_table = NULL;
194     int64_t l2_offset;
195     int ret;
196 
197     old_l2_offset = s->l1_table[l1_index];
198 
199     trace_qcow2_l2_allocate(bs, l1_index);
200 
201     /* allocate a new l2 entry */
202 
203     l2_offset = qcow2_alloc_clusters(bs, s->l2_size * sizeof(uint64_t));
204     if (l2_offset < 0) {
205         ret = l2_offset;
206         goto fail;
207     }
208 
209     ret = qcow2_cache_flush(bs, s->refcount_block_cache);
210     if (ret < 0) {
211         goto fail;
212     }
213 
214     /* allocate a new entry in the l2 cache */
215 
216     trace_qcow2_l2_allocate_get_empty(bs, l1_index);
217     ret = qcow2_cache_get_empty(bs, s->l2_table_cache, l2_offset, (void**) table);
218     if (ret < 0) {
219         goto fail;
220     }
221 
222     l2_table = *table;
223 
224     if ((old_l2_offset & L1E_OFFSET_MASK) == 0) {
225         /* if there was no old l2 table, clear the new table */
226         memset(l2_table, 0, s->l2_size * sizeof(uint64_t));
227     } else {
228         uint64_t* old_table;
229 
230         /* if there was an old l2 table, read it from the disk */
231         BLKDBG_EVENT(bs->file, BLKDBG_L2_ALLOC_COW_READ);
232         ret = qcow2_cache_get(bs, s->l2_table_cache,
233             old_l2_offset & L1E_OFFSET_MASK,
234             (void**) &old_table);
235         if (ret < 0) {
236             goto fail;
237         }
238 
239         memcpy(l2_table, old_table, s->cluster_size);
240 
241         ret = qcow2_cache_put(bs, s->l2_table_cache, (void**) &old_table);
242         if (ret < 0) {
243             goto fail;
244         }
245     }
246 
247     /* write the l2 table to the file */
248     BLKDBG_EVENT(bs->file, BLKDBG_L2_ALLOC_WRITE);
249 
250     trace_qcow2_l2_allocate_write_l2(bs, l1_index);
251     qcow2_cache_entry_mark_dirty(s->l2_table_cache, l2_table);
252     ret = qcow2_cache_flush(bs, s->l2_table_cache);
253     if (ret < 0) {
254         goto fail;
255     }
256 
257     /* update the L1 entry */
258     trace_qcow2_l2_allocate_write_l1(bs, l1_index);
259     s->l1_table[l1_index] = l2_offset | QCOW_OFLAG_COPIED;
260     ret = qcow2_write_l1_entry(bs, l1_index);
261     if (ret < 0) {
262         goto fail;
263     }
264 
265     *table = l2_table;
266     trace_qcow2_l2_allocate_done(bs, l1_index, 0);
267     return 0;
268 
269 fail:
270     trace_qcow2_l2_allocate_done(bs, l1_index, ret);
271     if (l2_table != NULL) {
272         qcow2_cache_put(bs, s->l2_table_cache, (void**) table);
273     }
274     s->l1_table[l1_index] = old_l2_offset;
275     if (l2_offset > 0) {
276         qcow2_free_clusters(bs, l2_offset, s->l2_size * sizeof(uint64_t),
277                             QCOW2_DISCARD_ALWAYS);
278     }
279     return ret;
280 }
281 
282 /*
283  * Checks how many clusters in a given L2 table are contiguous in the image
284  * file. As soon as one of the flags in the bitmask stop_flags changes compared
285  * to the first cluster, the search is stopped and the cluster is not counted
286  * as contiguous. (This allows it, for example, to stop at the first compressed
287  * cluster which may require a different handling)
288  */
289 static int count_contiguous_clusters(uint64_t nb_clusters, int cluster_size,
290         uint64_t *l2_table, uint64_t stop_flags)
291 {
292     int i;
293     uint64_t mask = stop_flags | L2E_OFFSET_MASK | QCOW_OFLAG_COMPRESSED;
294     uint64_t first_entry = be64_to_cpu(l2_table[0]);
295     uint64_t offset = first_entry & mask;
296 
297     if (!offset)
298         return 0;
299 
300     assert(qcow2_get_cluster_type(first_entry) != QCOW2_CLUSTER_COMPRESSED);
301 
302     for (i = 0; i < nb_clusters; i++) {
303         uint64_t l2_entry = be64_to_cpu(l2_table[i]) & mask;
304         if (offset + (uint64_t) i * cluster_size != l2_entry) {
305             break;
306         }
307     }
308 
309 	return i;
310 }
311 
312 static int count_contiguous_free_clusters(uint64_t nb_clusters, uint64_t *l2_table)
313 {
314     int i;
315 
316     for (i = 0; i < nb_clusters; i++) {
317         int type = qcow2_get_cluster_type(be64_to_cpu(l2_table[i]));
318 
319         if (type != QCOW2_CLUSTER_UNALLOCATED) {
320             break;
321         }
322     }
323 
324     return i;
325 }
326 
327 /* The crypt function is compatible with the linux cryptoloop
328    algorithm for < 4 GB images. NOTE: out_buf == in_buf is
329    supported */
330 void qcow2_encrypt_sectors(BDRVQcowState *s, int64_t sector_num,
331                            uint8_t *out_buf, const uint8_t *in_buf,
332                            int nb_sectors, int enc,
333                            const AES_KEY *key)
334 {
335     union {
336         uint64_t ll[2];
337         uint8_t b[16];
338     } ivec;
339     int i;
340 
341     for(i = 0; i < nb_sectors; i++) {
342         ivec.ll[0] = cpu_to_le64(sector_num);
343         ivec.ll[1] = 0;
344         AES_cbc_encrypt(in_buf, out_buf, 512, key,
345                         ivec.b, enc);
346         sector_num++;
347         in_buf += 512;
348         out_buf += 512;
349     }
350 }
351 
352 static int coroutine_fn copy_sectors(BlockDriverState *bs,
353                                      uint64_t start_sect,
354                                      uint64_t cluster_offset,
355                                      int n_start, int n_end)
356 {
357     BDRVQcowState *s = bs->opaque;
358     QEMUIOVector qiov;
359     struct iovec iov;
360     int n, ret;
361 
362     /*
363      * If this is the last cluster and it is only partially used, we must only
364      * copy until the end of the image, or bdrv_check_request will fail for the
365      * bdrv_read/write calls below.
366      */
367     if (start_sect + n_end > bs->total_sectors) {
368         n_end = bs->total_sectors - start_sect;
369     }
370 
371     n = n_end - n_start;
372     if (n <= 0) {
373         return 0;
374     }
375 
376     iov.iov_len = n * BDRV_SECTOR_SIZE;
377     iov.iov_base = qemu_blockalign(bs, iov.iov_len);
378 
379     qemu_iovec_init_external(&qiov, &iov, 1);
380 
381     BLKDBG_EVENT(bs->file, BLKDBG_COW_READ);
382 
383     /* Call .bdrv_co_readv() directly instead of using the public block-layer
384      * interface.  This avoids double I/O throttling and request tracking,
385      * which can lead to deadlock when block layer copy-on-read is enabled.
386      */
387     ret = bs->drv->bdrv_co_readv(bs, start_sect + n_start, n, &qiov);
388     if (ret < 0) {
389         goto out;
390     }
391 
392     if (s->crypt_method) {
393         qcow2_encrypt_sectors(s, start_sect + n_start,
394                         iov.iov_base, iov.iov_base, n, 1,
395                         &s->aes_encrypt_key);
396     }
397 
398     ret = qcow2_pre_write_overlap_check(bs, 0,
399             cluster_offset + n_start * BDRV_SECTOR_SIZE, n * BDRV_SECTOR_SIZE);
400     if (ret < 0) {
401         goto out;
402     }
403 
404     BLKDBG_EVENT(bs->file, BLKDBG_COW_WRITE);
405     ret = bdrv_co_writev(bs->file, (cluster_offset >> 9) + n_start, n, &qiov);
406     if (ret < 0) {
407         goto out;
408     }
409 
410     ret = 0;
411 out:
412     qemu_vfree(iov.iov_base);
413     return ret;
414 }
415 
416 
417 /*
418  * get_cluster_offset
419  *
420  * For a given offset of the disk image, find the cluster offset in
421  * qcow2 file. The offset is stored in *cluster_offset.
422  *
423  * on entry, *num is the number of contiguous sectors we'd like to
424  * access following offset.
425  *
426  * on exit, *num is the number of contiguous sectors we can read.
427  *
428  * Returns the cluster type (QCOW2_CLUSTER_*) on success, -errno in error
429  * cases.
430  */
431 int qcow2_get_cluster_offset(BlockDriverState *bs, uint64_t offset,
432     int *num, uint64_t *cluster_offset)
433 {
434     BDRVQcowState *s = bs->opaque;
435     unsigned int l2_index;
436     uint64_t l1_index, l2_offset, *l2_table;
437     int l1_bits, c;
438     unsigned int index_in_cluster, nb_clusters;
439     uint64_t nb_available, nb_needed;
440     int ret;
441 
442     index_in_cluster = (offset >> 9) & (s->cluster_sectors - 1);
443     nb_needed = *num + index_in_cluster;
444 
445     l1_bits = s->l2_bits + s->cluster_bits;
446 
447     /* compute how many bytes there are between the offset and
448      * the end of the l1 entry
449      */
450 
451     nb_available = (1ULL << l1_bits) - (offset & ((1ULL << l1_bits) - 1));
452 
453     /* compute the number of available sectors */
454 
455     nb_available = (nb_available >> 9) + index_in_cluster;
456 
457     if (nb_needed > nb_available) {
458         nb_needed = nb_available;
459     }
460 
461     *cluster_offset = 0;
462 
463     /* seek the the l2 offset in the l1 table */
464 
465     l1_index = offset >> l1_bits;
466     if (l1_index >= s->l1_size) {
467         ret = QCOW2_CLUSTER_UNALLOCATED;
468         goto out;
469     }
470 
471     l2_offset = s->l1_table[l1_index] & L1E_OFFSET_MASK;
472     if (!l2_offset) {
473         ret = QCOW2_CLUSTER_UNALLOCATED;
474         goto out;
475     }
476 
477     /* load the l2 table in memory */
478 
479     ret = l2_load(bs, l2_offset, &l2_table);
480     if (ret < 0) {
481         return ret;
482     }
483 
484     /* find the cluster offset for the given disk offset */
485 
486     l2_index = (offset >> s->cluster_bits) & (s->l2_size - 1);
487     *cluster_offset = be64_to_cpu(l2_table[l2_index]);
488     nb_clusters = size_to_clusters(s, nb_needed << 9);
489 
490     ret = qcow2_get_cluster_type(*cluster_offset);
491     switch (ret) {
492     case QCOW2_CLUSTER_COMPRESSED:
493         /* Compressed clusters can only be processed one by one */
494         c = 1;
495         *cluster_offset &= L2E_COMPRESSED_OFFSET_SIZE_MASK;
496         break;
497     case QCOW2_CLUSTER_ZERO:
498         if (s->qcow_version < 3) {
499             return -EIO;
500         }
501         c = count_contiguous_clusters(nb_clusters, s->cluster_size,
502                 &l2_table[l2_index], QCOW_OFLAG_ZERO);
503         *cluster_offset = 0;
504         break;
505     case QCOW2_CLUSTER_UNALLOCATED:
506         /* how many empty clusters ? */
507         c = count_contiguous_free_clusters(nb_clusters, &l2_table[l2_index]);
508         *cluster_offset = 0;
509         break;
510     case QCOW2_CLUSTER_NORMAL:
511         /* how many allocated clusters ? */
512         c = count_contiguous_clusters(nb_clusters, s->cluster_size,
513                 &l2_table[l2_index], QCOW_OFLAG_ZERO);
514         *cluster_offset &= L2E_OFFSET_MASK;
515         break;
516     default:
517         abort();
518     }
519 
520     qcow2_cache_put(bs, s->l2_table_cache, (void**) &l2_table);
521 
522     nb_available = (c * s->cluster_sectors);
523 
524 out:
525     if (nb_available > nb_needed)
526         nb_available = nb_needed;
527 
528     *num = nb_available - index_in_cluster;
529 
530     return ret;
531 }
532 
533 /*
534  * get_cluster_table
535  *
536  * for a given disk offset, load (and allocate if needed)
537  * the l2 table.
538  *
539  * the l2 table offset in the qcow2 file and the cluster index
540  * in the l2 table are given to the caller.
541  *
542  * Returns 0 on success, -errno in failure case
543  */
544 static int get_cluster_table(BlockDriverState *bs, uint64_t offset,
545                              uint64_t **new_l2_table,
546                              int *new_l2_index)
547 {
548     BDRVQcowState *s = bs->opaque;
549     unsigned int l2_index;
550     uint64_t l1_index, l2_offset;
551     uint64_t *l2_table = NULL;
552     int ret;
553 
554     /* seek the the l2 offset in the l1 table */
555 
556     l1_index = offset >> (s->l2_bits + s->cluster_bits);
557     if (l1_index >= s->l1_size) {
558         ret = qcow2_grow_l1_table(bs, l1_index + 1, false);
559         if (ret < 0) {
560             return ret;
561         }
562     }
563 
564     assert(l1_index < s->l1_size);
565     l2_offset = s->l1_table[l1_index] & L1E_OFFSET_MASK;
566 
567     /* seek the l2 table of the given l2 offset */
568 
569     if (s->l1_table[l1_index] & QCOW_OFLAG_COPIED) {
570         /* load the l2 table in memory */
571         ret = l2_load(bs, l2_offset, &l2_table);
572         if (ret < 0) {
573             return ret;
574         }
575     } else {
576         /* First allocate a new L2 table (and do COW if needed) */
577         ret = l2_allocate(bs, l1_index, &l2_table);
578         if (ret < 0) {
579             return ret;
580         }
581 
582         /* Then decrease the refcount of the old table */
583         if (l2_offset) {
584             qcow2_free_clusters(bs, l2_offset, s->l2_size * sizeof(uint64_t),
585                                 QCOW2_DISCARD_OTHER);
586         }
587     }
588 
589     /* find the cluster offset for the given disk offset */
590 
591     l2_index = (offset >> s->cluster_bits) & (s->l2_size - 1);
592 
593     *new_l2_table = l2_table;
594     *new_l2_index = l2_index;
595 
596     return 0;
597 }
598 
599 /*
600  * alloc_compressed_cluster_offset
601  *
602  * For a given offset of the disk image, return cluster offset in
603  * qcow2 file.
604  *
605  * If the offset is not found, allocate a new compressed cluster.
606  *
607  * Return the cluster offset if successful,
608  * Return 0, otherwise.
609  *
610  */
611 
612 uint64_t qcow2_alloc_compressed_cluster_offset(BlockDriverState *bs,
613                                                uint64_t offset,
614                                                int compressed_size)
615 {
616     BDRVQcowState *s = bs->opaque;
617     int l2_index, ret;
618     uint64_t *l2_table;
619     int64_t cluster_offset;
620     int nb_csectors;
621 
622     ret = get_cluster_table(bs, offset, &l2_table, &l2_index);
623     if (ret < 0) {
624         return 0;
625     }
626 
627     /* Compression can't overwrite anything. Fail if the cluster was already
628      * allocated. */
629     cluster_offset = be64_to_cpu(l2_table[l2_index]);
630     if (cluster_offset & L2E_OFFSET_MASK) {
631         qcow2_cache_put(bs, s->l2_table_cache, (void**) &l2_table);
632         return 0;
633     }
634 
635     cluster_offset = qcow2_alloc_bytes(bs, compressed_size);
636     if (cluster_offset < 0) {
637         qcow2_cache_put(bs, s->l2_table_cache, (void**) &l2_table);
638         return 0;
639     }
640 
641     nb_csectors = ((cluster_offset + compressed_size - 1) >> 9) -
642                   (cluster_offset >> 9);
643 
644     cluster_offset |= QCOW_OFLAG_COMPRESSED |
645                       ((uint64_t)nb_csectors << s->csize_shift);
646 
647     /* update L2 table */
648 
649     /* compressed clusters never have the copied flag */
650 
651     BLKDBG_EVENT(bs->file, BLKDBG_L2_UPDATE_COMPRESSED);
652     qcow2_cache_entry_mark_dirty(s->l2_table_cache, l2_table);
653     l2_table[l2_index] = cpu_to_be64(cluster_offset);
654     ret = qcow2_cache_put(bs, s->l2_table_cache, (void**) &l2_table);
655     if (ret < 0) {
656         return 0;
657     }
658 
659     return cluster_offset;
660 }
661 
662 static int perform_cow(BlockDriverState *bs, QCowL2Meta *m, Qcow2COWRegion *r)
663 {
664     BDRVQcowState *s = bs->opaque;
665     int ret;
666 
667     if (r->nb_sectors == 0) {
668         return 0;
669     }
670 
671     qemu_co_mutex_unlock(&s->lock);
672     ret = copy_sectors(bs, m->offset / BDRV_SECTOR_SIZE, m->alloc_offset,
673                        r->offset / BDRV_SECTOR_SIZE,
674                        r->offset / BDRV_SECTOR_SIZE + r->nb_sectors);
675     qemu_co_mutex_lock(&s->lock);
676 
677     if (ret < 0) {
678         return ret;
679     }
680 
681     /*
682      * Before we update the L2 table to actually point to the new cluster, we
683      * need to be sure that the refcounts have been increased and COW was
684      * handled.
685      */
686     qcow2_cache_depends_on_flush(s->l2_table_cache);
687 
688     return 0;
689 }
690 
691 int qcow2_alloc_cluster_link_l2(BlockDriverState *bs, QCowL2Meta *m)
692 {
693     BDRVQcowState *s = bs->opaque;
694     int i, j = 0, l2_index, ret;
695     uint64_t *old_cluster, *l2_table;
696     uint64_t cluster_offset = m->alloc_offset;
697 
698     trace_qcow2_cluster_link_l2(qemu_coroutine_self(), m->nb_clusters);
699     assert(m->nb_clusters > 0);
700 
701     old_cluster = g_malloc(m->nb_clusters * sizeof(uint64_t));
702 
703     /* copy content of unmodified sectors */
704     ret = perform_cow(bs, m, &m->cow_start);
705     if (ret < 0) {
706         goto err;
707     }
708 
709     ret = perform_cow(bs, m, &m->cow_end);
710     if (ret < 0) {
711         goto err;
712     }
713 
714     /* Update L2 table. */
715     if (s->use_lazy_refcounts) {
716         qcow2_mark_dirty(bs);
717     }
718     if (qcow2_need_accurate_refcounts(s)) {
719         qcow2_cache_set_dependency(bs, s->l2_table_cache,
720                                    s->refcount_block_cache);
721     }
722 
723     ret = get_cluster_table(bs, m->offset, &l2_table, &l2_index);
724     if (ret < 0) {
725         goto err;
726     }
727     qcow2_cache_entry_mark_dirty(s->l2_table_cache, l2_table);
728 
729     assert(l2_index + m->nb_clusters <= s->l2_size);
730     for (i = 0; i < m->nb_clusters; i++) {
731         /* if two concurrent writes happen to the same unallocated cluster
732 	 * each write allocates separate cluster and writes data concurrently.
733 	 * The first one to complete updates l2 table with pointer to its
734 	 * cluster the second one has to do RMW (which is done above by
735 	 * copy_sectors()), update l2 table with its cluster pointer and free
736 	 * old cluster. This is what this loop does */
737         if(l2_table[l2_index + i] != 0)
738             old_cluster[j++] = l2_table[l2_index + i];
739 
740         l2_table[l2_index + i] = cpu_to_be64((cluster_offset +
741                     (i << s->cluster_bits)) | QCOW_OFLAG_COPIED);
742      }
743 
744 
745     ret = qcow2_cache_put(bs, s->l2_table_cache, (void**) &l2_table);
746     if (ret < 0) {
747         goto err;
748     }
749 
750     /*
751      * If this was a COW, we need to decrease the refcount of the old cluster.
752      * Also flush bs->file to get the right order for L2 and refcount update.
753      *
754      * Don't discard clusters that reach a refcount of 0 (e.g. compressed
755      * clusters), the next write will reuse them anyway.
756      */
757     if (j != 0) {
758         for (i = 0; i < j; i++) {
759             qcow2_free_any_clusters(bs, be64_to_cpu(old_cluster[i]), 1,
760                                     QCOW2_DISCARD_NEVER);
761         }
762     }
763 
764     ret = 0;
765 err:
766     g_free(old_cluster);
767     return ret;
768  }
769 
770 /*
771  * Returns the number of contiguous clusters that can be used for an allocating
772  * write, but require COW to be performed (this includes yet unallocated space,
773  * which must copy from the backing file)
774  */
775 static int count_cow_clusters(BDRVQcowState *s, int nb_clusters,
776     uint64_t *l2_table, int l2_index)
777 {
778     int i;
779 
780     for (i = 0; i < nb_clusters; i++) {
781         uint64_t l2_entry = be64_to_cpu(l2_table[l2_index + i]);
782         int cluster_type = qcow2_get_cluster_type(l2_entry);
783 
784         switch(cluster_type) {
785         case QCOW2_CLUSTER_NORMAL:
786             if (l2_entry & QCOW_OFLAG_COPIED) {
787                 goto out;
788             }
789             break;
790         case QCOW2_CLUSTER_UNALLOCATED:
791         case QCOW2_CLUSTER_COMPRESSED:
792         case QCOW2_CLUSTER_ZERO:
793             break;
794         default:
795             abort();
796         }
797     }
798 
799 out:
800     assert(i <= nb_clusters);
801     return i;
802 }
803 
804 /*
805  * Check if there already is an AIO write request in flight which allocates
806  * the same cluster. In this case we need to wait until the previous
807  * request has completed and updated the L2 table accordingly.
808  *
809  * Returns:
810  *   0       if there was no dependency. *cur_bytes indicates the number of
811  *           bytes from guest_offset that can be read before the next
812  *           dependency must be processed (or the request is complete)
813  *
814  *   -EAGAIN if we had to wait for another request, previously gathered
815  *           information on cluster allocation may be invalid now. The caller
816  *           must start over anyway, so consider *cur_bytes undefined.
817  */
818 static int handle_dependencies(BlockDriverState *bs, uint64_t guest_offset,
819     uint64_t *cur_bytes, QCowL2Meta **m)
820 {
821     BDRVQcowState *s = bs->opaque;
822     QCowL2Meta *old_alloc;
823     uint64_t bytes = *cur_bytes;
824 
825     QLIST_FOREACH(old_alloc, &s->cluster_allocs, next_in_flight) {
826 
827         uint64_t start = guest_offset;
828         uint64_t end = start + bytes;
829         uint64_t old_start = l2meta_cow_start(old_alloc);
830         uint64_t old_end = l2meta_cow_end(old_alloc);
831 
832         if (end <= old_start || start >= old_end) {
833             /* No intersection */
834         } else {
835             if (start < old_start) {
836                 /* Stop at the start of a running allocation */
837                 bytes = old_start - start;
838             } else {
839                 bytes = 0;
840             }
841 
842             /* Stop if already an l2meta exists. After yielding, it wouldn't
843              * be valid any more, so we'd have to clean up the old L2Metas
844              * and deal with requests depending on them before starting to
845              * gather new ones. Not worth the trouble. */
846             if (bytes == 0 && *m) {
847                 *cur_bytes = 0;
848                 return 0;
849             }
850 
851             if (bytes == 0) {
852                 /* Wait for the dependency to complete. We need to recheck
853                  * the free/allocated clusters when we continue. */
854                 qemu_co_mutex_unlock(&s->lock);
855                 qemu_co_queue_wait(&old_alloc->dependent_requests);
856                 qemu_co_mutex_lock(&s->lock);
857                 return -EAGAIN;
858             }
859         }
860     }
861 
862     /* Make sure that existing clusters and new allocations are only used up to
863      * the next dependency if we shortened the request above */
864     *cur_bytes = bytes;
865 
866     return 0;
867 }
868 
869 /*
870  * Checks how many already allocated clusters that don't require a copy on
871  * write there are at the given guest_offset (up to *bytes). If
872  * *host_offset is not zero, only physically contiguous clusters beginning at
873  * this host offset are counted.
874  *
875  * Note that guest_offset may not be cluster aligned. In this case, the
876  * returned *host_offset points to exact byte referenced by guest_offset and
877  * therefore isn't cluster aligned as well.
878  *
879  * Returns:
880  *   0:     if no allocated clusters are available at the given offset.
881  *          *bytes is normally unchanged. It is set to 0 if the cluster
882  *          is allocated and doesn't need COW, but doesn't have the right
883  *          physical offset.
884  *
885  *   1:     if allocated clusters that don't require a COW are available at
886  *          the requested offset. *bytes may have decreased and describes
887  *          the length of the area that can be written to.
888  *
889  *  -errno: in error cases
890  */
891 static int handle_copied(BlockDriverState *bs, uint64_t guest_offset,
892     uint64_t *host_offset, uint64_t *bytes, QCowL2Meta **m)
893 {
894     BDRVQcowState *s = bs->opaque;
895     int l2_index;
896     uint64_t cluster_offset;
897     uint64_t *l2_table;
898     unsigned int nb_clusters;
899     unsigned int keep_clusters;
900     int ret, pret;
901 
902     trace_qcow2_handle_copied(qemu_coroutine_self(), guest_offset, *host_offset,
903                               *bytes);
904 
905     assert(*host_offset == 0 ||    offset_into_cluster(s, guest_offset)
906                                 == offset_into_cluster(s, *host_offset));
907 
908     /*
909      * Calculate the number of clusters to look for. We stop at L2 table
910      * boundaries to keep things simple.
911      */
912     nb_clusters =
913         size_to_clusters(s, offset_into_cluster(s, guest_offset) + *bytes);
914 
915     l2_index = offset_to_l2_index(s, guest_offset);
916     nb_clusters = MIN(nb_clusters, s->l2_size - l2_index);
917 
918     /* Find L2 entry for the first involved cluster */
919     ret = get_cluster_table(bs, guest_offset, &l2_table, &l2_index);
920     if (ret < 0) {
921         return ret;
922     }
923 
924     cluster_offset = be64_to_cpu(l2_table[l2_index]);
925 
926     /* Check how many clusters are already allocated and don't need COW */
927     if (qcow2_get_cluster_type(cluster_offset) == QCOW2_CLUSTER_NORMAL
928         && (cluster_offset & QCOW_OFLAG_COPIED))
929     {
930         /* If a specific host_offset is required, check it */
931         bool offset_matches =
932             (cluster_offset & L2E_OFFSET_MASK) == *host_offset;
933 
934         if (*host_offset != 0 && !offset_matches) {
935             *bytes = 0;
936             ret = 0;
937             goto out;
938         }
939 
940         /* We keep all QCOW_OFLAG_COPIED clusters */
941         keep_clusters =
942             count_contiguous_clusters(nb_clusters, s->cluster_size,
943                                       &l2_table[l2_index],
944                                       QCOW_OFLAG_COPIED | QCOW_OFLAG_ZERO);
945         assert(keep_clusters <= nb_clusters);
946 
947         *bytes = MIN(*bytes,
948                  keep_clusters * s->cluster_size
949                  - offset_into_cluster(s, guest_offset));
950 
951         ret = 1;
952     } else {
953         ret = 0;
954     }
955 
956     /* Cleanup */
957 out:
958     pret = qcow2_cache_put(bs, s->l2_table_cache, (void**) &l2_table);
959     if (pret < 0) {
960         return pret;
961     }
962 
963     /* Only return a host offset if we actually made progress. Otherwise we
964      * would make requirements for handle_alloc() that it can't fulfill */
965     if (ret) {
966         *host_offset = (cluster_offset & L2E_OFFSET_MASK)
967                      + offset_into_cluster(s, guest_offset);
968     }
969 
970     return ret;
971 }
972 
973 /*
974  * Allocates new clusters for the given guest_offset.
975  *
976  * At most *nb_clusters are allocated, and on return *nb_clusters is updated to
977  * contain the number of clusters that have been allocated and are contiguous
978  * in the image file.
979  *
980  * If *host_offset is non-zero, it specifies the offset in the image file at
981  * which the new clusters must start. *nb_clusters can be 0 on return in this
982  * case if the cluster at host_offset is already in use. If *host_offset is
983  * zero, the clusters can be allocated anywhere in the image file.
984  *
985  * *host_offset is updated to contain the offset into the image file at which
986  * the first allocated cluster starts.
987  *
988  * Return 0 on success and -errno in error cases. -EAGAIN means that the
989  * function has been waiting for another request and the allocation must be
990  * restarted, but the whole request should not be failed.
991  */
992 static int do_alloc_cluster_offset(BlockDriverState *bs, uint64_t guest_offset,
993     uint64_t *host_offset, unsigned int *nb_clusters)
994 {
995     BDRVQcowState *s = bs->opaque;
996 
997     trace_qcow2_do_alloc_clusters_offset(qemu_coroutine_self(), guest_offset,
998                                          *host_offset, *nb_clusters);
999 
1000     /* Allocate new clusters */
1001     trace_qcow2_cluster_alloc_phys(qemu_coroutine_self());
1002     if (*host_offset == 0) {
1003         int64_t cluster_offset =
1004             qcow2_alloc_clusters(bs, *nb_clusters * s->cluster_size);
1005         if (cluster_offset < 0) {
1006             return cluster_offset;
1007         }
1008         *host_offset = cluster_offset;
1009         return 0;
1010     } else {
1011         int ret = qcow2_alloc_clusters_at(bs, *host_offset, *nb_clusters);
1012         if (ret < 0) {
1013             return ret;
1014         }
1015         *nb_clusters = ret;
1016         return 0;
1017     }
1018 }
1019 
1020 /*
1021  * Allocates new clusters for an area that either is yet unallocated or needs a
1022  * copy on write. If *host_offset is non-zero, clusters are only allocated if
1023  * the new allocation can match the specified host offset.
1024  *
1025  * Note that guest_offset may not be cluster aligned. In this case, the
1026  * returned *host_offset points to exact byte referenced by guest_offset and
1027  * therefore isn't cluster aligned as well.
1028  *
1029  * Returns:
1030  *   0:     if no clusters could be allocated. *bytes is set to 0,
1031  *          *host_offset is left unchanged.
1032  *
1033  *   1:     if new clusters were allocated. *bytes may be decreased if the
1034  *          new allocation doesn't cover all of the requested area.
1035  *          *host_offset is updated to contain the host offset of the first
1036  *          newly allocated cluster.
1037  *
1038  *  -errno: in error cases
1039  */
1040 static int handle_alloc(BlockDriverState *bs, uint64_t guest_offset,
1041     uint64_t *host_offset, uint64_t *bytes, QCowL2Meta **m)
1042 {
1043     BDRVQcowState *s = bs->opaque;
1044     int l2_index;
1045     uint64_t *l2_table;
1046     uint64_t entry;
1047     unsigned int nb_clusters;
1048     int ret;
1049 
1050     uint64_t alloc_cluster_offset;
1051 
1052     trace_qcow2_handle_alloc(qemu_coroutine_self(), guest_offset, *host_offset,
1053                              *bytes);
1054     assert(*bytes > 0);
1055 
1056     /*
1057      * Calculate the number of clusters to look for. We stop at L2 table
1058      * boundaries to keep things simple.
1059      */
1060     nb_clusters =
1061         size_to_clusters(s, offset_into_cluster(s, guest_offset) + *bytes);
1062 
1063     l2_index = offset_to_l2_index(s, guest_offset);
1064     nb_clusters = MIN(nb_clusters, s->l2_size - l2_index);
1065 
1066     /* Find L2 entry for the first involved cluster */
1067     ret = get_cluster_table(bs, guest_offset, &l2_table, &l2_index);
1068     if (ret < 0) {
1069         return ret;
1070     }
1071 
1072     entry = be64_to_cpu(l2_table[l2_index]);
1073 
1074     /* For the moment, overwrite compressed clusters one by one */
1075     if (entry & QCOW_OFLAG_COMPRESSED) {
1076         nb_clusters = 1;
1077     } else {
1078         nb_clusters = count_cow_clusters(s, nb_clusters, l2_table, l2_index);
1079     }
1080 
1081     /* This function is only called when there were no non-COW clusters, so if
1082      * we can't find any unallocated or COW clusters either, something is
1083      * wrong with our code. */
1084     assert(nb_clusters > 0);
1085 
1086     ret = qcow2_cache_put(bs, s->l2_table_cache, (void**) &l2_table);
1087     if (ret < 0) {
1088         return ret;
1089     }
1090 
1091     /* Allocate, if necessary at a given offset in the image file */
1092     alloc_cluster_offset = start_of_cluster(s, *host_offset);
1093     ret = do_alloc_cluster_offset(bs, guest_offset, &alloc_cluster_offset,
1094                                   &nb_clusters);
1095     if (ret < 0) {
1096         goto fail;
1097     }
1098 
1099     /* Can't extend contiguous allocation */
1100     if (nb_clusters == 0) {
1101         *bytes = 0;
1102         return 0;
1103     }
1104 
1105     /*
1106      * Save info needed for meta data update.
1107      *
1108      * requested_sectors: Number of sectors from the start of the first
1109      * newly allocated cluster to the end of the (possibly shortened
1110      * before) write request.
1111      *
1112      * avail_sectors: Number of sectors from the start of the first
1113      * newly allocated to the end of the last newly allocated cluster.
1114      *
1115      * nb_sectors: The number of sectors from the start of the first
1116      * newly allocated cluster to the end of the area that the write
1117      * request actually writes to (excluding COW at the end)
1118      */
1119     int requested_sectors =
1120         (*bytes + offset_into_cluster(s, guest_offset))
1121         >> BDRV_SECTOR_BITS;
1122     int avail_sectors = nb_clusters
1123                         << (s->cluster_bits - BDRV_SECTOR_BITS);
1124     int alloc_n_start = offset_into_cluster(s, guest_offset)
1125                         >> BDRV_SECTOR_BITS;
1126     int nb_sectors = MIN(requested_sectors, avail_sectors);
1127     QCowL2Meta *old_m = *m;
1128 
1129     *m = g_malloc0(sizeof(**m));
1130 
1131     **m = (QCowL2Meta) {
1132         .next           = old_m,
1133 
1134         .alloc_offset   = alloc_cluster_offset,
1135         .offset         = start_of_cluster(s, guest_offset),
1136         .nb_clusters    = nb_clusters,
1137         .nb_available   = nb_sectors,
1138 
1139         .cow_start = {
1140             .offset     = 0,
1141             .nb_sectors = alloc_n_start,
1142         },
1143         .cow_end = {
1144             .offset     = nb_sectors * BDRV_SECTOR_SIZE,
1145             .nb_sectors = avail_sectors - nb_sectors,
1146         },
1147     };
1148     qemu_co_queue_init(&(*m)->dependent_requests);
1149     QLIST_INSERT_HEAD(&s->cluster_allocs, *m, next_in_flight);
1150 
1151     *host_offset = alloc_cluster_offset + offset_into_cluster(s, guest_offset);
1152     *bytes = MIN(*bytes, (nb_sectors * BDRV_SECTOR_SIZE)
1153                          - offset_into_cluster(s, guest_offset));
1154     assert(*bytes != 0);
1155 
1156     return 1;
1157 
1158 fail:
1159     if (*m && (*m)->nb_clusters > 0) {
1160         QLIST_REMOVE(*m, next_in_flight);
1161     }
1162     return ret;
1163 }
1164 
1165 /*
1166  * alloc_cluster_offset
1167  *
1168  * For a given offset on the virtual disk, find the cluster offset in qcow2
1169  * file. If the offset is not found, allocate a new cluster.
1170  *
1171  * If the cluster was already allocated, m->nb_clusters is set to 0 and
1172  * other fields in m are meaningless.
1173  *
1174  * If the cluster is newly allocated, m->nb_clusters is set to the number of
1175  * contiguous clusters that have been allocated. In this case, the other
1176  * fields of m are valid and contain information about the first allocated
1177  * cluster.
1178  *
1179  * If the request conflicts with another write request in flight, the coroutine
1180  * is queued and will be reentered when the dependency has completed.
1181  *
1182  * Return 0 on success and -errno in error cases
1183  */
1184 int qcow2_alloc_cluster_offset(BlockDriverState *bs, uint64_t offset,
1185     int n_start, int n_end, int *num, uint64_t *host_offset, QCowL2Meta **m)
1186 {
1187     BDRVQcowState *s = bs->opaque;
1188     uint64_t start, remaining;
1189     uint64_t cluster_offset;
1190     uint64_t cur_bytes;
1191     int ret;
1192 
1193     trace_qcow2_alloc_clusters_offset(qemu_coroutine_self(), offset,
1194                                       n_start, n_end);
1195 
1196     assert(n_start * BDRV_SECTOR_SIZE == offset_into_cluster(s, offset));
1197     offset = start_of_cluster(s, offset);
1198 
1199 again:
1200     start = offset + (n_start << BDRV_SECTOR_BITS);
1201     remaining = (n_end - n_start) << BDRV_SECTOR_BITS;
1202     cluster_offset = 0;
1203     *host_offset = 0;
1204     cur_bytes = 0;
1205     *m = NULL;
1206 
1207     while (true) {
1208 
1209         if (!*host_offset) {
1210             *host_offset = start_of_cluster(s, cluster_offset);
1211         }
1212 
1213         assert(remaining >= cur_bytes);
1214 
1215         start           += cur_bytes;
1216         remaining       -= cur_bytes;
1217         cluster_offset  += cur_bytes;
1218 
1219         if (remaining == 0) {
1220             break;
1221         }
1222 
1223         cur_bytes = remaining;
1224 
1225         /*
1226          * Now start gathering as many contiguous clusters as possible:
1227          *
1228          * 1. Check for overlaps with in-flight allocations
1229          *
1230          *      a) Overlap not in the first cluster -> shorten this request and
1231          *         let the caller handle the rest in its next loop iteration.
1232          *
1233          *      b) Real overlaps of two requests. Yield and restart the search
1234          *         for contiguous clusters (the situation could have changed
1235          *         while we were sleeping)
1236          *
1237          *      c) TODO: Request starts in the same cluster as the in-flight
1238          *         allocation ends. Shorten the COW of the in-fight allocation,
1239          *         set cluster_offset to write to the same cluster and set up
1240          *         the right synchronisation between the in-flight request and
1241          *         the new one.
1242          */
1243         ret = handle_dependencies(bs, start, &cur_bytes, m);
1244         if (ret == -EAGAIN) {
1245             /* Currently handle_dependencies() doesn't yield if we already had
1246              * an allocation. If it did, we would have to clean up the L2Meta
1247              * structs before starting over. */
1248             assert(*m == NULL);
1249             goto again;
1250         } else if (ret < 0) {
1251             return ret;
1252         } else if (cur_bytes == 0) {
1253             break;
1254         } else {
1255             /* handle_dependencies() may have decreased cur_bytes (shortened
1256              * the allocations below) so that the next dependency is processed
1257              * correctly during the next loop iteration. */
1258         }
1259 
1260         /*
1261          * 2. Count contiguous COPIED clusters.
1262          */
1263         ret = handle_copied(bs, start, &cluster_offset, &cur_bytes, m);
1264         if (ret < 0) {
1265             return ret;
1266         } else if (ret) {
1267             continue;
1268         } else if (cur_bytes == 0) {
1269             break;
1270         }
1271 
1272         /*
1273          * 3. If the request still hasn't completed, allocate new clusters,
1274          *    considering any cluster_offset of steps 1c or 2.
1275          */
1276         ret = handle_alloc(bs, start, &cluster_offset, &cur_bytes, m);
1277         if (ret < 0) {
1278             return ret;
1279         } else if (ret) {
1280             continue;
1281         } else {
1282             assert(cur_bytes == 0);
1283             break;
1284         }
1285     }
1286 
1287     *num = (n_end - n_start) - (remaining >> BDRV_SECTOR_BITS);
1288     assert(*num > 0);
1289     assert(*host_offset != 0);
1290 
1291     return 0;
1292 }
1293 
1294 static int decompress_buffer(uint8_t *out_buf, int out_buf_size,
1295                              const uint8_t *buf, int buf_size)
1296 {
1297     z_stream strm1, *strm = &strm1;
1298     int ret, out_len;
1299 
1300     memset(strm, 0, sizeof(*strm));
1301 
1302     strm->next_in = (uint8_t *)buf;
1303     strm->avail_in = buf_size;
1304     strm->next_out = out_buf;
1305     strm->avail_out = out_buf_size;
1306 
1307     ret = inflateInit2(strm, -12);
1308     if (ret != Z_OK)
1309         return -1;
1310     ret = inflate(strm, Z_FINISH);
1311     out_len = strm->next_out - out_buf;
1312     if ((ret != Z_STREAM_END && ret != Z_BUF_ERROR) ||
1313         out_len != out_buf_size) {
1314         inflateEnd(strm);
1315         return -1;
1316     }
1317     inflateEnd(strm);
1318     return 0;
1319 }
1320 
1321 int qcow2_decompress_cluster(BlockDriverState *bs, uint64_t cluster_offset)
1322 {
1323     BDRVQcowState *s = bs->opaque;
1324     int ret, csize, nb_csectors, sector_offset;
1325     uint64_t coffset;
1326 
1327     coffset = cluster_offset & s->cluster_offset_mask;
1328     if (s->cluster_cache_offset != coffset) {
1329         nb_csectors = ((cluster_offset >> s->csize_shift) & s->csize_mask) + 1;
1330         sector_offset = coffset & 511;
1331         csize = nb_csectors * 512 - sector_offset;
1332         BLKDBG_EVENT(bs->file, BLKDBG_READ_COMPRESSED);
1333         ret = bdrv_read(bs->file, coffset >> 9, s->cluster_data, nb_csectors);
1334         if (ret < 0) {
1335             return ret;
1336         }
1337         if (decompress_buffer(s->cluster_cache, s->cluster_size,
1338                               s->cluster_data + sector_offset, csize) < 0) {
1339             return -EIO;
1340         }
1341         s->cluster_cache_offset = coffset;
1342     }
1343     return 0;
1344 }
1345 
1346 /*
1347  * This discards as many clusters of nb_clusters as possible at once (i.e.
1348  * all clusters in the same L2 table) and returns the number of discarded
1349  * clusters.
1350  */
1351 static int discard_single_l2(BlockDriverState *bs, uint64_t offset,
1352     unsigned int nb_clusters, enum qcow2_discard_type type)
1353 {
1354     BDRVQcowState *s = bs->opaque;
1355     uint64_t *l2_table;
1356     int l2_index;
1357     int ret;
1358     int i;
1359 
1360     ret = get_cluster_table(bs, offset, &l2_table, &l2_index);
1361     if (ret < 0) {
1362         return ret;
1363     }
1364 
1365     /* Limit nb_clusters to one L2 table */
1366     nb_clusters = MIN(nb_clusters, s->l2_size - l2_index);
1367 
1368     for (i = 0; i < nb_clusters; i++) {
1369         uint64_t old_offset;
1370 
1371         old_offset = be64_to_cpu(l2_table[l2_index + i]);
1372         if ((old_offset & L2E_OFFSET_MASK) == 0) {
1373             continue;
1374         }
1375 
1376         /* First remove L2 entries */
1377         qcow2_cache_entry_mark_dirty(s->l2_table_cache, l2_table);
1378         l2_table[l2_index + i] = cpu_to_be64(0);
1379 
1380         /* Then decrease the refcount */
1381         qcow2_free_any_clusters(bs, old_offset, 1, type);
1382     }
1383 
1384     ret = qcow2_cache_put(bs, s->l2_table_cache, (void**) &l2_table);
1385     if (ret < 0) {
1386         return ret;
1387     }
1388 
1389     return nb_clusters;
1390 }
1391 
1392 int qcow2_discard_clusters(BlockDriverState *bs, uint64_t offset,
1393     int nb_sectors, enum qcow2_discard_type type)
1394 {
1395     BDRVQcowState *s = bs->opaque;
1396     uint64_t end_offset;
1397     unsigned int nb_clusters;
1398     int ret;
1399 
1400     end_offset = offset + (nb_sectors << BDRV_SECTOR_BITS);
1401 
1402     /* Round start up and end down */
1403     offset = align_offset(offset, s->cluster_size);
1404     end_offset &= ~(s->cluster_size - 1);
1405 
1406     if (offset > end_offset) {
1407         return 0;
1408     }
1409 
1410     nb_clusters = size_to_clusters(s, end_offset - offset);
1411 
1412     s->cache_discards = true;
1413 
1414     /* Each L2 table is handled by its own loop iteration */
1415     while (nb_clusters > 0) {
1416         ret = discard_single_l2(bs, offset, nb_clusters, type);
1417         if (ret < 0) {
1418             goto fail;
1419         }
1420 
1421         nb_clusters -= ret;
1422         offset += (ret * s->cluster_size);
1423     }
1424 
1425     ret = 0;
1426 fail:
1427     s->cache_discards = false;
1428     qcow2_process_discards(bs, ret);
1429 
1430     return ret;
1431 }
1432 
1433 /*
1434  * This zeroes as many clusters of nb_clusters as possible at once (i.e.
1435  * all clusters in the same L2 table) and returns the number of zeroed
1436  * clusters.
1437  */
1438 static int zero_single_l2(BlockDriverState *bs, uint64_t offset,
1439     unsigned int nb_clusters)
1440 {
1441     BDRVQcowState *s = bs->opaque;
1442     uint64_t *l2_table;
1443     int l2_index;
1444     int ret;
1445     int i;
1446 
1447     ret = get_cluster_table(bs, offset, &l2_table, &l2_index);
1448     if (ret < 0) {
1449         return ret;
1450     }
1451 
1452     /* Limit nb_clusters to one L2 table */
1453     nb_clusters = MIN(nb_clusters, s->l2_size - l2_index);
1454 
1455     for (i = 0; i < nb_clusters; i++) {
1456         uint64_t old_offset;
1457 
1458         old_offset = be64_to_cpu(l2_table[l2_index + i]);
1459 
1460         /* Update L2 entries */
1461         qcow2_cache_entry_mark_dirty(s->l2_table_cache, l2_table);
1462         if (old_offset & QCOW_OFLAG_COMPRESSED) {
1463             l2_table[l2_index + i] = cpu_to_be64(QCOW_OFLAG_ZERO);
1464             qcow2_free_any_clusters(bs, old_offset, 1, QCOW2_DISCARD_REQUEST);
1465         } else {
1466             l2_table[l2_index + i] |= cpu_to_be64(QCOW_OFLAG_ZERO);
1467         }
1468     }
1469 
1470     ret = qcow2_cache_put(bs, s->l2_table_cache, (void**) &l2_table);
1471     if (ret < 0) {
1472         return ret;
1473     }
1474 
1475     return nb_clusters;
1476 }
1477 
1478 int qcow2_zero_clusters(BlockDriverState *bs, uint64_t offset, int nb_sectors)
1479 {
1480     BDRVQcowState *s = bs->opaque;
1481     unsigned int nb_clusters;
1482     int ret;
1483 
1484     /* The zero flag is only supported by version 3 and newer */
1485     if (s->qcow_version < 3) {
1486         return -ENOTSUP;
1487     }
1488 
1489     /* Each L2 table is handled by its own loop iteration */
1490     nb_clusters = size_to_clusters(s, nb_sectors << BDRV_SECTOR_BITS);
1491 
1492     s->cache_discards = true;
1493 
1494     while (nb_clusters > 0) {
1495         ret = zero_single_l2(bs, offset, nb_clusters);
1496         if (ret < 0) {
1497             goto fail;
1498         }
1499 
1500         nb_clusters -= ret;
1501         offset += (ret * s->cluster_size);
1502     }
1503 
1504     ret = 0;
1505 fail:
1506     s->cache_discards = false;
1507     qcow2_process_discards(bs, ret);
1508 
1509     return ret;
1510 }
1511 
1512 /*
1513  * Expands all zero clusters in a specific L1 table (or deallocates them, for
1514  * non-backed non-pre-allocated zero clusters).
1515  *
1516  * expanded_clusters is a bitmap where every bit corresponds to one cluster in
1517  * the image file; a bit gets set if the corresponding cluster has been used for
1518  * zero expansion (i.e., has been filled with zeroes and is referenced from an
1519  * L2 table). nb_clusters contains the total cluster count of the image file,
1520  * i.e., the number of bits in expanded_clusters.
1521  */
1522 static int expand_zero_clusters_in_l1(BlockDriverState *bs, uint64_t *l1_table,
1523                                       int l1_size, uint8_t **expanded_clusters,
1524                                       uint64_t *nb_clusters)
1525 {
1526     BDRVQcowState *s = bs->opaque;
1527     bool is_active_l1 = (l1_table == s->l1_table);
1528     uint64_t *l2_table = NULL;
1529     int ret;
1530     int i, j;
1531 
1532     if (!is_active_l1) {
1533         /* inactive L2 tables require a buffer to be stored in when loading
1534          * them from disk */
1535         l2_table = qemu_blockalign(bs, s->cluster_size);
1536     }
1537 
1538     for (i = 0; i < l1_size; i++) {
1539         uint64_t l2_offset = l1_table[i] & L1E_OFFSET_MASK;
1540         bool l2_dirty = false;
1541 
1542         if (!l2_offset) {
1543             /* unallocated */
1544             continue;
1545         }
1546 
1547         if (is_active_l1) {
1548             /* get active L2 tables from cache */
1549             ret = qcow2_cache_get(bs, s->l2_table_cache, l2_offset,
1550                     (void **)&l2_table);
1551         } else {
1552             /* load inactive L2 tables from disk */
1553             ret = bdrv_read(bs->file, l2_offset / BDRV_SECTOR_SIZE,
1554                     (void *)l2_table, s->cluster_sectors);
1555         }
1556         if (ret < 0) {
1557             goto fail;
1558         }
1559 
1560         for (j = 0; j < s->l2_size; j++) {
1561             uint64_t l2_entry = be64_to_cpu(l2_table[j]);
1562             int64_t offset = l2_entry & L2E_OFFSET_MASK, cluster_index;
1563             int cluster_type = qcow2_get_cluster_type(l2_entry);
1564             bool preallocated = offset != 0;
1565 
1566             if (cluster_type == QCOW2_CLUSTER_NORMAL) {
1567                 cluster_index = offset >> s->cluster_bits;
1568                 assert((cluster_index >= 0) && (cluster_index < *nb_clusters));
1569                 if ((*expanded_clusters)[cluster_index / 8] &
1570                     (1 << (cluster_index % 8))) {
1571                     /* Probably a shared L2 table; this cluster was a zero
1572                      * cluster which has been expanded, its refcount
1573                      * therefore most likely requires an update. */
1574                     ret = qcow2_update_cluster_refcount(bs, cluster_index, 1,
1575                                                         QCOW2_DISCARD_NEVER);
1576                     if (ret < 0) {
1577                         goto fail;
1578                     }
1579                     /* Since we just increased the refcount, the COPIED flag may
1580                      * no longer be set. */
1581                     l2_table[j] = cpu_to_be64(l2_entry & ~QCOW_OFLAG_COPIED);
1582                     l2_dirty = true;
1583                 }
1584                 continue;
1585             }
1586             else if (qcow2_get_cluster_type(l2_entry) != QCOW2_CLUSTER_ZERO) {
1587                 continue;
1588             }
1589 
1590             if (!preallocated) {
1591                 if (!bs->backing_hd) {
1592                     /* not backed; therefore we can simply deallocate the
1593                      * cluster */
1594                     l2_table[j] = 0;
1595                     l2_dirty = true;
1596                     continue;
1597                 }
1598 
1599                 offset = qcow2_alloc_clusters(bs, s->cluster_size);
1600                 if (offset < 0) {
1601                     ret = offset;
1602                     goto fail;
1603                 }
1604             }
1605 
1606             ret = qcow2_pre_write_overlap_check(bs, 0, offset, s->cluster_size);
1607             if (ret < 0) {
1608                 if (!preallocated) {
1609                     qcow2_free_clusters(bs, offset, s->cluster_size,
1610                                         QCOW2_DISCARD_ALWAYS);
1611                 }
1612                 goto fail;
1613             }
1614 
1615             ret = bdrv_write_zeroes(bs->file, offset / BDRV_SECTOR_SIZE,
1616                                     s->cluster_sectors);
1617             if (ret < 0) {
1618                 if (!preallocated) {
1619                     qcow2_free_clusters(bs, offset, s->cluster_size,
1620                                         QCOW2_DISCARD_ALWAYS);
1621                 }
1622                 goto fail;
1623             }
1624 
1625             l2_table[j] = cpu_to_be64(offset | QCOW_OFLAG_COPIED);
1626             l2_dirty = true;
1627 
1628             cluster_index = offset >> s->cluster_bits;
1629 
1630             if (cluster_index >= *nb_clusters) {
1631                 uint64_t old_bitmap_size = (*nb_clusters + 7) / 8;
1632                 uint64_t new_bitmap_size;
1633                 /* The offset may lie beyond the old end of the underlying image
1634                  * file for growable files only */
1635                 assert(bs->file->growable);
1636                 *nb_clusters = size_to_clusters(s, bs->file->total_sectors *
1637                                                 BDRV_SECTOR_SIZE);
1638                 new_bitmap_size = (*nb_clusters + 7) / 8;
1639                 *expanded_clusters = g_realloc(*expanded_clusters,
1640                                                new_bitmap_size);
1641                 /* clear the newly allocated space */
1642                 memset(&(*expanded_clusters)[old_bitmap_size], 0,
1643                        new_bitmap_size - old_bitmap_size);
1644             }
1645 
1646             assert((cluster_index >= 0) && (cluster_index < *nb_clusters));
1647             (*expanded_clusters)[cluster_index / 8] |= 1 << (cluster_index % 8);
1648         }
1649 
1650         if (is_active_l1) {
1651             if (l2_dirty) {
1652                 qcow2_cache_entry_mark_dirty(s->l2_table_cache, l2_table);
1653                 qcow2_cache_depends_on_flush(s->l2_table_cache);
1654             }
1655             ret = qcow2_cache_put(bs, s->l2_table_cache, (void **)&l2_table);
1656             if (ret < 0) {
1657                 l2_table = NULL;
1658                 goto fail;
1659             }
1660         } else {
1661             if (l2_dirty) {
1662                 ret = qcow2_pre_write_overlap_check(bs,
1663                         QCOW2_OL_INACTIVE_L2 | QCOW2_OL_ACTIVE_L2, l2_offset,
1664                         s->cluster_size);
1665                 if (ret < 0) {
1666                     goto fail;
1667                 }
1668 
1669                 ret = bdrv_write(bs->file, l2_offset / BDRV_SECTOR_SIZE,
1670                         (void *)l2_table, s->cluster_sectors);
1671                 if (ret < 0) {
1672                     goto fail;
1673                 }
1674             }
1675         }
1676     }
1677 
1678     ret = 0;
1679 
1680 fail:
1681     if (l2_table) {
1682         if (!is_active_l1) {
1683             qemu_vfree(l2_table);
1684         } else {
1685             if (ret < 0) {
1686                 qcow2_cache_put(bs, s->l2_table_cache, (void **)&l2_table);
1687             } else {
1688                 ret = qcow2_cache_put(bs, s->l2_table_cache,
1689                         (void **)&l2_table);
1690             }
1691         }
1692     }
1693     return ret;
1694 }
1695 
1696 /*
1697  * For backed images, expands all zero clusters on the image. For non-backed
1698  * images, deallocates all non-pre-allocated zero clusters (and claims the
1699  * allocation for pre-allocated ones). This is important for downgrading to a
1700  * qcow2 version which doesn't yet support metadata zero clusters.
1701  */
1702 int qcow2_expand_zero_clusters(BlockDriverState *bs)
1703 {
1704     BDRVQcowState *s = bs->opaque;
1705     uint64_t *l1_table = NULL;
1706     uint64_t nb_clusters;
1707     uint8_t *expanded_clusters;
1708     int ret;
1709     int i, j;
1710 
1711     nb_clusters = size_to_clusters(s, bs->file->total_sectors *
1712                                    BDRV_SECTOR_SIZE);
1713     expanded_clusters = g_malloc0((nb_clusters + 7) / 8);
1714 
1715     ret = expand_zero_clusters_in_l1(bs, s->l1_table, s->l1_size,
1716                                      &expanded_clusters, &nb_clusters);
1717     if (ret < 0) {
1718         goto fail;
1719     }
1720 
1721     /* Inactive L1 tables may point to active L2 tables - therefore it is
1722      * necessary to flush the L2 table cache before trying to access the L2
1723      * tables pointed to by inactive L1 entries (else we might try to expand
1724      * zero clusters that have already been expanded); furthermore, it is also
1725      * necessary to empty the L2 table cache, since it may contain tables which
1726      * are now going to be modified directly on disk, bypassing the cache.
1727      * qcow2_cache_empty() does both for us. */
1728     ret = qcow2_cache_empty(bs, s->l2_table_cache);
1729     if (ret < 0) {
1730         goto fail;
1731     }
1732 
1733     for (i = 0; i < s->nb_snapshots; i++) {
1734         int l1_sectors = (s->snapshots[i].l1_size * sizeof(uint64_t) +
1735                 BDRV_SECTOR_SIZE - 1) / BDRV_SECTOR_SIZE;
1736 
1737         l1_table = g_realloc(l1_table, l1_sectors * BDRV_SECTOR_SIZE);
1738 
1739         ret = bdrv_read(bs->file, s->snapshots[i].l1_table_offset /
1740                 BDRV_SECTOR_SIZE, (void *)l1_table, l1_sectors);
1741         if (ret < 0) {
1742             goto fail;
1743         }
1744 
1745         for (j = 0; j < s->snapshots[i].l1_size; j++) {
1746             be64_to_cpus(&l1_table[j]);
1747         }
1748 
1749         ret = expand_zero_clusters_in_l1(bs, l1_table, s->snapshots[i].l1_size,
1750                                          &expanded_clusters, &nb_clusters);
1751         if (ret < 0) {
1752             goto fail;
1753         }
1754     }
1755 
1756     ret = 0;
1757 
1758 fail:
1759     g_free(expanded_clusters);
1760     g_free(l1_table);
1761     return ret;
1762 }
1763