2 * Block driver for the QCOW version 2 format
4 * Copyright (c) 2004-2006 Fabrice Bellard
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:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
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
27 #include "qemu-common.h"
28 #include "block_int.h"
29 #include "block/qcow2.h"
32 int qcow2_grow_l1_table(BlockDriverState
*bs
, int min_size
, bool exact_size
)
34 BDRVQcowState
*s
= bs
->opaque
;
35 int new_l1_size
, new_l1_size2
, ret
, i
;
36 uint64_t *new_l1_table
;
37 int64_t new_l1_table_offset
;
40 if (min_size
<= s
->l1_size
)
44 new_l1_size
= min_size
;
46 /* Bump size up to reduce the number of times we have to grow */
47 new_l1_size
= s
->l1_size
;
48 if (new_l1_size
== 0) {
51 while (min_size
> new_l1_size
) {
52 new_l1_size
= (new_l1_size
* 3 + 1) / 2;
57 fprintf(stderr
, "grow l1_table from %d to %d\n", s
->l1_size
, new_l1_size
);
60 new_l1_size2
= sizeof(uint64_t) * new_l1_size
;
61 new_l1_table
= g_malloc0(align_offset(new_l1_size2
, 512));
62 memcpy(new_l1_table
, s
->l1_table
, s
->l1_size
* sizeof(uint64_t));
64 /* write new table (align to cluster) */
65 BLKDBG_EVENT(bs
->file
, BLKDBG_L1_GROW_ALLOC_TABLE
);
66 new_l1_table_offset
= qcow2_alloc_clusters(bs
, new_l1_size2
);
67 if (new_l1_table_offset
< 0) {
69 return new_l1_table_offset
;
72 ret
= qcow2_cache_flush(bs
, s
->refcount_block_cache
);
77 BLKDBG_EVENT(bs
->file
, BLKDBG_L1_GROW_WRITE_TABLE
);
78 for(i
= 0; i
< s
->l1_size
; i
++)
79 new_l1_table
[i
] = cpu_to_be64(new_l1_table
[i
]);
80 ret
= bdrv_pwrite_sync(bs
->file
, new_l1_table_offset
, new_l1_table
, new_l1_size2
);
83 for(i
= 0; i
< s
->l1_size
; i
++)
84 new_l1_table
[i
] = be64_to_cpu(new_l1_table
[i
]);
87 BLKDBG_EVENT(bs
->file
, BLKDBG_L1_GROW_ACTIVATE_TABLE
);
88 cpu_to_be32w((uint32_t*)data
, new_l1_size
);
89 cpu_to_be64wu((uint64_t*)(data
+ 4), new_l1_table_offset
);
90 ret
= bdrv_pwrite_sync(bs
->file
, offsetof(QCowHeader
, l1_size
), data
,sizeof(data
));
95 qcow2_free_clusters(bs
, s
->l1_table_offset
, s
->l1_size
* sizeof(uint64_t));
96 s
->l1_table_offset
= new_l1_table_offset
;
97 s
->l1_table
= new_l1_table
;
98 s
->l1_size
= new_l1_size
;
101 g_free(new_l1_table
);
102 qcow2_free_clusters(bs
, new_l1_table_offset
, new_l1_size2
);
109 * Loads a L2 table into memory. If the table is in the cache, the cache
110 * is used; otherwise the L2 table is loaded from the image file.
112 * Returns a pointer to the L2 table on success, or NULL if the read from
113 * the image file failed.
116 static int l2_load(BlockDriverState
*bs
, uint64_t l2_offset
,
119 BDRVQcowState
*s
= bs
->opaque
;
122 ret
= qcow2_cache_get(bs
, s
->l2_table_cache
, l2_offset
, (void**) l2_table
);
128 * Writes one sector of the L1 table to the disk (can't update single entries
129 * and we really don't want bdrv_pread to perform a read-modify-write)
131 #define L1_ENTRIES_PER_SECTOR (512 / 8)
132 static int write_l1_entry(BlockDriverState
*bs
, int l1_index
)
134 BDRVQcowState
*s
= bs
->opaque
;
135 uint64_t buf
[L1_ENTRIES_PER_SECTOR
];
139 l1_start_index
= l1_index
& ~(L1_ENTRIES_PER_SECTOR
- 1);
140 for (i
= 0; i
< L1_ENTRIES_PER_SECTOR
; i
++) {
141 buf
[i
] = cpu_to_be64(s
->l1_table
[l1_start_index
+ i
]);
144 BLKDBG_EVENT(bs
->file
, BLKDBG_L1_UPDATE
);
145 ret
= bdrv_pwrite_sync(bs
->file
, s
->l1_table_offset
+ 8 * l1_start_index
,
157 * Allocate a new l2 entry in the file. If l1_index points to an already
158 * used entry in the L2 table (i.e. we are doing a copy on write for the L2
159 * table) copy the contents of the old L2 table into the newly allocated one.
160 * Otherwise the new table is initialized with zeros.
164 static int l2_allocate(BlockDriverState
*bs
, int l1_index
, uint64_t **table
)
166 BDRVQcowState
*s
= bs
->opaque
;
167 uint64_t old_l2_offset
;
172 old_l2_offset
= s
->l1_table
[l1_index
];
174 trace_qcow2_l2_allocate(bs
, l1_index
);
176 /* allocate a new l2 entry */
178 l2_offset
= qcow2_alloc_clusters(bs
, s
->l2_size
* sizeof(uint64_t));
183 ret
= qcow2_cache_flush(bs
, s
->refcount_block_cache
);
188 /* allocate a new entry in the l2 cache */
190 trace_qcow2_l2_allocate_get_empty(bs
, l1_index
);
191 ret
= qcow2_cache_get_empty(bs
, s
->l2_table_cache
, l2_offset
, (void**) table
);
198 if ((old_l2_offset
& L1E_OFFSET_MASK
) == 0) {
199 /* if there was no old l2 table, clear the new table */
200 memset(l2_table
, 0, s
->l2_size
* sizeof(uint64_t));
204 /* if there was an old l2 table, read it from the disk */
205 BLKDBG_EVENT(bs
->file
, BLKDBG_L2_ALLOC_COW_READ
);
206 ret
= qcow2_cache_get(bs
, s
->l2_table_cache
,
207 old_l2_offset
& L1E_OFFSET_MASK
,
208 (void**) &old_table
);
213 memcpy(l2_table
, old_table
, s
->cluster_size
);
215 ret
= qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) &old_table
);
221 /* write the l2 table to the file */
222 BLKDBG_EVENT(bs
->file
, BLKDBG_L2_ALLOC_WRITE
);
224 trace_qcow2_l2_allocate_write_l2(bs
, l1_index
);
225 qcow2_cache_entry_mark_dirty(s
->l2_table_cache
, l2_table
);
226 ret
= qcow2_cache_flush(bs
, s
->l2_table_cache
);
231 /* update the L1 entry */
232 trace_qcow2_l2_allocate_write_l1(bs
, l1_index
);
233 s
->l1_table
[l1_index
] = l2_offset
| QCOW_OFLAG_COPIED
;
234 ret
= write_l1_entry(bs
, l1_index
);
240 trace_qcow2_l2_allocate_done(bs
, l1_index
, 0);
244 trace_qcow2_l2_allocate_done(bs
, l1_index
, ret
);
245 qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) table
);
246 s
->l1_table
[l1_index
] = old_l2_offset
;
251 * Checks how many clusters in a given L2 table are contiguous in the image
252 * file. As soon as one of the flags in the bitmask stop_flags changes compared
253 * to the first cluster, the search is stopped and the cluster is not counted
254 * as contiguous. (This allows it, for example, to stop at the first compressed
255 * cluster which may require a different handling)
257 static int count_contiguous_clusters(uint64_t nb_clusters
, int cluster_size
,
258 uint64_t *l2_table
, uint64_t start
, uint64_t stop_flags
)
261 uint64_t mask
= stop_flags
| L2E_OFFSET_MASK
;
262 uint64_t offset
= be64_to_cpu(l2_table
[0]) & mask
;
267 for (i
= start
; i
< start
+ nb_clusters
; i
++) {
268 uint64_t l2_entry
= be64_to_cpu(l2_table
[i
]) & mask
;
269 if (offset
+ (uint64_t) i
* cluster_size
!= l2_entry
) {
277 static int count_contiguous_free_clusters(uint64_t nb_clusters
, uint64_t *l2_table
)
281 for (i
= 0; i
< nb_clusters
; i
++) {
282 int type
= qcow2_get_cluster_type(be64_to_cpu(l2_table
[i
]));
284 if (type
!= QCOW2_CLUSTER_UNALLOCATED
) {
292 /* The crypt function is compatible with the linux cryptoloop
293 algorithm for < 4 GB images. NOTE: out_buf == in_buf is
295 void qcow2_encrypt_sectors(BDRVQcowState
*s
, int64_t sector_num
,
296 uint8_t *out_buf
, const uint8_t *in_buf
,
297 int nb_sectors
, int enc
,
306 for(i
= 0; i
< nb_sectors
; i
++) {
307 ivec
.ll
[0] = cpu_to_le64(sector_num
);
309 AES_cbc_encrypt(in_buf
, out_buf
, 512, key
,
317 static int coroutine_fn
copy_sectors(BlockDriverState
*bs
,
319 uint64_t cluster_offset
,
320 int n_start
, int n_end
)
322 BDRVQcowState
*s
= bs
->opaque
;
328 * If this is the last cluster and it is only partially used, we must only
329 * copy until the end of the image, or bdrv_check_request will fail for the
330 * bdrv_read/write calls below.
332 if (start_sect
+ n_end
> bs
->total_sectors
) {
333 n_end
= bs
->total_sectors
- start_sect
;
341 iov
.iov_len
= n
* BDRV_SECTOR_SIZE
;
342 iov
.iov_base
= qemu_blockalign(bs
, iov
.iov_len
);
344 qemu_iovec_init_external(&qiov
, &iov
, 1);
346 BLKDBG_EVENT(bs
->file
, BLKDBG_COW_READ
);
348 /* Call .bdrv_co_readv() directly instead of using the public block-layer
349 * interface. This avoids double I/O throttling and request tracking,
350 * which can lead to deadlock when block layer copy-on-read is enabled.
352 ret
= bs
->drv
->bdrv_co_readv(bs
, start_sect
+ n_start
, n
, &qiov
);
357 if (s
->crypt_method
) {
358 qcow2_encrypt_sectors(s
, start_sect
+ n_start
,
359 iov
.iov_base
, iov
.iov_base
, n
, 1,
360 &s
->aes_encrypt_key
);
363 BLKDBG_EVENT(bs
->file
, BLKDBG_COW_WRITE
);
364 ret
= bdrv_co_writev(bs
->file
, (cluster_offset
>> 9) + n_start
, n
, &qiov
);
371 qemu_vfree(iov
.iov_base
);
379 * For a given offset of the disk image, find the cluster offset in
380 * qcow2 file. The offset is stored in *cluster_offset.
382 * on entry, *num is the number of contiguous sectors we'd like to
383 * access following offset.
385 * on exit, *num is the number of contiguous sectors we can read.
387 * Returns the cluster type (QCOW2_CLUSTER_*) on success, -errno in error
390 int qcow2_get_cluster_offset(BlockDriverState
*bs
, uint64_t offset
,
391 int *num
, uint64_t *cluster_offset
)
393 BDRVQcowState
*s
= bs
->opaque
;
394 unsigned int l1_index
, l2_index
;
395 uint64_t l2_offset
, *l2_table
;
397 unsigned int index_in_cluster
, nb_clusters
;
398 uint64_t nb_available
, nb_needed
;
401 index_in_cluster
= (offset
>> 9) & (s
->cluster_sectors
- 1);
402 nb_needed
= *num
+ index_in_cluster
;
404 l1_bits
= s
->l2_bits
+ s
->cluster_bits
;
406 /* compute how many bytes there are between the offset and
407 * the end of the l1 entry
410 nb_available
= (1ULL << l1_bits
) - (offset
& ((1ULL << l1_bits
) - 1));
412 /* compute the number of available sectors */
414 nb_available
= (nb_available
>> 9) + index_in_cluster
;
416 if (nb_needed
> nb_available
) {
417 nb_needed
= nb_available
;
422 /* seek the the l2 offset in the l1 table */
424 l1_index
= offset
>> l1_bits
;
425 if (l1_index
>= s
->l1_size
) {
426 ret
= QCOW2_CLUSTER_UNALLOCATED
;
430 l2_offset
= s
->l1_table
[l1_index
] & L1E_OFFSET_MASK
;
432 ret
= QCOW2_CLUSTER_UNALLOCATED
;
436 /* load the l2 table in memory */
438 ret
= l2_load(bs
, l2_offset
, &l2_table
);
443 /* find the cluster offset for the given disk offset */
445 l2_index
= (offset
>> s
->cluster_bits
) & (s
->l2_size
- 1);
446 *cluster_offset
= be64_to_cpu(l2_table
[l2_index
]);
447 nb_clusters
= size_to_clusters(s
, nb_needed
<< 9);
449 ret
= qcow2_get_cluster_type(*cluster_offset
);
451 case QCOW2_CLUSTER_COMPRESSED
:
452 /* Compressed clusters can only be processed one by one */
454 *cluster_offset
&= L2E_COMPRESSED_OFFSET_SIZE_MASK
;
456 case QCOW2_CLUSTER_ZERO
:
457 c
= count_contiguous_clusters(nb_clusters
, s
->cluster_size
,
458 &l2_table
[l2_index
], 0,
459 QCOW_OFLAG_COMPRESSED
| QCOW_OFLAG_ZERO
);
462 case QCOW2_CLUSTER_UNALLOCATED
:
463 /* how many empty clusters ? */
464 c
= count_contiguous_free_clusters(nb_clusters
, &l2_table
[l2_index
]);
467 case QCOW2_CLUSTER_NORMAL
:
468 /* how many allocated clusters ? */
469 c
= count_contiguous_clusters(nb_clusters
, s
->cluster_size
,
470 &l2_table
[l2_index
], 0,
471 QCOW_OFLAG_COMPRESSED
| QCOW_OFLAG_ZERO
);
472 *cluster_offset
&= L2E_OFFSET_MASK
;
478 qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) &l2_table
);
480 nb_available
= (c
* s
->cluster_sectors
);
483 if (nb_available
> nb_needed
)
484 nb_available
= nb_needed
;
486 *num
= nb_available
- index_in_cluster
;
494 * for a given disk offset, load (and allocate if needed)
497 * the l2 table offset in the qcow2 file and the cluster index
498 * in the l2 table are given to the caller.
500 * Returns 0 on success, -errno in failure case
502 static int get_cluster_table(BlockDriverState
*bs
, uint64_t offset
,
503 uint64_t **new_l2_table
,
506 BDRVQcowState
*s
= bs
->opaque
;
507 unsigned int l1_index
, l2_index
;
509 uint64_t *l2_table
= NULL
;
512 /* seek the the l2 offset in the l1 table */
514 l1_index
= offset
>> (s
->l2_bits
+ s
->cluster_bits
);
515 if (l1_index
>= s
->l1_size
) {
516 ret
= qcow2_grow_l1_table(bs
, l1_index
+ 1, false);
522 l2_offset
= s
->l1_table
[l1_index
] & L1E_OFFSET_MASK
;
524 /* seek the l2 table of the given l2 offset */
526 if (s
->l1_table
[l1_index
] & QCOW_OFLAG_COPIED
) {
527 /* load the l2 table in memory */
528 ret
= l2_load(bs
, l2_offset
, &l2_table
);
533 /* First allocate a new L2 table (and do COW if needed) */
534 ret
= l2_allocate(bs
, l1_index
, &l2_table
);
539 /* Then decrease the refcount of the old table */
541 qcow2_free_clusters(bs
, l2_offset
, s
->l2_size
* sizeof(uint64_t));
545 /* find the cluster offset for the given disk offset */
547 l2_index
= (offset
>> s
->cluster_bits
) & (s
->l2_size
- 1);
549 *new_l2_table
= l2_table
;
550 *new_l2_index
= l2_index
;
556 * alloc_compressed_cluster_offset
558 * For a given offset of the disk image, return cluster offset in
561 * If the offset is not found, allocate a new compressed cluster.
563 * Return the cluster offset if successful,
564 * Return 0, otherwise.
568 uint64_t qcow2_alloc_compressed_cluster_offset(BlockDriverState
*bs
,
572 BDRVQcowState
*s
= bs
->opaque
;
575 int64_t cluster_offset
;
578 ret
= get_cluster_table(bs
, offset
, &l2_table
, &l2_index
);
583 /* Compression can't overwrite anything. Fail if the cluster was already
585 cluster_offset
= be64_to_cpu(l2_table
[l2_index
]);
586 if (cluster_offset
& L2E_OFFSET_MASK
) {
587 qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) &l2_table
);
591 cluster_offset
= qcow2_alloc_bytes(bs
, compressed_size
);
592 if (cluster_offset
< 0) {
593 qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) &l2_table
);
597 nb_csectors
= ((cluster_offset
+ compressed_size
- 1) >> 9) -
598 (cluster_offset
>> 9);
600 cluster_offset
|= QCOW_OFLAG_COMPRESSED
|
601 ((uint64_t)nb_csectors
<< s
->csize_shift
);
603 /* update L2 table */
605 /* compressed clusters never have the copied flag */
607 BLKDBG_EVENT(bs
->file
, BLKDBG_L2_UPDATE_COMPRESSED
);
608 qcow2_cache_entry_mark_dirty(s
->l2_table_cache
, l2_table
);
609 l2_table
[l2_index
] = cpu_to_be64(cluster_offset
);
610 ret
= qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) &l2_table
);
615 return cluster_offset
;
618 int qcow2_alloc_cluster_link_l2(BlockDriverState
*bs
, QCowL2Meta
*m
)
620 BDRVQcowState
*s
= bs
->opaque
;
621 int i
, j
= 0, l2_index
, ret
;
622 uint64_t *old_cluster
, start_sect
, *l2_table
;
623 uint64_t cluster_offset
= m
->alloc_offset
;
626 trace_qcow2_cluster_link_l2(qemu_coroutine_self(), m
->nb_clusters
);
628 if (m
->nb_clusters
== 0)
631 old_cluster
= g_malloc(m
->nb_clusters
* sizeof(uint64_t));
633 /* copy content of unmodified sectors */
634 start_sect
= (m
->offset
& ~(s
->cluster_size
- 1)) >> 9;
637 qemu_co_mutex_unlock(&s
->lock
);
638 ret
= copy_sectors(bs
, start_sect
, cluster_offset
, 0, m
->n_start
);
639 qemu_co_mutex_lock(&s
->lock
);
644 if (m
->nb_available
& (s
->cluster_sectors
- 1)) {
646 qemu_co_mutex_unlock(&s
->lock
);
647 ret
= copy_sectors(bs
, start_sect
, cluster_offset
, m
->nb_available
,
648 align_offset(m
->nb_available
, s
->cluster_sectors
));
649 qemu_co_mutex_lock(&s
->lock
);
657 * Before we update the L2 table to actually point to the new cluster, we
658 * need to be sure that the refcounts have been increased and COW was
662 qcow2_cache_depends_on_flush(s
->l2_table_cache
);
665 qcow2_cache_set_dependency(bs
, s
->l2_table_cache
, s
->refcount_block_cache
);
666 ret
= get_cluster_table(bs
, m
->offset
, &l2_table
, &l2_index
);
670 qcow2_cache_entry_mark_dirty(s
->l2_table_cache
, l2_table
);
672 for (i
= 0; i
< m
->nb_clusters
; i
++) {
673 /* if two concurrent writes happen to the same unallocated cluster
674 * each write allocates separate cluster and writes data concurrently.
675 * The first one to complete updates l2 table with pointer to its
676 * cluster the second one has to do RMW (which is done above by
677 * copy_sectors()), update l2 table with its cluster pointer and free
678 * old cluster. This is what this loop does */
679 if(l2_table
[l2_index
+ i
] != 0)
680 old_cluster
[j
++] = l2_table
[l2_index
+ i
];
682 l2_table
[l2_index
+ i
] = cpu_to_be64((cluster_offset
+
683 (i
<< s
->cluster_bits
)) | QCOW_OFLAG_COPIED
);
687 ret
= qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) &l2_table
);
693 * If this was a COW, we need to decrease the refcount of the old cluster.
694 * Also flush bs->file to get the right order for L2 and refcount update.
697 for (i
= 0; i
< j
; i
++) {
698 qcow2_free_any_clusters(bs
, be64_to_cpu(old_cluster
[i
]), 1);
709 * Returns the number of contiguous clusters that can be used for an allocating
710 * write, but require COW to be performed (this includes yet unallocated space,
711 * which must copy from the backing file)
713 static int count_cow_clusters(BDRVQcowState
*s
, int nb_clusters
,
714 uint64_t *l2_table
, int l2_index
)
718 for (i
= 0; i
< nb_clusters
; i
++) {
719 uint64_t l2_entry
= be64_to_cpu(l2_table
[l2_index
+ i
]);
720 int cluster_type
= qcow2_get_cluster_type(l2_entry
);
722 switch(cluster_type
) {
723 case QCOW2_CLUSTER_NORMAL
:
724 if (l2_entry
& QCOW_OFLAG_COPIED
) {
728 case QCOW2_CLUSTER_UNALLOCATED
:
729 case QCOW2_CLUSTER_COMPRESSED
:
730 case QCOW2_CLUSTER_ZERO
:
738 assert(i
<= nb_clusters
);
743 * Allocates new clusters for the given guest_offset.
745 * At most *nb_clusters are allocated, and on return *nb_clusters is updated to
746 * contain the number of clusters that have been allocated and are contiguous
749 * If *host_offset is non-zero, it specifies the offset in the image file at
750 * which the new clusters must start. *nb_clusters can be 0 on return in this
751 * case if the cluster at host_offset is already in use. If *host_offset is
752 * zero, the clusters can be allocated anywhere in the image file.
754 * *host_offset is updated to contain the offset into the image file at which
755 * the first allocated cluster starts.
757 * Return 0 on success and -errno in error cases. -EAGAIN means that the
758 * function has been waiting for another request and the allocation must be
759 * restarted, but the whole request should not be failed.
761 static int do_alloc_cluster_offset(BlockDriverState
*bs
, uint64_t guest_offset
,
762 uint64_t *host_offset
, unsigned int *nb_clusters
)
764 BDRVQcowState
*s
= bs
->opaque
;
765 QCowL2Meta
*old_alloc
;
767 trace_qcow2_do_alloc_clusters_offset(qemu_coroutine_self(), guest_offset
,
768 *host_offset
, *nb_clusters
);
771 * Check if there already is an AIO write request in flight which allocates
772 * the same cluster. In this case we need to wait until the previous
773 * request has completed and updated the L2 table accordingly.
775 QLIST_FOREACH(old_alloc
, &s
->cluster_allocs
, next_in_flight
) {
777 uint64_t start
= guest_offset
>> s
->cluster_bits
;
778 uint64_t end
= start
+ *nb_clusters
;
779 uint64_t old_start
= old_alloc
->offset
>> s
->cluster_bits
;
780 uint64_t old_end
= old_start
+ old_alloc
->nb_clusters
;
782 if (end
< old_start
|| start
> old_end
) {
783 /* No intersection */
785 if (start
< old_start
) {
786 /* Stop at the start of a running allocation */
787 *nb_clusters
= old_start
- start
;
792 if (*nb_clusters
== 0) {
793 /* Wait for the dependency to complete. We need to recheck
794 * the free/allocated clusters when we continue. */
795 qemu_co_mutex_unlock(&s
->lock
);
796 qemu_co_queue_wait(&old_alloc
->dependent_requests
);
797 qemu_co_mutex_lock(&s
->lock
);
807 /* Allocate new clusters */
808 trace_qcow2_cluster_alloc_phys(qemu_coroutine_self());
809 if (*host_offset
== 0) {
810 int64_t cluster_offset
=
811 qcow2_alloc_clusters(bs
, *nb_clusters
* s
->cluster_size
);
812 if (cluster_offset
< 0) {
813 return cluster_offset
;
815 *host_offset
= cluster_offset
;
818 int ret
= qcow2_alloc_clusters_at(bs
, *host_offset
, *nb_clusters
);
828 * alloc_cluster_offset
830 * For a given offset on the virtual disk, find the cluster offset in qcow2
831 * file. If the offset is not found, allocate a new cluster.
833 * If the cluster was already allocated, m->nb_clusters is set to 0 and
834 * other fields in m are meaningless.
836 * If the cluster is newly allocated, m->nb_clusters is set to the number of
837 * contiguous clusters that have been allocated. In this case, the other
838 * fields of m are valid and contain information about the first allocated
841 * If the request conflicts with another write request in flight, the coroutine
842 * is queued and will be reentered when the dependency has completed.
844 * Return 0 on success and -errno in error cases
846 int qcow2_alloc_cluster_offset(BlockDriverState
*bs
, uint64_t offset
,
847 int n_start
, int n_end
, int *num
, QCowL2Meta
*m
)
849 BDRVQcowState
*s
= bs
->opaque
;
850 int l2_index
, ret
, sectors
;
852 unsigned int nb_clusters
, keep_clusters
;
853 uint64_t cluster_offset
;
855 trace_qcow2_alloc_clusters_offset(qemu_coroutine_self(), offset
,
858 /* Find L2 entry for the first involved cluster */
860 ret
= get_cluster_table(bs
, offset
, &l2_table
, &l2_index
);
866 * Calculate the number of clusters to look for. We stop at L2 table
867 * boundaries to keep things simple.
869 nb_clusters
= MIN(size_to_clusters(s
, n_end
<< BDRV_SECTOR_BITS
),
870 s
->l2_size
- l2_index
);
872 cluster_offset
= be64_to_cpu(l2_table
[l2_index
]);
875 * Check how many clusters are already allocated and don't need COW, and how
876 * many need a new allocation.
878 if (qcow2_get_cluster_type(cluster_offset
) == QCOW2_CLUSTER_NORMAL
879 && (cluster_offset
& QCOW_OFLAG_COPIED
))
881 /* We keep all QCOW_OFLAG_COPIED clusters */
883 count_contiguous_clusters(nb_clusters
, s
->cluster_size
,
884 &l2_table
[l2_index
], 0,
885 QCOW_OFLAG_COPIED
| QCOW_OFLAG_ZERO
);
886 assert(keep_clusters
<= nb_clusters
);
887 nb_clusters
-= keep_clusters
;
893 if (nb_clusters
> 0) {
894 /* For the moment, overwrite compressed clusters one by one */
895 uint64_t entry
= be64_to_cpu(l2_table
[l2_index
+ keep_clusters
]);
896 if (entry
& QCOW_OFLAG_COMPRESSED
) {
899 nb_clusters
= count_cow_clusters(s
, nb_clusters
, l2_table
,
900 l2_index
+ keep_clusters
);
904 cluster_offset
&= L2E_OFFSET_MASK
;
907 * The L2 table isn't used any more after this. As long as the cache works
908 * synchronously, it's important to release it before calling
909 * do_alloc_cluster_offset, which may yield if we need to wait for another
910 * request to complete. If we still had the reference, we could use up the
911 * whole cache with sleeping requests.
913 ret
= qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) &l2_table
);
918 /* If there is something left to allocate, do that now */
920 .cluster_offset
= cluster_offset
,
923 qemu_co_queue_init(&m
->dependent_requests
);
925 if (nb_clusters
> 0) {
926 uint64_t alloc_offset
;
927 uint64_t alloc_cluster_offset
;
928 uint64_t keep_bytes
= keep_clusters
* s
->cluster_size
;
930 /* Calculate start and size of allocation */
931 alloc_offset
= offset
+ keep_bytes
;
933 if (keep_clusters
== 0) {
934 alloc_cluster_offset
= 0;
936 alloc_cluster_offset
= cluster_offset
+ keep_bytes
;
939 /* Allocate, if necessary at a given offset in the image file */
940 ret
= do_alloc_cluster_offset(bs
, alloc_offset
, &alloc_cluster_offset
,
942 if (ret
== -EAGAIN
) {
944 } else if (ret
< 0) {
948 /* save info needed for meta data update */
949 if (nb_clusters
> 0) {
951 * requested_sectors: Number of sectors from the start of the first
952 * newly allocated cluster to the end of the (possibly shortened
953 * before) write request.
955 * avail_sectors: Number of sectors from the start of the first
956 * newly allocated to the end of the last newly allocated cluster.
958 int requested_sectors
= n_end
- keep_clusters
* s
->cluster_sectors
;
959 int avail_sectors
= nb_clusters
960 << (s
->cluster_bits
- BDRV_SECTOR_BITS
);
963 .cluster_offset
= keep_clusters
== 0 ?
964 alloc_cluster_offset
: cluster_offset
,
965 .alloc_offset
= alloc_cluster_offset
,
966 .offset
= alloc_offset
,
967 .n_start
= keep_clusters
== 0 ? n_start
: 0,
968 .nb_clusters
= nb_clusters
,
969 .nb_available
= MIN(requested_sectors
, avail_sectors
),
971 qemu_co_queue_init(&m
->dependent_requests
);
972 QLIST_INSERT_HEAD(&s
->cluster_allocs
, m
, next_in_flight
);
976 /* Some cleanup work */
977 sectors
= (keep_clusters
+ nb_clusters
) << (s
->cluster_bits
- 9);
978 if (sectors
> n_end
) {
982 assert(sectors
> n_start
);
983 *num
= sectors
- n_start
;
988 if (m
->nb_clusters
> 0) {
989 QLIST_REMOVE(m
, next_in_flight
);
994 static int decompress_buffer(uint8_t *out_buf
, int out_buf_size
,
995 const uint8_t *buf
, int buf_size
)
997 z_stream strm1
, *strm
= &strm1
;
1000 memset(strm
, 0, sizeof(*strm
));
1002 strm
->next_in
= (uint8_t *)buf
;
1003 strm
->avail_in
= buf_size
;
1004 strm
->next_out
= out_buf
;
1005 strm
->avail_out
= out_buf_size
;
1007 ret
= inflateInit2(strm
, -12);
1010 ret
= inflate(strm
, Z_FINISH
);
1011 out_len
= strm
->next_out
- out_buf
;
1012 if ((ret
!= Z_STREAM_END
&& ret
!= Z_BUF_ERROR
) ||
1013 out_len
!= out_buf_size
) {
1021 int qcow2_decompress_cluster(BlockDriverState
*bs
, uint64_t cluster_offset
)
1023 BDRVQcowState
*s
= bs
->opaque
;
1024 int ret
, csize
, nb_csectors
, sector_offset
;
1027 coffset
= cluster_offset
& s
->cluster_offset_mask
;
1028 if (s
->cluster_cache_offset
!= coffset
) {
1029 nb_csectors
= ((cluster_offset
>> s
->csize_shift
) & s
->csize_mask
) + 1;
1030 sector_offset
= coffset
& 511;
1031 csize
= nb_csectors
* 512 - sector_offset
;
1032 BLKDBG_EVENT(bs
->file
, BLKDBG_READ_COMPRESSED
);
1033 ret
= bdrv_read(bs
->file
, coffset
>> 9, s
->cluster_data
, nb_csectors
);
1037 if (decompress_buffer(s
->cluster_cache
, s
->cluster_size
,
1038 s
->cluster_data
+ sector_offset
, csize
) < 0) {
1041 s
->cluster_cache_offset
= coffset
;
1047 * This discards as many clusters of nb_clusters as possible at once (i.e.
1048 * all clusters in the same L2 table) and returns the number of discarded
1051 static int discard_single_l2(BlockDriverState
*bs
, uint64_t offset
,
1052 unsigned int nb_clusters
)
1054 BDRVQcowState
*s
= bs
->opaque
;
1060 ret
= get_cluster_table(bs
, offset
, &l2_table
, &l2_index
);
1065 /* Limit nb_clusters to one L2 table */
1066 nb_clusters
= MIN(nb_clusters
, s
->l2_size
- l2_index
);
1068 for (i
= 0; i
< nb_clusters
; i
++) {
1069 uint64_t old_offset
;
1071 old_offset
= be64_to_cpu(l2_table
[l2_index
+ i
]);
1072 if ((old_offset
& L2E_OFFSET_MASK
) == 0) {
1076 /* First remove L2 entries */
1077 qcow2_cache_entry_mark_dirty(s
->l2_table_cache
, l2_table
);
1078 l2_table
[l2_index
+ i
] = cpu_to_be64(0);
1080 /* Then decrease the refcount */
1081 qcow2_free_any_clusters(bs
, old_offset
, 1);
1084 ret
= qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) &l2_table
);
1092 int qcow2_discard_clusters(BlockDriverState
*bs
, uint64_t offset
,
1095 BDRVQcowState
*s
= bs
->opaque
;
1096 uint64_t end_offset
;
1097 unsigned int nb_clusters
;
1100 end_offset
= offset
+ (nb_sectors
<< BDRV_SECTOR_BITS
);
1102 /* Round start up and end down */
1103 offset
= align_offset(offset
, s
->cluster_size
);
1104 end_offset
&= ~(s
->cluster_size
- 1);
1106 if (offset
> end_offset
) {
1110 nb_clusters
= size_to_clusters(s
, end_offset
- offset
);
1112 /* Each L2 table is handled by its own loop iteration */
1113 while (nb_clusters
> 0) {
1114 ret
= discard_single_l2(bs
, offset
, nb_clusters
);
1120 offset
+= (ret
* s
->cluster_size
);
1127 * This zeroes as many clusters of nb_clusters as possible at once (i.e.
1128 * all clusters in the same L2 table) and returns the number of zeroed
1131 static int zero_single_l2(BlockDriverState
*bs
, uint64_t offset
,
1132 unsigned int nb_clusters
)
1134 BDRVQcowState
*s
= bs
->opaque
;
1140 ret
= get_cluster_table(bs
, offset
, &l2_table
, &l2_index
);
1145 /* Limit nb_clusters to one L2 table */
1146 nb_clusters
= MIN(nb_clusters
, s
->l2_size
- l2_index
);
1148 for (i
= 0; i
< nb_clusters
; i
++) {
1149 uint64_t old_offset
;
1151 old_offset
= be64_to_cpu(l2_table
[l2_index
+ i
]);
1153 /* Update L2 entries */
1154 qcow2_cache_entry_mark_dirty(s
->l2_table_cache
, l2_table
);
1155 if (old_offset
& QCOW_OFLAG_COMPRESSED
) {
1156 l2_table
[l2_index
+ i
] = cpu_to_be64(QCOW_OFLAG_ZERO
);
1157 qcow2_free_any_clusters(bs
, old_offset
, 1);
1159 l2_table
[l2_index
+ i
] |= cpu_to_be64(QCOW_OFLAG_ZERO
);
1163 ret
= qcow2_cache_put(bs
, s
->l2_table_cache
, (void**) &l2_table
);
1171 int qcow2_zero_clusters(BlockDriverState
*bs
, uint64_t offset
, int nb_sectors
)
1173 BDRVQcowState
*s
= bs
->opaque
;
1174 unsigned int nb_clusters
;
1177 /* The zero flag is only supported by version 3 and newer */
1178 if (s
->qcow_version
< 3) {
1182 /* Each L2 table is handled by its own loop iteration */
1183 nb_clusters
= size_to_clusters(s
, nb_sectors
<< BDRV_SECTOR_BITS
);
1185 while (nb_clusters
> 0) {
1186 ret
= zero_single_l2(bs
, offset
, nb_clusters
);
1192 offset
+= (ret
* s
->cluster_size
);