4 * Copyright Red Hat, Inc. 2012
7 * Paolo Bonzini <pbonzini@redhat.com>
9 * This work is licensed under the terms of the GNU LGPL, version 2 or later.
10 * See the COPYING.LIB file in the top-level directory.
15 #include "block/blockjob.h"
16 #include "block/block_int.h"
17 #include "qemu/ratelimit.h"
18 #include "qemu/bitmap.h"
20 #define SLICE_TIME 100000000ULL /* ns */
21 #define MAX_IN_FLIGHT 16
23 /* The mirroring buffer is a list of granularity-sized chunks.
24 * Free chunks are organized in a list.
26 typedef struct MirrorBuffer
{
27 QSIMPLEQ_ENTRY(MirrorBuffer
) next
;
30 typedef struct MirrorBlockJob
{
33 BlockDriverState
*target
;
34 BlockDriverState
*base
;
36 BlockdevOnError on_source_error
, on_target_error
;
42 unsigned long *cow_bitmap
;
43 BdrvDirtyBitmap
*dirty_bitmap
;
46 QSIMPLEQ_HEAD(, MirrorBuffer
) buf_free
;
49 unsigned long *in_flight_bitmap
;
54 typedef struct MirrorOp
{
61 static BlockErrorAction
mirror_error_action(MirrorBlockJob
*s
, bool read
,
66 return block_job_error_action(&s
->common
, s
->common
.bs
,
67 s
->on_source_error
, true, error
);
69 return block_job_error_action(&s
->common
, s
->target
,
70 s
->on_target_error
, false, error
);
74 static void mirror_iteration_done(MirrorOp
*op
, int ret
)
76 MirrorBlockJob
*s
= op
->s
;
79 int i
, nb_chunks
, sectors_per_chunk
;
81 trace_mirror_iteration_done(s
, op
->sector_num
, op
->nb_sectors
, ret
);
85 for (i
= 0; i
< op
->qiov
.niov
; i
++) {
86 MirrorBuffer
*buf
= (MirrorBuffer
*) iov
[i
].iov_base
;
87 QSIMPLEQ_INSERT_TAIL(&s
->buf_free
, buf
, next
);
91 sectors_per_chunk
= s
->granularity
>> BDRV_SECTOR_BITS
;
92 chunk_num
= op
->sector_num
/ sectors_per_chunk
;
93 nb_chunks
= op
->nb_sectors
/ sectors_per_chunk
;
94 bitmap_clear(s
->in_flight_bitmap
, chunk_num
, nb_chunks
);
95 if (s
->cow_bitmap
&& ret
>= 0) {
96 bitmap_set(s
->cow_bitmap
, chunk_num
, nb_chunks
);
99 qemu_iovec_destroy(&op
->qiov
);
100 g_slice_free(MirrorOp
, op
);
102 /* Enter coroutine when it is not sleeping. The coroutine sleeps to
103 * rate-limit itself. The coroutine will eventually resume since there is
104 * a sleep timeout so don't wake it early.
106 if (s
->common
.busy
) {
107 qemu_coroutine_enter(s
->common
.co
, NULL
);
111 static void mirror_write_complete(void *opaque
, int ret
)
113 MirrorOp
*op
= opaque
;
114 MirrorBlockJob
*s
= op
->s
;
116 BlockDriverState
*source
= s
->common
.bs
;
117 BlockErrorAction action
;
119 bdrv_set_dirty(source
, op
->sector_num
, op
->nb_sectors
);
120 action
= mirror_error_action(s
, false, -ret
);
121 if (action
== BDRV_ACTION_REPORT
&& s
->ret
>= 0) {
125 mirror_iteration_done(op
, ret
);
128 static void mirror_read_complete(void *opaque
, int ret
)
130 MirrorOp
*op
= opaque
;
131 MirrorBlockJob
*s
= op
->s
;
133 BlockDriverState
*source
= s
->common
.bs
;
134 BlockErrorAction action
;
136 bdrv_set_dirty(source
, op
->sector_num
, op
->nb_sectors
);
137 action
= mirror_error_action(s
, true, -ret
);
138 if (action
== BDRV_ACTION_REPORT
&& s
->ret
>= 0) {
142 mirror_iteration_done(op
, ret
);
145 bdrv_aio_writev(s
->target
, op
->sector_num
, &op
->qiov
, op
->nb_sectors
,
146 mirror_write_complete
, op
);
149 static uint64_t coroutine_fn
mirror_iteration(MirrorBlockJob
*s
)
151 BlockDriverState
*source
= s
->common
.bs
;
152 int nb_sectors
, sectors_per_chunk
, nb_chunks
;
153 int64_t end
, sector_num
, next_chunk
, next_sector
, hbitmap_next_sector
;
157 s
->sector_num
= hbitmap_iter_next(&s
->hbi
);
158 if (s
->sector_num
< 0) {
159 bdrv_dirty_iter_init(source
, s
->dirty_bitmap
, &s
->hbi
);
160 s
->sector_num
= hbitmap_iter_next(&s
->hbi
);
161 trace_mirror_restart_iter(s
,
162 bdrv_get_dirty_count(source
, s
->dirty_bitmap
));
163 assert(s
->sector_num
>= 0);
166 hbitmap_next_sector
= s
->sector_num
;
167 sector_num
= s
->sector_num
;
168 sectors_per_chunk
= s
->granularity
>> BDRV_SECTOR_BITS
;
169 end
= s
->common
.len
>> BDRV_SECTOR_BITS
;
171 /* Extend the QEMUIOVector to include all adjacent blocks that will
172 * be copied in this operation.
174 * We have to do this if we have no backing file yet in the destination,
175 * and the cluster size is very large. Then we need to do COW ourselves.
176 * The first time a cluster is copied, copy it entirely. Note that,
177 * because both the granularity and the cluster size are powers of two,
178 * the number of sectors to copy cannot exceed one cluster.
180 * We also want to extend the QEMUIOVector to include more adjacent
181 * dirty blocks if possible, to limit the number of I/O operations and
182 * run efficiently even with a small granularity.
186 next_sector
= sector_num
;
187 next_chunk
= sector_num
/ sectors_per_chunk
;
189 /* Wait for I/O to this cluster (from a previous iteration) to be done. */
190 while (test_bit(next_chunk
, s
->in_flight_bitmap
)) {
191 trace_mirror_yield_in_flight(s
, sector_num
, s
->in_flight
);
192 qemu_coroutine_yield();
196 int added_sectors
, added_chunks
;
198 if (!bdrv_get_dirty(source
, s
->dirty_bitmap
, next_sector
) ||
199 test_bit(next_chunk
, s
->in_flight_bitmap
)) {
200 assert(nb_sectors
> 0);
204 added_sectors
= sectors_per_chunk
;
205 if (s
->cow_bitmap
&& !test_bit(next_chunk
, s
->cow_bitmap
)) {
206 bdrv_round_to_clusters(s
->target
,
207 next_sector
, added_sectors
,
208 &next_sector
, &added_sectors
);
210 /* On the first iteration, the rounding may make us copy
211 * sectors before the first dirty one.
213 if (next_sector
< sector_num
) {
214 assert(nb_sectors
== 0);
215 sector_num
= next_sector
;
216 next_chunk
= next_sector
/ sectors_per_chunk
;
220 added_sectors
= MIN(added_sectors
, end
- (sector_num
+ nb_sectors
));
221 added_chunks
= (added_sectors
+ sectors_per_chunk
- 1) / sectors_per_chunk
;
223 /* When doing COW, it may happen that there is not enough space for
224 * a full cluster. Wait if that is the case.
226 while (nb_chunks
== 0 && s
->buf_free_count
< added_chunks
) {
227 trace_mirror_yield_buf_busy(s
, nb_chunks
, s
->in_flight
);
228 qemu_coroutine_yield();
230 if (s
->buf_free_count
< nb_chunks
+ added_chunks
) {
231 trace_mirror_break_buf_busy(s
, nb_chunks
, s
->in_flight
);
235 /* We have enough free space to copy these sectors. */
236 bitmap_set(s
->in_flight_bitmap
, next_chunk
, added_chunks
);
238 nb_sectors
+= added_sectors
;
239 nb_chunks
+= added_chunks
;
240 next_sector
+= added_sectors
;
241 next_chunk
+= added_chunks
;
242 if (!s
->synced
&& s
->common
.speed
) {
243 delay_ns
= ratelimit_calculate_delay(&s
->limit
, added_sectors
);
247 } while (delay_ns
== 0 && next_sector
< end
);
249 /* Allocate a MirrorOp that is used as an AIO callback. */
250 op
= g_slice_new(MirrorOp
);
252 op
->sector_num
= sector_num
;
253 op
->nb_sectors
= nb_sectors
;
255 /* Now make a QEMUIOVector taking enough granularity-sized chunks
258 qemu_iovec_init(&op
->qiov
, nb_chunks
);
259 next_sector
= sector_num
;
260 while (nb_chunks
-- > 0) {
261 MirrorBuffer
*buf
= QSIMPLEQ_FIRST(&s
->buf_free
);
262 QSIMPLEQ_REMOVE_HEAD(&s
->buf_free
, next
);
264 qemu_iovec_add(&op
->qiov
, buf
, s
->granularity
);
266 /* Advance the HBitmapIter in parallel, so that we do not examine
267 * the same sector twice.
269 if (next_sector
> hbitmap_next_sector
270 && bdrv_get_dirty(source
, s
->dirty_bitmap
, next_sector
)) {
271 hbitmap_next_sector
= hbitmap_iter_next(&s
->hbi
);
274 next_sector
+= sectors_per_chunk
;
277 bdrv_reset_dirty(source
, sector_num
, nb_sectors
);
279 /* Copy the dirty cluster. */
281 trace_mirror_one_iteration(s
, sector_num
, nb_sectors
);
282 bdrv_aio_readv(source
, sector_num
, &op
->qiov
, nb_sectors
,
283 mirror_read_complete
, op
);
287 static void mirror_free_init(MirrorBlockJob
*s
)
289 int granularity
= s
->granularity
;
290 size_t buf_size
= s
->buf_size
;
291 uint8_t *buf
= s
->buf
;
293 assert(s
->buf_free_count
== 0);
294 QSIMPLEQ_INIT(&s
->buf_free
);
295 while (buf_size
!= 0) {
296 MirrorBuffer
*cur
= (MirrorBuffer
*)buf
;
297 QSIMPLEQ_INSERT_TAIL(&s
->buf_free
, cur
, next
);
299 buf_size
-= granularity
;
304 static void mirror_drain(MirrorBlockJob
*s
)
306 while (s
->in_flight
> 0) {
307 qemu_coroutine_yield();
311 static void coroutine_fn
mirror_run(void *opaque
)
313 MirrorBlockJob
*s
= opaque
;
314 BlockDriverState
*bs
= s
->common
.bs
;
315 int64_t sector_num
, end
, sectors_per_chunk
, length
;
316 uint64_t last_pause_ns
;
318 char backing_filename
[1024];
322 if (block_job_is_cancelled(&s
->common
)) {
326 s
->common
.len
= bdrv_getlength(bs
);
327 if (s
->common
.len
<= 0) {
328 block_job_completed(&s
->common
, s
->common
.len
);
332 length
= (bdrv_getlength(bs
) + s
->granularity
- 1) / s
->granularity
;
333 s
->in_flight_bitmap
= bitmap_new(length
);
335 /* If we have no backing file yet in the destination, we cannot let
336 * the destination do COW. Instead, we copy sectors around the
337 * dirty data if needed. We need a bitmap to do that.
339 bdrv_get_backing_filename(s
->target
, backing_filename
,
340 sizeof(backing_filename
));
341 if (backing_filename
[0] && !s
->target
->backing_hd
) {
342 bdrv_get_info(s
->target
, &bdi
);
343 if (s
->granularity
< bdi
.cluster_size
) {
344 s
->buf_size
= MAX(s
->buf_size
, bdi
.cluster_size
);
345 s
->cow_bitmap
= bitmap_new(length
);
349 end
= s
->common
.len
>> BDRV_SECTOR_BITS
;
350 s
->buf
= qemu_blockalign(bs
, s
->buf_size
);
351 sectors_per_chunk
= s
->granularity
>> BDRV_SECTOR_BITS
;
354 if (!s
->is_none_mode
) {
355 /* First part, loop on the sectors and initialize the dirty bitmap. */
356 BlockDriverState
*base
= s
->base
;
357 for (sector_num
= 0; sector_num
< end
; ) {
358 int64_t next
= (sector_num
| (sectors_per_chunk
- 1)) + 1;
359 ret
= bdrv_is_allocated_above(bs
, base
,
360 sector_num
, next
- sector_num
, &n
);
368 bdrv_set_dirty(bs
, sector_num
, n
);
376 bdrv_dirty_iter_init(bs
, s
->dirty_bitmap
, &s
->hbi
);
377 last_pause_ns
= qemu_clock_get_ns(QEMU_CLOCK_REALTIME
);
379 uint64_t delay_ns
= 0;
381 bool should_complete
;
388 cnt
= bdrv_get_dirty_count(bs
, s
->dirty_bitmap
);
390 /* Note that even when no rate limit is applied we need to yield
391 * periodically with no pending I/O so that qemu_aio_flush() returns.
392 * We do so every SLICE_TIME nanoseconds, or when there is an error,
393 * or when the source is clean, whichever comes first.
395 if (qemu_clock_get_ns(QEMU_CLOCK_REALTIME
) - last_pause_ns
< SLICE_TIME
&&
396 s
->common
.iostatus
== BLOCK_DEVICE_IO_STATUS_OK
) {
397 if (s
->in_flight
== MAX_IN_FLIGHT
|| s
->buf_free_count
== 0 ||
398 (cnt
== 0 && s
->in_flight
> 0)) {
399 trace_mirror_yield(s
, s
->in_flight
, s
->buf_free_count
, cnt
);
400 qemu_coroutine_yield();
402 } else if (cnt
!= 0) {
403 delay_ns
= mirror_iteration(s
);
410 should_complete
= false;
411 if (s
->in_flight
== 0 && cnt
== 0) {
412 trace_mirror_before_flush(s
);
413 ret
= bdrv_flush(s
->target
);
415 if (mirror_error_action(s
, false, -ret
) == BDRV_ACTION_REPORT
) {
419 /* We're out of the streaming phase. From now on, if the job
420 * is cancelled we will actually complete all pending I/O and
421 * report completion. This way, block-job-cancel will leave
422 * the target in a consistent state.
424 s
->common
.offset
= end
* BDRV_SECTOR_SIZE
;
426 block_job_ready(&s
->common
);
430 should_complete
= s
->should_complete
||
431 block_job_is_cancelled(&s
->common
);
432 cnt
= bdrv_get_dirty_count(bs
, s
->dirty_bitmap
);
436 if (cnt
== 0 && should_complete
) {
437 /* The dirty bitmap is not updated while operations are pending.
438 * If we're about to exit, wait for pending operations before
439 * calling bdrv_get_dirty_count(bs), or we may exit while the
440 * source has dirty data to copy!
442 * Note that I/O can be submitted by the guest while
443 * mirror_populate runs.
445 trace_mirror_before_drain(s
, cnt
);
447 cnt
= bdrv_get_dirty_count(bs
, s
->dirty_bitmap
);
451 trace_mirror_before_sleep(s
, cnt
, s
->synced
, delay_ns
);
453 /* Publish progress */
454 s
->common
.offset
= (end
- cnt
) * BDRV_SECTOR_SIZE
;
455 block_job_sleep_ns(&s
->common
, QEMU_CLOCK_REALTIME
, delay_ns
);
456 if (block_job_is_cancelled(&s
->common
)) {
459 } else if (!should_complete
) {
460 delay_ns
= (s
->in_flight
== 0 && cnt
== 0 ? SLICE_TIME
: 0);
461 block_job_sleep_ns(&s
->common
, QEMU_CLOCK_REALTIME
, delay_ns
);
462 } else if (cnt
== 0) {
463 /* The two disks are in sync. Exit and report successful
466 assert(QLIST_EMPTY(&bs
->tracked_requests
));
467 s
->common
.cancelled
= false;
470 last_pause_ns
= qemu_clock_get_ns(QEMU_CLOCK_REALTIME
);
474 if (s
->in_flight
> 0) {
475 /* We get here only if something went wrong. Either the job failed,
476 * or it was cancelled prematurely so that we do not guarantee that
477 * the target is a copy of the source.
479 assert(ret
< 0 || (!s
->synced
&& block_job_is_cancelled(&s
->common
)));
483 assert(s
->in_flight
== 0);
485 g_free(s
->cow_bitmap
);
486 g_free(s
->in_flight_bitmap
);
487 bdrv_release_dirty_bitmap(bs
, s
->dirty_bitmap
);
488 bdrv_iostatus_disable(s
->target
);
489 if (s
->should_complete
&& ret
== 0) {
490 if (bdrv_get_flags(s
->target
) != bdrv_get_flags(s
->common
.bs
)) {
491 bdrv_reopen(s
->target
, bdrv_get_flags(s
->common
.bs
), NULL
);
493 bdrv_swap(s
->target
, s
->common
.bs
);
494 if (s
->common
.driver
->job_type
== BLOCK_JOB_TYPE_COMMIT
) {
495 /* drop the bs loop chain formed by the swap: break the loop then
496 * trigger the unref from the top one */
497 BlockDriverState
*p
= s
->base
->backing_hd
;
498 s
->base
->backing_hd
= NULL
;
502 bdrv_unref(s
->target
);
503 block_job_completed(&s
->common
, ret
);
506 static void mirror_set_speed(BlockJob
*job
, int64_t speed
, Error
**errp
)
508 MirrorBlockJob
*s
= container_of(job
, MirrorBlockJob
, common
);
511 error_set(errp
, QERR_INVALID_PARAMETER
, "speed");
514 ratelimit_set_speed(&s
->limit
, speed
/ BDRV_SECTOR_SIZE
, SLICE_TIME
);
517 static void mirror_iostatus_reset(BlockJob
*job
)
519 MirrorBlockJob
*s
= container_of(job
, MirrorBlockJob
, common
);
521 bdrv_iostatus_reset(s
->target
);
524 static void mirror_complete(BlockJob
*job
, Error
**errp
)
526 MirrorBlockJob
*s
= container_of(job
, MirrorBlockJob
, common
);
527 Error
*local_err
= NULL
;
530 ret
= bdrv_open_backing_file(s
->target
, NULL
, &local_err
);
532 error_propagate(errp
, local_err
);
536 error_set(errp
, QERR_BLOCK_JOB_NOT_READY
, job
->bs
->device_name
);
540 s
->should_complete
= true;
541 block_job_resume(job
);
544 static const BlockJobDriver mirror_job_driver
= {
545 .instance_size
= sizeof(MirrorBlockJob
),
546 .job_type
= BLOCK_JOB_TYPE_MIRROR
,
547 .set_speed
= mirror_set_speed
,
548 .iostatus_reset
= mirror_iostatus_reset
,
549 .complete
= mirror_complete
,
552 static const BlockJobDriver commit_active_job_driver
= {
553 .instance_size
= sizeof(MirrorBlockJob
),
554 .job_type
= BLOCK_JOB_TYPE_COMMIT
,
555 .set_speed
= mirror_set_speed
,
557 = mirror_iostatus_reset
,
558 .complete
= mirror_complete
,
561 static void mirror_start_job(BlockDriverState
*bs
, BlockDriverState
*target
,
562 int64_t speed
, int64_t granularity
,
564 BlockdevOnError on_source_error
,
565 BlockdevOnError on_target_error
,
566 BlockDriverCompletionFunc
*cb
,
567 void *opaque
, Error
**errp
,
568 const BlockJobDriver
*driver
,
569 bool is_none_mode
, BlockDriverState
*base
)
573 if (granularity
== 0) {
574 /* Choose the default granularity based on the target file's cluster
575 * size, clamped between 4k and 64k. */
577 if (bdrv_get_info(target
, &bdi
) >= 0 && bdi
.cluster_size
!= 0) {
578 granularity
= MAX(4096, bdi
.cluster_size
);
579 granularity
= MIN(65536, granularity
);
585 assert ((granularity
& (granularity
- 1)) == 0);
587 if ((on_source_error
== BLOCKDEV_ON_ERROR_STOP
||
588 on_source_error
== BLOCKDEV_ON_ERROR_ENOSPC
) &&
589 !bdrv_iostatus_is_enabled(bs
)) {
590 error_set(errp
, QERR_INVALID_PARAMETER
, "on-source-error");
595 s
= block_job_create(driver
, bs
, speed
, cb
, opaque
, errp
);
600 s
->on_source_error
= on_source_error
;
601 s
->on_target_error
= on_target_error
;
603 s
->is_none_mode
= is_none_mode
;
605 s
->granularity
= granularity
;
606 s
->buf_size
= MAX(buf_size
, granularity
);
608 s
->dirty_bitmap
= bdrv_create_dirty_bitmap(bs
, granularity
);
609 bdrv_set_enable_write_cache(s
->target
, true);
610 bdrv_set_on_error(s
->target
, on_target_error
, on_target_error
);
611 bdrv_iostatus_enable(s
->target
);
612 s
->common
.co
= qemu_coroutine_create(mirror_run
);
613 trace_mirror_start(bs
, s
, s
->common
.co
, opaque
);
614 qemu_coroutine_enter(s
->common
.co
, s
);
617 void mirror_start(BlockDriverState
*bs
, BlockDriverState
*target
,
618 int64_t speed
, int64_t granularity
, int64_t buf_size
,
619 MirrorSyncMode mode
, BlockdevOnError on_source_error
,
620 BlockdevOnError on_target_error
,
621 BlockDriverCompletionFunc
*cb
,
622 void *opaque
, Error
**errp
)
625 BlockDriverState
*base
;
627 is_none_mode
= mode
== MIRROR_SYNC_MODE_NONE
;
628 base
= mode
== MIRROR_SYNC_MODE_TOP
? bs
->backing_hd
: NULL
;
629 mirror_start_job(bs
, target
, speed
, granularity
, buf_size
,
630 on_source_error
, on_target_error
, cb
, opaque
, errp
,
631 &mirror_job_driver
, is_none_mode
, base
);
634 void commit_active_start(BlockDriverState
*bs
, BlockDriverState
*base
,
636 BlockdevOnError on_error
,
637 BlockDriverCompletionFunc
*cb
,
638 void *opaque
, Error
**errp
)
640 int64_t length
, base_length
;
643 Error
*local_err
= NULL
;
645 orig_base_flags
= bdrv_get_flags(base
);
647 if (bdrv_reopen(base
, bs
->open_flags
, errp
)) {
651 length
= bdrv_getlength(bs
);
653 error_setg_errno(errp
, -length
,
654 "Unable to determine length of %s", bs
->filename
);
655 goto error_restore_flags
;
658 base_length
= bdrv_getlength(base
);
659 if (base_length
< 0) {
660 error_setg_errno(errp
, -base_length
,
661 "Unable to determine length of %s", base
->filename
);
662 goto error_restore_flags
;
665 if (length
> base_length
) {
666 ret
= bdrv_truncate(base
, length
);
668 error_setg_errno(errp
, -ret
,
669 "Top image %s is larger than base image %s, and "
670 "resize of base image failed",
671 bs
->filename
, base
->filename
);
672 goto error_restore_flags
;
677 mirror_start_job(bs
, base
, speed
, 0, 0,
678 on_error
, on_error
, cb
, opaque
, &local_err
,
679 &commit_active_job_driver
, false, base
);
680 if (error_is_set(&local_err
)) {
681 error_propagate(errp
, local_err
);
682 goto error_restore_flags
;
688 /* ignore error and errp for bdrv_reopen, because we want to propagate
689 * the original error */
690 bdrv_reopen(base
, orig_base_flags
, NULL
);