io.c 93.1 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
/*
 * Block layer I/O functions
 *
 * Copyright (c) 2003 Fabrice Bellard
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

P
Peter Maydell 已提交
25
#include "qemu/osdep.h"
26
#include "trace.h"
27
#include "sysemu/block-backend.h"
28
#include "block/aio-wait.h"
29
#include "block/blockjob.h"
30
#include "block/blockjob_int.h"
31
#include "block/block_int.h"
32
#include "qemu/cutils.h"
33
#include "qapi/error.h"
34
#include "qemu/error-report.h"
35 36 37

#define NOT_DONE 0x7fffffff /* used while emulated sync operation in progress */

E
Eric Blake 已提交
38 39 40
/* Maximum bounce buffer for copy-on-read and write zeroes, in bytes */
#define MAX_BOUNCE_BUFFER (32768 << BDRV_SECTOR_BITS)

41 42
static AioWait drain_all_aio_wait;

E
Eric Blake 已提交
43
static int coroutine_fn bdrv_co_do_pwrite_zeroes(BlockDriverState *bs,
44
    int64_t offset, int bytes, BdrvRequestFlags flags);
45

46 47
void bdrv_parent_drained_begin(BlockDriverState *bs, BdrvChild *ignore,
                               bool ignore_bds_parents)
48
{
49
    BdrvChild *c, *next;
50

51
    QLIST_FOREACH_SAFE(c, &bs->parents, next_parent, next) {
52
        if (c == ignore || (ignore_bds_parents && c->role->parent_is_bds)) {
53 54
            continue;
        }
55
        bdrv_parent_drained_begin_single(c, false);
56 57
    }
}
58

59 60
void bdrv_parent_drained_end(BlockDriverState *bs, BdrvChild *ignore,
                             bool ignore_bds_parents)
61
{
62
    BdrvChild *c, *next;
63

64
    QLIST_FOREACH_SAFE(c, &bs->parents, next_parent, next) {
65
        if (c == ignore || (ignore_bds_parents && c->role->parent_is_bds)) {
66 67
            continue;
        }
68 69 70
        if (c->role->drained_end) {
            c->role->drained_end(c);
        }
71
    }
72 73
}

74 75 76 77 78 79 80 81
static bool bdrv_parent_drained_poll_single(BdrvChild *c)
{
    if (c->role->drained_poll) {
        return c->role->drained_poll(c);
    }
    return false;
}

82 83
static bool bdrv_parent_drained_poll(BlockDriverState *bs, BdrvChild *ignore,
                                     bool ignore_bds_parents)
84 85 86 87 88
{
    BdrvChild *c, *next;
    bool busy = false;

    QLIST_FOREACH_SAFE(c, &bs->parents, next_parent, next) {
89
        if (c == ignore || (ignore_bds_parents && c->role->parent_is_bds)) {
90 91
            continue;
        }
92
        busy |= bdrv_parent_drained_poll_single(c);
93 94 95 96 97
    }

    return busy;
}

98 99 100 101 102 103 104 105 106 107
void bdrv_parent_drained_begin_single(BdrvChild *c, bool poll)
{
    if (c->role->drained_begin) {
        c->role->drained_begin(c);
    }
    if (poll) {
        BDRV_POLL_WHILE(c->bs, bdrv_parent_drained_poll_single(c));
    }
}

108 109 110 111 112 113 114 115 116 117 118
static void bdrv_merge_limits(BlockLimits *dst, const BlockLimits *src)
{
    dst->opt_transfer = MAX(dst->opt_transfer, src->opt_transfer);
    dst->max_transfer = MIN_NON_ZERO(dst->max_transfer, src->max_transfer);
    dst->opt_mem_alignment = MAX(dst->opt_mem_alignment,
                                 src->opt_mem_alignment);
    dst->min_mem_alignment = MAX(dst->min_mem_alignment,
                                 src->min_mem_alignment);
    dst->max_iov = MIN_NON_ZERO(dst->max_iov, src->max_iov);
}

119 120 121 122 123 124 125 126 127 128 129
void bdrv_refresh_limits(BlockDriverState *bs, Error **errp)
{
    BlockDriver *drv = bs->drv;
    Error *local_err = NULL;

    memset(&bs->bl, 0, sizeof(bs->bl));

    if (!drv) {
        return;
    }

130
    /* Default alignment based on whether driver has byte interface */
131 132
    bs->bl.request_alignment = (drv->bdrv_co_preadv ||
                                drv->bdrv_aio_preadv) ? 1 : 512;
133

134 135
    /* Take some limits from the children as a default */
    if (bs->file) {
K
Kevin Wolf 已提交
136
        bdrv_refresh_limits(bs->file->bs, &local_err);
137 138 139 140
        if (local_err) {
            error_propagate(errp, local_err);
            return;
        }
141
        bdrv_merge_limits(&bs->bl, &bs->file->bs->bl);
142
    } else {
143
        bs->bl.min_mem_alignment = 512;
144
        bs->bl.opt_mem_alignment = getpagesize();
145 146 147

        /* Safe default since most protocols use readv()/writev()/etc */
        bs->bl.max_iov = IOV_MAX;
148 149
    }

150 151
    if (bs->backing) {
        bdrv_refresh_limits(bs->backing->bs, &local_err);
152 153 154 155
        if (local_err) {
            error_propagate(errp, local_err);
            return;
        }
156
        bdrv_merge_limits(&bs->bl, &bs->backing->bs->bl);
157 158 159 160 161 162 163 164 165 166 167 168 169 170 171
    }

    /* Then let the driver override it */
    if (drv->bdrv_refresh_limits) {
        drv->bdrv_refresh_limits(bs, errp);
    }
}

/**
 * The copy-on-read flag is actually a reference count so multiple users may
 * use the feature without worrying about clobbering its previous state.
 * Copy-on-read stays enabled until all users have called to disable it.
 */
void bdrv_enable_copy_on_read(BlockDriverState *bs)
{
172
    atomic_inc(&bs->copy_on_read);
173 174 175 176
}

void bdrv_disable_copy_on_read(BlockDriverState *bs)
{
177 178
    int old = atomic_fetch_dec(&bs->copy_on_read);
    assert(old >= 1);
179 180
}

181 182 183 184
typedef struct {
    Coroutine *co;
    BlockDriverState *bs;
    bool done;
185
    bool begin;
186
    bool recursive;
187
    bool poll;
188
    BdrvChild *parent;
189
    bool ignore_bds_parents;
190 191 192 193 194 195 196
} BdrvCoDrainData;

static void coroutine_fn bdrv_drain_invoke_entry(void *opaque)
{
    BdrvCoDrainData *data = opaque;
    BlockDriverState *bs = data->bs;

197
    if (data->begin) {
198
        bs->drv->bdrv_co_drain_begin(bs);
199 200 201
    } else {
        bs->drv->bdrv_co_drain_end(bs);
    }
202 203 204

    /* Set data->done before reading bs->wakeup.  */
    atomic_mb_set(&data->done, true);
205 206 207 208 209
    bdrv_dec_in_flight(bs);

    if (data->begin) {
        g_free(data);
    }
210 211
}

212
/* Recursively call BlockDriver.bdrv_co_drain_begin/end callbacks */
213
static void bdrv_drain_invoke(BlockDriverState *bs, bool begin)
214
{
215
    BdrvCoDrainData *data;
216

217
    if (!bs->drv || (begin && !bs->drv->bdrv_co_drain_begin) ||
218
            (!begin && !bs->drv->bdrv_co_drain_end)) {
219 220 221
        return;
    }

222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238
    data = g_new(BdrvCoDrainData, 1);
    *data = (BdrvCoDrainData) {
        .bs = bs,
        .done = false,
        .begin = begin
    };

    /* Make sure the driver callback completes during the polling phase for
     * drain_begin. */
    bdrv_inc_in_flight(bs);
    data->co = qemu_coroutine_create(bdrv_drain_invoke_entry, data);
    aio_co_schedule(bdrv_get_aio_context(bs), data->co);

    if (!begin) {
        BDRV_POLL_WHILE(bs, !data->done);
        g_free(data);
    }
239 240
}

241
/* Returns true if BDRV_POLL_WHILE() should go into a blocking aio_poll() */
242
bool bdrv_drain_poll(BlockDriverState *bs, bool recursive,
243
                     BdrvChild *ignore_parent, bool ignore_bds_parents)
244
{
245 246
    BdrvChild *child, *next;

247
    if (bdrv_parent_drained_poll(bs, ignore_parent, ignore_bds_parents)) {
248 249 250
        return true;
    }

251 252 253 254 255
    if (atomic_read(&bs->in_flight)) {
        return true;
    }

    if (recursive) {
256
        assert(!ignore_bds_parents);
257
        QLIST_FOREACH_SAFE(child, &bs->children, next, next) {
258
            if (bdrv_drain_poll(child->bs, recursive, child, false)) {
259 260 261 262 263 264
                return true;
            }
        }
    }

    return false;
265 266
}

267
static bool bdrv_drain_poll_top_level(BlockDriverState *bs, bool recursive,
268
                                      BdrvChild *ignore_parent)
269 270 271 272
{
    /* Execute pending BHs first and check everything else only after the BHs
     * have executed. */
    while (aio_poll(bs->aio_context, false));
273

274
    return bdrv_drain_poll(bs, recursive, ignore_parent, false);
275 276
}

277
static void bdrv_do_drained_begin(BlockDriverState *bs, bool recursive,
278 279
                                  BdrvChild *parent, bool ignore_bds_parents,
                                  bool poll);
280
static void bdrv_do_drained_end(BlockDriverState *bs, bool recursive,
281
                                BdrvChild *parent, bool ignore_bds_parents);
282

F
Fam Zheng 已提交
283 284 285 286
static void bdrv_co_drain_bh_cb(void *opaque)
{
    BdrvCoDrainData *data = opaque;
    Coroutine *co = data->co;
287
    BlockDriverState *bs = data->bs;
F
Fam Zheng 已提交
288

289 290 291
    if (bs) {
        bdrv_dec_in_flight(bs);
        if (data->begin) {
292 293
            bdrv_do_drained_begin(bs, data->recursive, data->parent,
                                  data->ignore_bds_parents, data->poll);
294
        } else {
295 296
            bdrv_do_drained_end(bs, data->recursive, data->parent,
                                data->ignore_bds_parents);
297
        }
298
    } else {
299 300
        assert(data->begin);
        bdrv_drain_all_begin();
301 302
    }

F
Fam Zheng 已提交
303
    data->done = true;
304
    aio_co_wake(co);
F
Fam Zheng 已提交
305 306
}

307
static void coroutine_fn bdrv_co_yield_to_drain(BlockDriverState *bs,
308
                                                bool begin, bool recursive,
309 310 311
                                                BdrvChild *parent,
                                                bool ignore_bds_parents,
                                                bool poll)
F
Fam Zheng 已提交
312 313 314 315
{
    BdrvCoDrainData data;

    /* Calling bdrv_drain() from a BH ensures the current coroutine yields and
316
     * other coroutines run if they were queued by aio_co_enter(). */
F
Fam Zheng 已提交
317 318 319 320 321 322

    assert(qemu_in_coroutine());
    data = (BdrvCoDrainData) {
        .co = qemu_coroutine_self(),
        .bs = bs,
        .done = false,
323
        .begin = begin,
324
        .recursive = recursive,
325
        .parent = parent,
326
        .ignore_bds_parents = ignore_bds_parents,
327
        .poll = poll,
F
Fam Zheng 已提交
328
    };
329 330 331
    if (bs) {
        bdrv_inc_in_flight(bs);
    }
P
Paolo Bonzini 已提交
332 333
    aio_bh_schedule_oneshot(bdrv_get_aio_context(bs),
                            bdrv_co_drain_bh_cb, &data);
F
Fam Zheng 已提交
334 335 336 337 338 339 340

    qemu_coroutine_yield();
    /* If we are resumed from some other event (such as an aio completion or a
     * timer callback), it is a bug in the caller that should be fixed. */
    assert(data.done);
}

341
void bdrv_do_drained_begin_quiesce(BlockDriverState *bs,
342
                                   BdrvChild *parent, bool ignore_bds_parents)
343
{
344
    assert(!qemu_in_coroutine());
345

K
Kevin Wolf 已提交
346
    /* Stop things in parent-to-child order */
347
    if (atomic_fetch_inc(&bs->quiesce_counter) == 0) {
348 349 350
        aio_disable_external(bdrv_get_aio_context(bs));
    }

351
    bdrv_parent_drained_begin(bs, parent, ignore_bds_parents);
352
    bdrv_drain_invoke(bs, true);
353 354 355
}

static void bdrv_do_drained_begin(BlockDriverState *bs, bool recursive,
356 357
                                  BdrvChild *parent, bool ignore_bds_parents,
                                  bool poll)
358 359 360 361
{
    BdrvChild *child, *next;

    if (qemu_in_coroutine()) {
362 363
        bdrv_co_yield_to_drain(bs, true, recursive, parent, ignore_bds_parents,
                               poll);
364 365 366
        return;
    }

367
    bdrv_do_drained_begin_quiesce(bs, parent, ignore_bds_parents);
K
Kevin Wolf 已提交
368

369
    if (recursive) {
370
        assert(!ignore_bds_parents);
371
        bs->recursive_quiesce_counter++;
372
        QLIST_FOREACH_SAFE(child, &bs->children, next, next) {
373 374
            bdrv_do_drained_begin(child->bs, true, child, ignore_bds_parents,
                                  false);
375 376
        }
    }
377 378 379 380 381 382 383 384 385 386 387

    /*
     * Wait for drained requests to finish.
     *
     * Calling BDRV_POLL_WHILE() only once for the top-level node is okay: The
     * call is needed so things in this AioContext can make progress even
     * though we don't return to the main AioContext loop - this automatically
     * includes other nodes in the same AioContext and therefore all child
     * nodes.
     */
    if (poll) {
388
        assert(!ignore_bds_parents);
389 390
        BDRV_POLL_WHILE(bs, bdrv_drain_poll_top_level(bs, recursive, parent));
    }
391 392
}

393 394
void bdrv_drained_begin(BlockDriverState *bs)
{
395
    bdrv_do_drained_begin(bs, false, NULL, false, true);
396 397 398 399
}

void bdrv_subtree_drained_begin(BlockDriverState *bs)
{
400
    bdrv_do_drained_begin(bs, true, NULL, false, true);
401 402
}

403 404
static void bdrv_do_drained_end(BlockDriverState *bs, bool recursive,
                                BdrvChild *parent, bool ignore_bds_parents)
405
{
406
    BdrvChild *child, *next;
407 408
    int old_quiesce_counter;

409
    if (qemu_in_coroutine()) {
410 411
        bdrv_co_yield_to_drain(bs, false, recursive, parent, ignore_bds_parents,
                               false);
412 413
        return;
    }
414
    assert(bs->quiesce_counter > 0);
415
    old_quiesce_counter = atomic_fetch_dec(&bs->quiesce_counter);
416

K
Kevin Wolf 已提交
417
    /* Re-enable things in child-to-parent order */
418
    bdrv_drain_invoke(bs, false);
419
    bdrv_parent_drained_end(bs, parent, ignore_bds_parents);
420 421 422
    if (old_quiesce_counter == 1) {
        aio_enable_external(bdrv_get_aio_context(bs));
    }
423 424

    if (recursive) {
425
        assert(!ignore_bds_parents);
426
        bs->recursive_quiesce_counter--;
427
        QLIST_FOREACH_SAFE(child, &bs->children, next, next) {
428
            bdrv_do_drained_end(child->bs, true, child, ignore_bds_parents);
429 430
        }
    }
431 432
}

433 434
void bdrv_drained_end(BlockDriverState *bs)
{
435
    bdrv_do_drained_end(bs, false, NULL, false);
436 437 438 439
}

void bdrv_subtree_drained_end(BlockDriverState *bs)
{
440
    bdrv_do_drained_end(bs, true, NULL, false);
441 442
}

443 444 445 446 447
void bdrv_apply_subtree_drain(BdrvChild *child, BlockDriverState *new_parent)
{
    int i;

    for (i = 0; i < new_parent->recursive_quiesce_counter; i++) {
448
        bdrv_do_drained_begin(child->bs, true, child, false, true);
449 450 451 452 453 454 455 456
    }
}

void bdrv_unapply_subtree_drain(BdrvChild *child, BlockDriverState *old_parent)
{
    int i;

    for (i = 0; i < old_parent->recursive_quiesce_counter; i++) {
457
        bdrv_do_drained_end(child->bs, true, child, false);
458 459 460
    }
}

461
/*
462 463
 * Wait for pending requests to complete on a single BlockDriverState subtree,
 * and suspend block driver's internal I/O until next request arrives.
464 465 466 467
 *
 * Note that unlike bdrv_drain_all(), the caller must hold the BlockDriverState
 * AioContext.
 */
468
void coroutine_fn bdrv_co_drain(BlockDriverState *bs)
469
{
470 471 472
    assert(qemu_in_coroutine());
    bdrv_drained_begin(bs);
    bdrv_drained_end(bs);
473
}
474

475 476
void bdrv_drain(BlockDriverState *bs)
{
477 478
    bdrv_drained_begin(bs);
    bdrv_drained_end(bs);
479 480
}

481 482 483 484 485 486 487 488 489 490
static void bdrv_drain_assert_idle(BlockDriverState *bs)
{
    BdrvChild *child, *next;

    assert(atomic_read(&bs->in_flight) == 0);
    QLIST_FOREACH_SAFE(child, &bs->children, next, next) {
        bdrv_drain_assert_idle(child->bs);
    }
}

491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513
unsigned int bdrv_drain_all_count = 0;

static bool bdrv_drain_all_poll(void)
{
    BlockDriverState *bs = NULL;
    bool result = false;

    /* Execute pending BHs first (may modify the graph) and check everything
     * else only after the BHs have executed. */
    while (aio_poll(qemu_get_aio_context(), false));

    /* bdrv_drain_poll() can't make changes to the graph and we are holding the
     * main AioContext lock, so iterating bdrv_next_all_states() is safe. */
    while ((bs = bdrv_next_all_states(bs))) {
        AioContext *aio_context = bdrv_get_aio_context(bs);
        aio_context_acquire(aio_context);
        result |= bdrv_drain_poll(bs, false, NULL, true);
        aio_context_release(aio_context);
    }

    return result;
}

514 515 516 517 518
/*
 * Wait for pending requests to complete across all BlockDriverStates
 *
 * This function does not flush data to disk, use bdrv_flush_all() for that
 * after calling this function.
519 520 521 522 523 524
 *
 * This pauses all block jobs and disables external clients. It must
 * be paired with bdrv_drain_all_end().
 *
 * NOTE: no new block jobs or BlockDriverStates can be created between
 * the bdrv_drain_all_begin() and bdrv_drain_all_end() calls.
525
 */
526
void bdrv_drain_all_begin(void)
527
{
528
    BlockDriverState *bs = NULL;
529

530
    if (qemu_in_coroutine()) {
531
        bdrv_co_yield_to_drain(NULL, true, false, NULL, true, true);
532 533 534
        return;
    }

535 536
    /* AIO_WAIT_WHILE() with a NULL context can only be called from the main
     * loop AioContext, so make sure we're in the main context. */
537
    assert(qemu_get_current_aio_context() == qemu_get_aio_context());
538 539
    assert(bdrv_drain_all_count < INT_MAX);
    bdrv_drain_all_count++;
540

541 542 543
    /* Quiesce all nodes, without polling in-flight requests yet. The graph
     * cannot change during this loop. */
    while ((bs = bdrv_next_all_states(bs))) {
544 545 546
        AioContext *aio_context = bdrv_get_aio_context(bs);

        aio_context_acquire(aio_context);
547
        bdrv_do_drained_begin(bs, false, NULL, true, false);
548 549 550
        aio_context_release(aio_context);
    }

551 552 553 554
    /* Now poll the in-flight requests */
    AIO_WAIT_WHILE(&drain_all_aio_wait, NULL, bdrv_drain_all_poll());

    while ((bs = bdrv_next_all_states(bs))) {
555
        bdrv_drain_assert_idle(bs);
556
    }
557 558 559 560
}

void bdrv_drain_all_end(void)
{
561
    BlockDriverState *bs = NULL;
562

563
    while ((bs = bdrv_next_all_states(bs))) {
564 565 566
        AioContext *aio_context = bdrv_get_aio_context(bs);

        aio_context_acquire(aio_context);
567
        bdrv_do_drained_end(bs, false, NULL, true);
568 569
        aio_context_release(aio_context);
    }
570 571 572

    assert(bdrv_drain_all_count > 0);
    bdrv_drain_all_count--;
573 574
}

575 576 577 578 579 580
void bdrv_drain_all(void)
{
    bdrv_drain_all_begin();
    bdrv_drain_all_end();
}

581 582 583 584 585 586 587 588
/**
 * Remove an active request from the tracked requests list
 *
 * This function should be called when a tracked request is completing.
 */
static void tracked_request_end(BdrvTrackedRequest *req)
{
    if (req->serialising) {
589
        atomic_dec(&req->bs->serialising_in_flight);
590 591
    }

592
    qemu_co_mutex_lock(&req->bs->reqs_lock);
593 594
    QLIST_REMOVE(req, list);
    qemu_co_queue_restart_all(&req->wait_queue);
595
    qemu_co_mutex_unlock(&req->bs->reqs_lock);
596 597 598 599 600 601 602 603
}

/**
 * Add an active request to the tracked requests list
 */
static void tracked_request_begin(BdrvTrackedRequest *req,
                                  BlockDriverState *bs,
                                  int64_t offset,
604 605
                                  unsigned int bytes,
                                  enum BdrvTrackedRequestType type)
606 607 608 609 610
{
    *req = (BdrvTrackedRequest){
        .bs = bs,
        .offset         = offset,
        .bytes          = bytes,
611
        .type           = type,
612 613 614 615 616 617 618 619
        .co             = qemu_coroutine_self(),
        .serialising    = false,
        .overlap_offset = offset,
        .overlap_bytes  = bytes,
    };

    qemu_co_queue_init(&req->wait_queue);

620
    qemu_co_mutex_lock(&bs->reqs_lock);
621
    QLIST_INSERT_HEAD(&bs->tracked_requests, req, list);
622
    qemu_co_mutex_unlock(&bs->reqs_lock);
623 624 625 626 627 628 629 630 631
}

static void mark_request_serialising(BdrvTrackedRequest *req, uint64_t align)
{
    int64_t overlap_offset = req->offset & ~(align - 1);
    unsigned int overlap_bytes = ROUND_UP(req->offset + req->bytes, align)
                               - overlap_offset;

    if (!req->serialising) {
632
        atomic_inc(&req->bs->serialising_in_flight);
633 634 635 636 637 638 639
        req->serialising = true;
    }

    req->overlap_offset = MIN(req->overlap_offset, overlap_offset);
    req->overlap_bytes = MAX(req->overlap_bytes, overlap_bytes);
}

640 641 642 643
/**
 * Round a region to cluster boundaries
 */
void bdrv_round_to_clusters(BlockDriverState *bs,
644
                            int64_t offset, int64_t bytes,
645
                            int64_t *cluster_offset,
646
                            int64_t *cluster_bytes)
647 648 649 650 651 652 653 654 655 656 657 658 659
{
    BlockDriverInfo bdi;

    if (bdrv_get_info(bs, &bdi) < 0 || bdi.cluster_size == 0) {
        *cluster_offset = offset;
        *cluster_bytes = bytes;
    } else {
        int64_t c = bdi.cluster_size;
        *cluster_offset = QEMU_ALIGN_DOWN(offset, c);
        *cluster_bytes = QEMU_ALIGN_UP(offset - *cluster_offset + bytes, c);
    }
}

660 661 662 663 664 665 666
static int bdrv_get_cluster_size(BlockDriverState *bs)
{
    BlockDriverInfo bdi;
    int ret;

    ret = bdrv_get_info(bs, &bdi);
    if (ret < 0 || bdi.cluster_size == 0) {
667
        return bs->bl.request_alignment;
668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686
    } else {
        return bdi.cluster_size;
    }
}

static bool tracked_request_overlaps(BdrvTrackedRequest *req,
                                     int64_t offset, unsigned int bytes)
{
    /*        aaaa   bbbb */
    if (offset >= req->overlap_offset + req->overlap_bytes) {
        return false;
    }
    /* bbbb   aaaa        */
    if (req->overlap_offset >= offset + bytes) {
        return false;
    }
    return true;
}

687 688 689 690 691
void bdrv_inc_in_flight(BlockDriverState *bs)
{
    atomic_inc(&bs->in_flight);
}

692 693
void bdrv_wakeup(BlockDriverState *bs)
{
694
    aio_wait_kick(bdrv_get_aio_wait(bs));
695
    aio_wait_kick(&drain_all_aio_wait);
696 697
}

698 699 700
void bdrv_dec_in_flight(BlockDriverState *bs)
{
    atomic_dec(&bs->in_flight);
701
    bdrv_wakeup(bs);
702 703
}

704 705 706 707 708 709 710
static bool coroutine_fn wait_serialising_requests(BdrvTrackedRequest *self)
{
    BlockDriverState *bs = self->bs;
    BdrvTrackedRequest *req;
    bool retry;
    bool waited = false;

711
    if (!atomic_read(&bs->serialising_in_flight)) {
712 713 714 715 716
        return false;
    }

    do {
        retry = false;
717
        qemu_co_mutex_lock(&bs->reqs_lock);
718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735
        QLIST_FOREACH(req, &bs->tracked_requests, list) {
            if (req == self || (!req->serialising && !self->serialising)) {
                continue;
            }
            if (tracked_request_overlaps(req, self->overlap_offset,
                                         self->overlap_bytes))
            {
                /* Hitting this means there was a reentrant request, for
                 * example, a block driver issuing nested requests.  This must
                 * never happen since it means deadlock.
                 */
                assert(qemu_coroutine_self() != req->co);

                /* If the request is already (indirectly) waiting for us, or
                 * will wait for us as soon as it wakes up, then just go on
                 * (instead of producing a deadlock in the former case). */
                if (!req->waiting_for) {
                    self->waiting_for = req;
736
                    qemu_co_queue_wait(&req->wait_queue, &bs->reqs_lock);
737 738 739 740 741 742 743
                    self->waiting_for = NULL;
                    retry = true;
                    waited = true;
                    break;
                }
            }
        }
744
        qemu_co_mutex_unlock(&bs->reqs_lock);
745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768
    } while (retry);

    return waited;
}

static int bdrv_check_byte_request(BlockDriverState *bs, int64_t offset,
                                   size_t size)
{
    if (size > BDRV_REQUEST_MAX_SECTORS << BDRV_SECTOR_BITS) {
        return -EIO;
    }

    if (!bdrv_is_inserted(bs)) {
        return -ENOMEDIUM;
    }

    if (offset < 0) {
        return -EIO;
    }

    return 0;
}

typedef struct RwCo {
769
    BdrvChild *child;
770 771 772 773 774 775 776 777 778 779 780 781
    int64_t offset;
    QEMUIOVector *qiov;
    bool is_write;
    int ret;
    BdrvRequestFlags flags;
} RwCo;

static void coroutine_fn bdrv_rw_co_entry(void *opaque)
{
    RwCo *rwco = opaque;

    if (!rwco->is_write) {
782
        rwco->ret = bdrv_co_preadv(rwco->child, rwco->offset,
783 784
                                   rwco->qiov->size, rwco->qiov,
                                   rwco->flags);
785
    } else {
786
        rwco->ret = bdrv_co_pwritev(rwco->child, rwco->offset,
787 788
                                    rwco->qiov->size, rwco->qiov,
                                    rwco->flags);
789 790 791 792 793 794
    }
}

/*
 * Process a vectored synchronous request using coroutines
 */
795
static int bdrv_prwv_co(BdrvChild *child, int64_t offset,
796 797 798 799 800
                        QEMUIOVector *qiov, bool is_write,
                        BdrvRequestFlags flags)
{
    Coroutine *co;
    RwCo rwco = {
801
        .child = child,
802 803 804 805 806 807 808 809 810 811 812
        .offset = offset,
        .qiov = qiov,
        .is_write = is_write,
        .ret = NOT_DONE,
        .flags = flags,
    };

    if (qemu_in_coroutine()) {
        /* Fast-path if already in coroutine context */
        bdrv_rw_co_entry(&rwco);
    } else {
813
        co = qemu_coroutine_create(bdrv_rw_co_entry, &rwco);
814
        bdrv_coroutine_enter(child->bs, co);
P
Paolo Bonzini 已提交
815
        BDRV_POLL_WHILE(child->bs, rwco.ret == NOT_DONE);
816 817 818 819 820 821 822
    }
    return rwco.ret;
}

/*
 * Process a synchronous request using coroutines
 */
823
static int bdrv_rw_co(BdrvChild *child, int64_t sector_num, uint8_t *buf,
824 825 826 827 828 829 830 831 832 833 834 835 836
                      int nb_sectors, bool is_write, BdrvRequestFlags flags)
{
    QEMUIOVector qiov;
    struct iovec iov = {
        .iov_base = (void *)buf,
        .iov_len = nb_sectors * BDRV_SECTOR_SIZE,
    };

    if (nb_sectors < 0 || nb_sectors > BDRV_REQUEST_MAX_SECTORS) {
        return -EINVAL;
    }

    qemu_iovec_init_external(&qiov, &iov, 1);
837
    return bdrv_prwv_co(child, sector_num << BDRV_SECTOR_BITS,
838 839 840 841
                        &qiov, is_write, flags);
}

/* return < 0 if error. See bdrv_write() for the return codes */
842
int bdrv_read(BdrvChild *child, int64_t sector_num,
843 844
              uint8_t *buf, int nb_sectors)
{
845
    return bdrv_rw_co(child, sector_num, buf, nb_sectors, false, 0);
846 847 848 849 850 851 852 853
}

/* Return < 0 if error. Important errors are:
  -EIO         generic I/O error (may happen for all errors)
  -ENOMEDIUM   No media inserted.
  -EINVAL      Invalid sector number or nb_sectors
  -EACCES      Trying to write a read-only device
*/
854
int bdrv_write(BdrvChild *child, int64_t sector_num,
855 856
               const uint8_t *buf, int nb_sectors)
{
857
    return bdrv_rw_co(child, sector_num, (uint8_t *)buf, nb_sectors, true, 0);
858 859
}

860
int bdrv_pwrite_zeroes(BdrvChild *child, int64_t offset,
861
                       int bytes, BdrvRequestFlags flags)
862
{
863 864 865
    QEMUIOVector qiov;
    struct iovec iov = {
        .iov_base = NULL,
866
        .iov_len = bytes,
867 868 869
    };

    qemu_iovec_init_external(&qiov, &iov, 1);
870
    return bdrv_prwv_co(child, offset, &qiov, true,
871
                        BDRV_REQ_ZERO_WRITE | flags);
872 873 874
}

/*
875
 * Completely zero out a block device with the help of bdrv_pwrite_zeroes.
876 877
 * The operation is sped up by checking the block status and only writing
 * zeroes to the device if they currently do not return zeroes. Optional
878
 * flags are passed through to bdrv_pwrite_zeroes (e.g. BDRV_REQ_MAY_UNMAP,
879
 * BDRV_REQ_FUA).
880 881 882
 *
 * Returns < 0 on error, 0 on success. For error codes see bdrv_write().
 */
883
int bdrv_make_zero(BdrvChild *child, BdrvRequestFlags flags)
884
{
885 886
    int ret;
    int64_t target_size, bytes, offset = 0;
887
    BlockDriverState *bs = child->bs;
888

889 890 891
    target_size = bdrv_getlength(bs);
    if (target_size < 0) {
        return target_size;
892 893 894
    }

    for (;;) {
895 896
        bytes = MIN(target_size - offset, BDRV_REQUEST_MAX_BYTES);
        if (bytes <= 0) {
897 898
            return 0;
        }
899
        ret = bdrv_block_status(bs, offset, bytes, &bytes, NULL, NULL);
900
        if (ret < 0) {
901 902
            error_report("error getting block status at offset %" PRId64 ": %s",
                         offset, strerror(-ret));
903 904 905
            return ret;
        }
        if (ret & BDRV_BLOCK_ZERO) {
906
            offset += bytes;
907 908
            continue;
        }
909
        ret = bdrv_pwrite_zeroes(child, offset, bytes, flags);
910
        if (ret < 0) {
911 912
            error_report("error writing zeroes at offset %" PRId64 ": %s",
                         offset, strerror(-ret));
913 914
            return ret;
        }
915
        offset += bytes;
916 917 918
    }
}

919
int bdrv_preadv(BdrvChild *child, int64_t offset, QEMUIOVector *qiov)
K
Kevin Wolf 已提交
920 921 922
{
    int ret;

923
    ret = bdrv_prwv_co(child, offset, qiov, false, 0);
K
Kevin Wolf 已提交
924 925 926 927 928 929 930
    if (ret < 0) {
        return ret;
    }

    return qiov->size;
}

931
int bdrv_pread(BdrvChild *child, int64_t offset, void *buf, int bytes)
932 933 934 935 936 937 938 939 940 941 942 943
{
    QEMUIOVector qiov;
    struct iovec iov = {
        .iov_base = (void *)buf,
        .iov_len = bytes,
    };

    if (bytes < 0) {
        return -EINVAL;
    }

    qemu_iovec_init_external(&qiov, &iov, 1);
944
    return bdrv_preadv(child, offset, &qiov);
945 946
}

947
int bdrv_pwritev(BdrvChild *child, int64_t offset, QEMUIOVector *qiov)
948 949 950
{
    int ret;

951
    ret = bdrv_prwv_co(child, offset, qiov, true, 0);
952 953 954 955 956 957 958
    if (ret < 0) {
        return ret;
    }

    return qiov->size;
}

959
int bdrv_pwrite(BdrvChild *child, int64_t offset, const void *buf, int bytes)
960 961 962 963 964 965 966 967 968 969 970 971
{
    QEMUIOVector qiov;
    struct iovec iov = {
        .iov_base   = (void *) buf,
        .iov_len    = bytes,
    };

    if (bytes < 0) {
        return -EINVAL;
    }

    qemu_iovec_init_external(&qiov, &iov, 1);
972
    return bdrv_pwritev(child, offset, &qiov);
973 974 975 976 977 978 979 980
}

/*
 * Writes to the file and ensures that no writes are reordered across this
 * request (acts as a barrier)
 *
 * Returns 0 on success, -errno in error cases.
 */
981 982
int bdrv_pwrite_sync(BdrvChild *child, int64_t offset,
                     const void *buf, int count)
983 984 985
{
    int ret;

986
    ret = bdrv_pwrite(child, offset, buf, count);
987 988 989 990
    if (ret < 0) {
        return ret;
    }

991
    ret = bdrv_flush(child->bs);
992 993
    if (ret < 0) {
        return ret;
994 995 996 997 998
    }

    return 0;
}

999 1000 1001 1002 1003 1004 1005 1006 1007 1008
typedef struct CoroutineIOCompletion {
    Coroutine *coroutine;
    int ret;
} CoroutineIOCompletion;

static void bdrv_co_io_em_complete(void *opaque, int ret)
{
    CoroutineIOCompletion *co = opaque;

    co->ret = ret;
1009
    aio_co_wake(co->coroutine);
1010 1011
}

1012 1013 1014 1015 1016
static int coroutine_fn bdrv_driver_preadv(BlockDriverState *bs,
                                           uint64_t offset, uint64_t bytes,
                                           QEMUIOVector *qiov, int flags)
{
    BlockDriver *drv = bs->drv;
1017 1018 1019
    int64_t sector_num;
    unsigned int nb_sectors;

1020 1021
    assert(!(flags & ~BDRV_REQ_MASK));

M
Max Reitz 已提交
1022 1023 1024 1025
    if (!drv) {
        return -ENOMEDIUM;
    }

1026 1027 1028 1029
    if (drv->bdrv_co_preadv) {
        return drv->bdrv_co_preadv(bs, offset, bytes, qiov, flags);
    }

1030
    if (drv->bdrv_aio_preadv) {
1031 1032 1033 1034 1035
        BlockAIOCB *acb;
        CoroutineIOCompletion co = {
            .coroutine = qemu_coroutine_self(),
        };

1036 1037
        acb = drv->bdrv_aio_preadv(bs, offset, bytes, qiov, flags,
                                   bdrv_co_io_em_complete, &co);
1038 1039 1040 1041 1042 1043 1044
        if (acb == NULL) {
            return -EIO;
        } else {
            qemu_coroutine_yield();
            return co.ret;
        }
    }
1045 1046 1047 1048 1049 1050 1051 1052 1053 1054

    sector_num = offset >> BDRV_SECTOR_BITS;
    nb_sectors = bytes >> BDRV_SECTOR_BITS;

    assert((offset & (BDRV_SECTOR_SIZE - 1)) == 0);
    assert((bytes & (BDRV_SECTOR_SIZE - 1)) == 0);
    assert((bytes >> BDRV_SECTOR_BITS) <= BDRV_REQUEST_MAX_SECTORS);
    assert(drv->bdrv_co_readv);

    return drv->bdrv_co_readv(bs, sector_num, nb_sectors, qiov);
1055 1056
}

1057 1058 1059 1060 1061
static int coroutine_fn bdrv_driver_pwritev(BlockDriverState *bs,
                                            uint64_t offset, uint64_t bytes,
                                            QEMUIOVector *qiov, int flags)
{
    BlockDriver *drv = bs->drv;
1062 1063
    int64_t sector_num;
    unsigned int nb_sectors;
1064 1065
    int ret;

1066 1067
    assert(!(flags & ~BDRV_REQ_MASK));

M
Max Reitz 已提交
1068 1069 1070 1071
    if (!drv) {
        return -ENOMEDIUM;
    }

1072
    if (drv->bdrv_co_pwritev) {
1073 1074 1075
        ret = drv->bdrv_co_pwritev(bs, offset, bytes, qiov,
                                   flags & bs->supported_write_flags);
        flags &= ~bs->supported_write_flags;
1076 1077 1078
        goto emulate_flags;
    }

1079
    if (drv->bdrv_aio_pwritev) {
1080 1081 1082 1083 1084
        BlockAIOCB *acb;
        CoroutineIOCompletion co = {
            .coroutine = qemu_coroutine_self(),
        };

1085 1086 1087 1088
        acb = drv->bdrv_aio_pwritev(bs, offset, bytes, qiov,
                                    flags & bs->supported_write_flags,
                                    bdrv_co_io_em_complete, &co);
        flags &= ~bs->supported_write_flags;
1089
        if (acb == NULL) {
1090
            ret = -EIO;
1091 1092
        } else {
            qemu_coroutine_yield();
1093
            ret = co.ret;
1094
        }
1095 1096 1097 1098 1099 1100 1101 1102 1103 1104
        goto emulate_flags;
    }

    sector_num = offset >> BDRV_SECTOR_BITS;
    nb_sectors = bytes >> BDRV_SECTOR_BITS;

    assert((offset & (BDRV_SECTOR_SIZE - 1)) == 0);
    assert((bytes & (BDRV_SECTOR_SIZE - 1)) == 0);
    assert((bytes >> BDRV_SECTOR_BITS) <= BDRV_REQUEST_MAX_SECTORS);

1105 1106 1107 1108
    assert(drv->bdrv_co_writev);
    ret = drv->bdrv_co_writev(bs, sector_num, nb_sectors, qiov,
                              flags & bs->supported_write_flags);
    flags &= ~bs->supported_write_flags;
1109

1110
emulate_flags:
1111
    if (ret == 0 && (flags & BDRV_REQ_FUA)) {
1112 1113 1114 1115 1116 1117
        ret = bdrv_co_flush(bs);
    }

    return ret;
}

1118 1119 1120 1121 1122 1123
static int coroutine_fn
bdrv_driver_pwritev_compressed(BlockDriverState *bs, uint64_t offset,
                               uint64_t bytes, QEMUIOVector *qiov)
{
    BlockDriver *drv = bs->drv;

M
Max Reitz 已提交
1124 1125 1126 1127
    if (!drv) {
        return -ENOMEDIUM;
    }

1128 1129 1130 1131 1132 1133 1134
    if (!drv->bdrv_co_pwritev_compressed) {
        return -ENOTSUP;
    }

    return drv->bdrv_co_pwritev_compressed(bs, offset, bytes, qiov);
}

1135
static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child,
1136
        int64_t offset, unsigned int bytes, QEMUIOVector *qiov)
1137
{
1138 1139
    BlockDriverState *bs = child->bs;

1140 1141 1142 1143 1144 1145 1146 1147 1148
    /* Perform I/O through a temporary buffer so that users who scribble over
     * their read buffer while the operation is in progress do not end up
     * modifying the image file.  This is critical for zero-copy guest I/O
     * where anything might happen inside guest memory.
     */
    void *bounce_buffer;

    BlockDriver *drv = bs->drv;
    struct iovec iov;
E
Eric Blake 已提交
1149
    QEMUIOVector local_qiov;
1150
    int64_t cluster_offset;
1151
    int64_t cluster_bytes;
1152 1153
    size_t skip_bytes;
    int ret;
E
Eric Blake 已提交
1154 1155 1156
    int max_transfer = MIN_NON_ZERO(bs->bl.max_transfer,
                                    BDRV_REQUEST_MAX_BYTES);
    unsigned int progress = 0;
1157

M
Max Reitz 已提交
1158 1159 1160 1161
    if (!drv) {
        return -ENOMEDIUM;
    }

1162 1163 1164
    /* FIXME We cannot require callers to have write permissions when all they
     * are doing is a read request. If we did things right, write permissions
     * would be obtained anyway, but internally by the copy-on-read code. As
E
Eric Blake 已提交
1165
     * long as it is implemented here rather than in a separate filter driver,
1166 1167 1168 1169
     * the copy-on-read code doesn't have its own BdrvChild, however, for which
     * it could request permissions. Therefore we have to bypass the permission
     * system for the moment. */
    // assert(child->perm & (BLK_PERM_WRITE_UNCHANGED | BLK_PERM_WRITE));
1170

1171
    /* Cover entire cluster so no additional backing file I/O is required when
E
Eric Blake 已提交
1172 1173 1174
     * allocating cluster in the image file.  Note that this value may exceed
     * BDRV_REQUEST_MAX_BYTES (even when the original read did not), which
     * is one reason we loop rather than doing it all at once.
1175
     */
1176
    bdrv_round_to_clusters(bs, offset, bytes, &cluster_offset, &cluster_bytes);
E
Eric Blake 已提交
1177
    skip_bytes = offset - cluster_offset;
1178

1179 1180
    trace_bdrv_co_do_copy_on_readv(bs, offset, bytes,
                                   cluster_offset, cluster_bytes);
1181

E
Eric Blake 已提交
1182 1183 1184
    bounce_buffer = qemu_try_blockalign(bs,
                                        MIN(MIN(max_transfer, cluster_bytes),
                                            MAX_BOUNCE_BUFFER));
1185 1186 1187 1188 1189
    if (bounce_buffer == NULL) {
        ret = -ENOMEM;
        goto err;
    }

E
Eric Blake 已提交
1190 1191
    while (cluster_bytes) {
        int64_t pnum;
1192

E
Eric Blake 已提交
1193 1194 1195 1196 1197 1198 1199 1200 1201
        ret = bdrv_is_allocated(bs, cluster_offset,
                                MIN(cluster_bytes, max_transfer), &pnum);
        if (ret < 0) {
            /* Safe to treat errors in querying allocation as if
             * unallocated; we'll probably fail again soon on the
             * read, but at least that will set a decent errno.
             */
            pnum = MIN(cluster_bytes, max_transfer);
        }
1202

E
Eric Blake 已提交
1203
        assert(skip_bytes < pnum);
1204

E
Eric Blake 已提交
1205 1206 1207 1208 1209
        if (ret <= 0) {
            /* Must copy-on-read; use the bounce buffer */
            iov.iov_base = bounce_buffer;
            iov.iov_len = pnum = MIN(pnum, MAX_BOUNCE_BUFFER);
            qemu_iovec_init_external(&local_qiov, &iov, 1);
1210

E
Eric Blake 已提交
1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222
            ret = bdrv_driver_preadv(bs, cluster_offset, pnum,
                                     &local_qiov, 0);
            if (ret < 0) {
                goto err;
            }

            bdrv_debug_event(bs, BLKDBG_COR_WRITE);
            if (drv->bdrv_co_pwrite_zeroes &&
                buffer_is_zero(bounce_buffer, pnum)) {
                /* FIXME: Should we (perhaps conditionally) be setting
                 * BDRV_REQ_MAY_UNMAP, if it will allow for a sparser copy
                 * that still correctly reads as zero? */
1223 1224
                ret = bdrv_co_do_pwrite_zeroes(bs, cluster_offset, pnum,
                                               BDRV_REQ_WRITE_UNCHANGED);
E
Eric Blake 已提交
1225 1226 1227 1228 1229
            } else {
                /* This does not change the data on the disk, it is not
                 * necessary to flush even in cache=writethrough mode.
                 */
                ret = bdrv_driver_pwritev(bs, cluster_offset, pnum,
1230 1231
                                          &local_qiov,
                                          BDRV_REQ_WRITE_UNCHANGED);
E
Eric Blake 已提交
1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262
            }

            if (ret < 0) {
                /* It might be okay to ignore write errors for guest
                 * requests.  If this is a deliberate copy-on-read
                 * then we don't want to ignore the error.  Simply
                 * report it in all cases.
                 */
                goto err;
            }

            qemu_iovec_from_buf(qiov, progress, bounce_buffer + skip_bytes,
                                pnum - skip_bytes);
        } else {
            /* Read directly into the destination */
            qemu_iovec_init(&local_qiov, qiov->niov);
            qemu_iovec_concat(&local_qiov, qiov, progress, pnum - skip_bytes);
            ret = bdrv_driver_preadv(bs, offset + progress, local_qiov.size,
                                     &local_qiov, 0);
            qemu_iovec_destroy(&local_qiov);
            if (ret < 0) {
                goto err;
            }
        }

        cluster_offset += pnum;
        cluster_bytes -= pnum;
        progress += pnum - skip_bytes;
        skip_bytes = 0;
    }
    ret = 0;
1263 1264 1265 1266 1267 1268 1269 1270

err:
    qemu_vfree(bounce_buffer);
    return ret;
}

/*
 * Forwards an already correctly aligned request to the BlockDriver. This
1271 1272
 * handles copy on read, zeroing after EOF, and fragmentation of large
 * reads; any other features must be implemented by the caller.
1273
 */
1274
static int coroutine_fn bdrv_aligned_preadv(BdrvChild *child,
1275 1276 1277
    BdrvTrackedRequest *req, int64_t offset, unsigned int bytes,
    int64_t align, QEMUIOVector *qiov, int flags)
{
1278
    BlockDriverState *bs = child->bs;
K
Kevin Wolf 已提交
1279
    int64_t total_bytes, max_bytes;
1280 1281 1282
    int ret = 0;
    uint64_t bytes_remaining = bytes;
    int max_transfer;
1283

1284 1285 1286
    assert(is_power_of_2(align));
    assert((offset & (align - 1)) == 0);
    assert((bytes & (align - 1)) == 0);
1287
    assert(!qiov || bytes == qiov->size);
1288
    assert((bs->open_flags & BDRV_O_NO_IO) == 0);
1289 1290
    max_transfer = QEMU_ALIGN_DOWN(MIN_NON_ZERO(bs->bl.max_transfer, INT_MAX),
                                   align);
1291 1292 1293 1294 1295 1296

    /* TODO: We would need a per-BDS .supported_read_flags and
     * potential fallback support, if we ever implement any read flags
     * to pass through to drivers.  For now, there aren't any
     * passthrough flags.  */
    assert(!(flags & ~(BDRV_REQ_NO_SERIALISING | BDRV_REQ_COPY_ON_READ)));
1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307

    /* Handle Copy on Read and associated serialisation */
    if (flags & BDRV_REQ_COPY_ON_READ) {
        /* If we touch the same cluster it counts as an overlap.  This
         * guarantees that allocating writes will be serialized and not race
         * with each other for the same cluster.  For example, in copy-on-read
         * it ensures that the CoR read and write operations are atomic and
         * guest writes cannot interleave between them. */
        mark_request_serialising(req, bdrv_get_cluster_size(bs));
    }

1308 1309 1310
    if (!(flags & BDRV_REQ_NO_SERIALISING)) {
        wait_serialising_requests(req);
    }
1311 1312

    if (flags & BDRV_REQ_COPY_ON_READ) {
1313
        int64_t pnum;
1314

1315
        ret = bdrv_is_allocated(bs, offset, bytes, &pnum);
1316 1317 1318 1319
        if (ret < 0) {
            goto out;
        }

1320
        if (!ret || pnum != bytes) {
1321
            ret = bdrv_co_do_copy_on_readv(child, offset, bytes, qiov);
1322 1323 1324 1325
            goto out;
        }
    }

1326
    /* Forward the request to the BlockDriver, possibly fragmenting it */
K
Kevin Wolf 已提交
1327 1328 1329 1330 1331
    total_bytes = bdrv_getlength(bs);
    if (total_bytes < 0) {
        ret = total_bytes;
        goto out;
    }
1332

K
Kevin Wolf 已提交
1333
    max_bytes = ROUND_UP(MAX(0, total_bytes - offset), align);
1334
    if (bytes <= max_bytes && bytes <= max_transfer) {
K
Kevin Wolf 已提交
1335
        ret = bdrv_driver_preadv(bs, offset, bytes, qiov, 0);
1336 1337
        goto out;
    }
1338

1339 1340
    while (bytes_remaining) {
        int num;
1341

1342 1343
        if (max_bytes) {
            QEMUIOVector local_qiov;
1344

1345 1346 1347 1348
            num = MIN(bytes_remaining, MIN(max_bytes, max_transfer));
            assert(num);
            qemu_iovec_init(&local_qiov, qiov->niov);
            qemu_iovec_concat(&local_qiov, qiov, bytes - bytes_remaining, num);
1349

1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362
            ret = bdrv_driver_preadv(bs, offset + bytes - bytes_remaining,
                                     num, &local_qiov, 0);
            max_bytes -= num;
            qemu_iovec_destroy(&local_qiov);
        } else {
            num = bytes_remaining;
            ret = qemu_iovec_memset(qiov, bytes - bytes_remaining, 0,
                                    bytes_remaining);
        }
        if (ret < 0) {
            goto out;
        }
        bytes_remaining -= num;
1363 1364 1365
    }

out:
1366
    return ret < 0 ? ret : 0;
1367 1368 1369 1370 1371
}

/*
 * Handle a read request in coroutine context
 */
1372
int coroutine_fn bdrv_co_preadv(BdrvChild *child,
1373 1374 1375
    int64_t offset, unsigned int bytes, QEMUIOVector *qiov,
    BdrvRequestFlags flags)
{
1376
    BlockDriverState *bs = child->bs;
1377 1378 1379
    BlockDriver *drv = bs->drv;
    BdrvTrackedRequest req;

1380
    uint64_t align = bs->bl.request_alignment;
1381 1382 1383 1384 1385 1386
    uint8_t *head_buf = NULL;
    uint8_t *tail_buf = NULL;
    QEMUIOVector local_qiov;
    bool use_local_qiov = false;
    int ret;

1387 1388
    trace_bdrv_co_preadv(child->bs, offset, bytes, flags);

1389 1390 1391 1392 1393 1394 1395 1396 1397
    if (!drv) {
        return -ENOMEDIUM;
    }

    ret = bdrv_check_byte_request(bs, offset, bytes);
    if (ret < 0) {
        return ret;
    }

1398 1399
    bdrv_inc_in_flight(bs);

1400
    /* Don't do copy-on-read if we read data before write operation */
1401
    if (atomic_read(&bs->copy_on_read) && !(flags & BDRV_REQ_NO_SERIALISING)) {
1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429
        flags |= BDRV_REQ_COPY_ON_READ;
    }

    /* Align read if necessary by padding qiov */
    if (offset & (align - 1)) {
        head_buf = qemu_blockalign(bs, align);
        qemu_iovec_init(&local_qiov, qiov->niov + 2);
        qemu_iovec_add(&local_qiov, head_buf, offset & (align - 1));
        qemu_iovec_concat(&local_qiov, qiov, 0, qiov->size);
        use_local_qiov = true;

        bytes += offset & (align - 1);
        offset = offset & ~(align - 1);
    }

    if ((offset + bytes) & (align - 1)) {
        if (!use_local_qiov) {
            qemu_iovec_init(&local_qiov, qiov->niov + 1);
            qemu_iovec_concat(&local_qiov, qiov, 0, qiov->size);
            use_local_qiov = true;
        }
        tail_buf = qemu_blockalign(bs, align);
        qemu_iovec_add(&local_qiov, tail_buf,
                       align - ((offset + bytes) & (align - 1)));

        bytes = ROUND_UP(bytes, align);
    }

1430
    tracked_request_begin(&req, bs, offset, bytes, BDRV_TRACKED_READ);
1431
    ret = bdrv_aligned_preadv(child, &req, offset, bytes, align,
1432 1433 1434
                              use_local_qiov ? &local_qiov : qiov,
                              flags);
    tracked_request_end(&req);
1435
    bdrv_dec_in_flight(bs);
1436 1437 1438 1439 1440 1441 1442 1443 1444 1445

    if (use_local_qiov) {
        qemu_iovec_destroy(&local_qiov);
        qemu_vfree(head_buf);
        qemu_vfree(tail_buf);
    }

    return ret;
}

E
Eric Blake 已提交
1446
static int coroutine_fn bdrv_co_do_pwrite_zeroes(BlockDriverState *bs,
1447
    int64_t offset, int bytes, BdrvRequestFlags flags)
1448 1449 1450 1451 1452
{
    BlockDriver *drv = bs->drv;
    QEMUIOVector qiov;
    struct iovec iov = {0};
    int ret = 0;
1453
    bool need_flush = false;
1454 1455
    int head = 0;
    int tail = 0;
1456

1457
    int max_write_zeroes = MIN_NON_ZERO(bs->bl.max_pwrite_zeroes, INT_MAX);
1458 1459
    int alignment = MAX(bs->bl.pwrite_zeroes_alignment,
                        bs->bl.request_alignment);
E
Eric Blake 已提交
1460
    int max_transfer = MIN_NON_ZERO(bs->bl.max_transfer, MAX_BOUNCE_BUFFER);
E
Eric Blake 已提交
1461

M
Max Reitz 已提交
1462 1463 1464 1465
    if (!drv) {
        return -ENOMEDIUM;
    }

1466 1467
    assert(alignment % bs->bl.request_alignment == 0);
    head = offset % alignment;
1468
    tail = (offset + bytes) % alignment;
1469 1470
    max_write_zeroes = QEMU_ALIGN_DOWN(max_write_zeroes, alignment);
    assert(max_write_zeroes >= bs->bl.request_alignment);
1471

1472 1473
    while (bytes > 0 && !ret) {
        int num = bytes;
1474 1475

        /* Align request.  Block drivers can expect the "bulk" of the request
1476 1477
         * to be aligned, and that unaligned requests do not cross cluster
         * boundaries.
1478
         */
1479
        if (head) {
1480 1481 1482
            /* Make a small request up to the first aligned sector. For
             * convenience, limit this request to max_transfer even if
             * we don't need to fall back to writes.  */
1483
            num = MIN(MIN(bytes, max_transfer), alignment - head);
1484 1485
            head = (head + num) % alignment;
            assert(num < max_write_zeroes);
E
Eric Blake 已提交
1486
        } else if (tail && num > alignment) {
1487 1488
            /* Shorten the request to the last aligned sector.  */
            num -= tail;
1489 1490 1491 1492 1493 1494 1495 1496 1497
        }

        /* limit request size */
        if (num > max_write_zeroes) {
            num = max_write_zeroes;
        }

        ret = -ENOTSUP;
        /* First try the efficient write zeroes operation */
E
Eric Blake 已提交
1498 1499 1500 1501 1502 1503 1504
        if (drv->bdrv_co_pwrite_zeroes) {
            ret = drv->bdrv_co_pwrite_zeroes(bs, offset, num,
                                             flags & bs->supported_zero_flags);
            if (ret != -ENOTSUP && (flags & BDRV_REQ_FUA) &&
                !(bs->supported_zero_flags & BDRV_REQ_FUA)) {
                need_flush = true;
            }
1505 1506
        } else {
            assert(!bs->supported_zero_flags);
1507 1508 1509 1510
        }

        if (ret == -ENOTSUP) {
            /* Fall back to bounce buffer if write zeroes is unsupported */
1511 1512 1513 1514 1515 1516 1517 1518 1519
            BdrvRequestFlags write_flags = flags & ~BDRV_REQ_ZERO_WRITE;

            if ((flags & BDRV_REQ_FUA) &&
                !(bs->supported_write_flags & BDRV_REQ_FUA)) {
                /* No need for bdrv_driver_pwrite() to do a fallback
                 * flush on each chunk; use just one at the end */
                write_flags &= ~BDRV_REQ_FUA;
                need_flush = true;
            }
1520
            num = MIN(num, max_transfer);
E
Eric Blake 已提交
1521
            iov.iov_len = num;
1522
            if (iov.iov_base == NULL) {
E
Eric Blake 已提交
1523
                iov.iov_base = qemu_try_blockalign(bs, num);
1524 1525 1526 1527
                if (iov.iov_base == NULL) {
                    ret = -ENOMEM;
                    goto fail;
                }
E
Eric Blake 已提交
1528
                memset(iov.iov_base, 0, num);
1529 1530 1531
            }
            qemu_iovec_init_external(&qiov, &iov, 1);

E
Eric Blake 已提交
1532
            ret = bdrv_driver_pwritev(bs, offset, num, &qiov, write_flags);
1533 1534 1535 1536

            /* Keep bounce buffer around if it is big enough for all
             * all future requests.
             */
1537
            if (num < max_transfer) {
1538 1539 1540 1541 1542
                qemu_vfree(iov.iov_base);
                iov.iov_base = NULL;
            }
        }

E
Eric Blake 已提交
1543
        offset += num;
1544
        bytes -= num;
1545 1546 1547
    }

fail:
1548 1549 1550
    if (ret == 0 && need_flush) {
        ret = bdrv_co_flush(bs);
    }
1551 1552 1553 1554 1555
    qemu_vfree(iov.iov_base);
    return ret;
}

/*
1556 1557
 * Forwards an already correctly aligned write request to the BlockDriver,
 * after possibly fragmenting it.
1558
 */
1559
static int coroutine_fn bdrv_aligned_pwritev(BdrvChild *child,
1560
    BdrvTrackedRequest *req, int64_t offset, unsigned int bytes,
1561
    int64_t align, QEMUIOVector *qiov, int flags)
1562
{
1563
    BlockDriverState *bs = child->bs;
1564 1565 1566 1567
    BlockDriver *drv = bs->drv;
    bool waited;
    int ret;

1568
    int64_t end_sector = DIV_ROUND_UP(offset + bytes, BDRV_SECTOR_SIZE);
1569 1570
    uint64_t bytes_remaining = bytes;
    int max_transfer;
1571

M
Max Reitz 已提交
1572 1573 1574 1575
    if (!drv) {
        return -ENOMEDIUM;
    }

1576 1577 1578 1579
    if (bdrv_has_readonly_bitmaps(bs)) {
        return -EPERM;
    }

1580 1581 1582
    assert(is_power_of_2(align));
    assert((offset & (align - 1)) == 0);
    assert((bytes & (align - 1)) == 0);
1583
    assert(!qiov || bytes == qiov->size);
1584
    assert((bs->open_flags & BDRV_O_NO_IO) == 0);
1585
    assert(!(flags & ~BDRV_REQ_MASK));
1586 1587
    max_transfer = QEMU_ALIGN_DOWN(MIN_NON_ZERO(bs->bl.max_transfer, INT_MAX),
                                   align);
1588 1589 1590 1591 1592

    waited = wait_serialising_requests(req);
    assert(!waited || !req->serialising);
    assert(req->overlap_offset <= offset);
    assert(offset + bytes <= req->overlap_offset + req->overlap_bytes);
1593 1594 1595 1596 1597
    if (flags & BDRV_REQ_WRITE_UNCHANGED) {
        assert(child->perm & (BLK_PERM_WRITE_UNCHANGED | BLK_PERM_WRITE));
    } else {
        assert(child->perm & BLK_PERM_WRITE);
    }
1598
    assert(end_sector <= bs->total_sectors || child->perm & BLK_PERM_RESIZE);
1599 1600 1601 1602

    ret = notifier_with_return_list_notify(&bs->before_write_notifiers, req);

    if (!ret && bs->detect_zeroes != BLOCKDEV_DETECT_ZEROES_OPTIONS_OFF &&
E
Eric Blake 已提交
1603
        !(flags & BDRV_REQ_ZERO_WRITE) && drv->bdrv_co_pwrite_zeroes &&
1604 1605 1606 1607 1608 1609 1610 1611 1612 1613
        qemu_iovec_is_zero(qiov)) {
        flags |= BDRV_REQ_ZERO_WRITE;
        if (bs->detect_zeroes == BLOCKDEV_DETECT_ZEROES_OPTIONS_UNMAP) {
            flags |= BDRV_REQ_MAY_UNMAP;
        }
    }

    if (ret < 0) {
        /* Do nothing, write notifier decided to fail this request */
    } else if (flags & BDRV_REQ_ZERO_WRITE) {
K
Kevin Wolf 已提交
1614
        bdrv_debug_event(bs, BLKDBG_PWRITEV_ZERO);
1615
        ret = bdrv_co_do_pwrite_zeroes(bs, offset, bytes, flags);
1616 1617
    } else if (flags & BDRV_REQ_WRITE_COMPRESSED) {
        ret = bdrv_driver_pwritev_compressed(bs, offset, bytes, qiov);
1618
    } else if (bytes <= max_transfer) {
K
Kevin Wolf 已提交
1619
        bdrv_debug_event(bs, BLKDBG_PWRITEV);
1620
        ret = bdrv_driver_pwritev(bs, offset, bytes, qiov, flags);
1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645
    } else {
        bdrv_debug_event(bs, BLKDBG_PWRITEV);
        while (bytes_remaining) {
            int num = MIN(bytes_remaining, max_transfer);
            QEMUIOVector local_qiov;
            int local_flags = flags;

            assert(num);
            if (num < bytes_remaining && (flags & BDRV_REQ_FUA) &&
                !(bs->supported_write_flags & BDRV_REQ_FUA)) {
                /* If FUA is going to be emulated by flush, we only
                 * need to flush on the last iteration */
                local_flags &= ~BDRV_REQ_FUA;
            }
            qemu_iovec_init(&local_qiov, qiov->niov);
            qemu_iovec_concat(&local_qiov, qiov, bytes - bytes_remaining, num);

            ret = bdrv_driver_pwritev(bs, offset + bytes - bytes_remaining,
                                      num, &local_qiov, local_flags);
            qemu_iovec_destroy(&local_qiov);
            if (ret < 0) {
                break;
            }
            bytes_remaining -= num;
        }
1646
    }
K
Kevin Wolf 已提交
1647
    bdrv_debug_event(bs, BLKDBG_PWRITEV_DONE);
1648

1649
    atomic_inc(&bs->write_gen);
1650
    bdrv_set_dirty(bs, offset, bytes);
1651

1652
    stat64_max(&bs->wr_highest_offset, offset + bytes);
1653 1654

    if (ret >= 0) {
1655
        bs->total_sectors = MAX(bs->total_sectors, end_sector);
1656
        ret = 0;
1657 1658 1659 1660 1661
    }

    return ret;
}

1662
static int coroutine_fn bdrv_co_do_zero_pwritev(BdrvChild *child,
1663 1664 1665 1666 1667
                                                int64_t offset,
                                                unsigned int bytes,
                                                BdrvRequestFlags flags,
                                                BdrvTrackedRequest *req)
{
1668
    BlockDriverState *bs = child->bs;
1669 1670 1671
    uint8_t *buf = NULL;
    QEMUIOVector local_qiov;
    struct iovec iov;
1672
    uint64_t align = bs->bl.request_alignment;
1673 1674 1675 1676
    unsigned int head_padding_bytes, tail_padding_bytes;
    int ret = 0;

    head_padding_bytes = offset & (align - 1);
1677
    tail_padding_bytes = (align - (offset + bytes)) & (align - 1);
1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694


    assert(flags & BDRV_REQ_ZERO_WRITE);
    if (head_padding_bytes || tail_padding_bytes) {
        buf = qemu_blockalign(bs, align);
        iov = (struct iovec) {
            .iov_base   = buf,
            .iov_len    = align,
        };
        qemu_iovec_init_external(&local_qiov, &iov, 1);
    }
    if (head_padding_bytes) {
        uint64_t zero_bytes = MIN(bytes, align - head_padding_bytes);

        /* RMW the unaligned part before head. */
        mark_request_serialising(req, align);
        wait_serialising_requests(req);
K
Kevin Wolf 已提交
1695
        bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_HEAD);
1696
        ret = bdrv_aligned_preadv(child, req, offset & ~(align - 1), align,
1697 1698 1699 1700
                                  align, &local_qiov, 0);
        if (ret < 0) {
            goto fail;
        }
K
Kevin Wolf 已提交
1701
        bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_HEAD);
1702 1703

        memset(buf + head_padding_bytes, 0, zero_bytes);
1704
        ret = bdrv_aligned_pwritev(child, req, offset & ~(align - 1), align,
1705
                                   align, &local_qiov,
1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717
                                   flags & ~BDRV_REQ_ZERO_WRITE);
        if (ret < 0) {
            goto fail;
        }
        offset += zero_bytes;
        bytes -= zero_bytes;
    }

    assert(!bytes || (offset & (align - 1)) == 0);
    if (bytes >= align) {
        /* Write the aligned part in the middle. */
        uint64_t aligned_bytes = bytes & ~(align - 1);
1718
        ret = bdrv_aligned_pwritev(child, req, offset, aligned_bytes, align,
1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732
                                   NULL, flags);
        if (ret < 0) {
            goto fail;
        }
        bytes -= aligned_bytes;
        offset += aligned_bytes;
    }

    assert(!bytes || (offset & (align - 1)) == 0);
    if (bytes) {
        assert(align == tail_padding_bytes + bytes);
        /* RMW the unaligned part after tail. */
        mark_request_serialising(req, align);
        wait_serialising_requests(req);
K
Kevin Wolf 已提交
1733
        bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_TAIL);
1734
        ret = bdrv_aligned_preadv(child, req, offset, align,
1735 1736 1737 1738
                                  align, &local_qiov, 0);
        if (ret < 0) {
            goto fail;
        }
K
Kevin Wolf 已提交
1739
        bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_TAIL);
1740 1741

        memset(buf, 0, bytes);
1742
        ret = bdrv_aligned_pwritev(child, req, offset, align, align,
1743 1744 1745 1746 1747 1748 1749 1750
                                   &local_qiov, flags & ~BDRV_REQ_ZERO_WRITE);
    }
fail:
    qemu_vfree(buf);
    return ret;

}

1751 1752 1753
/*
 * Handle a write request in coroutine context
 */
1754
int coroutine_fn bdrv_co_pwritev(BdrvChild *child,
1755 1756 1757
    int64_t offset, unsigned int bytes, QEMUIOVector *qiov,
    BdrvRequestFlags flags)
{
1758
    BlockDriverState *bs = child->bs;
1759
    BdrvTrackedRequest req;
1760
    uint64_t align = bs->bl.request_alignment;
1761 1762 1763 1764 1765 1766
    uint8_t *head_buf = NULL;
    uint8_t *tail_buf = NULL;
    QEMUIOVector local_qiov;
    bool use_local_qiov = false;
    int ret;

1767 1768
    trace_bdrv_co_pwritev(child->bs, offset, bytes, flags);

1769 1770 1771 1772
    if (!bs->drv) {
        return -ENOMEDIUM;
    }
    if (bs->read_only) {
1773
        return -EPERM;
1774
    }
1775
    assert(!(bs->open_flags & BDRV_O_INACTIVE));
1776 1777 1778 1779 1780 1781

    ret = bdrv_check_byte_request(bs, offset, bytes);
    if (ret < 0) {
        return ret;
    }

1782
    bdrv_inc_in_flight(bs);
1783 1784 1785 1786 1787
    /*
     * Align write if necessary by performing a read-modify-write cycle.
     * Pad qiov with the read parts and be sure to have a tracked request not
     * only for bdrv_aligned_pwritev, but also for the reads of the RMW cycle.
     */
1788
    tracked_request_begin(&req, bs, offset, bytes, BDRV_TRACKED_WRITE);
1789

1790
    if (flags & BDRV_REQ_ZERO_WRITE) {
1791
        ret = bdrv_co_do_zero_pwritev(child, offset, bytes, flags, &req);
1792 1793 1794
        goto out;
    }

1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808
    if (offset & (align - 1)) {
        QEMUIOVector head_qiov;
        struct iovec head_iov;

        mark_request_serialising(&req, align);
        wait_serialising_requests(&req);

        head_buf = qemu_blockalign(bs, align);
        head_iov = (struct iovec) {
            .iov_base   = head_buf,
            .iov_len    = align,
        };
        qemu_iovec_init_external(&head_qiov, &head_iov, 1);

K
Kevin Wolf 已提交
1809
        bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_HEAD);
1810
        ret = bdrv_aligned_preadv(child, &req, offset & ~(align - 1), align,
1811 1812 1813 1814
                                  align, &head_qiov, 0);
        if (ret < 0) {
            goto fail;
        }
K
Kevin Wolf 已提交
1815
        bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_HEAD);
1816 1817 1818 1819 1820 1821 1822 1823

        qemu_iovec_init(&local_qiov, qiov->niov + 2);
        qemu_iovec_add(&local_qiov, head_buf, offset & (align - 1));
        qemu_iovec_concat(&local_qiov, qiov, 0, qiov->size);
        use_local_qiov = true;

        bytes += offset & (align - 1);
        offset = offset & ~(align - 1);
1824 1825 1826 1827 1828 1829 1830 1831

        /* We have read the tail already if the request is smaller
         * than one aligned block.
         */
        if (bytes < align) {
            qemu_iovec_add(&local_qiov, head_buf + bytes, align - bytes);
            bytes = align;
        }
1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850
    }

    if ((offset + bytes) & (align - 1)) {
        QEMUIOVector tail_qiov;
        struct iovec tail_iov;
        size_t tail_bytes;
        bool waited;

        mark_request_serialising(&req, align);
        waited = wait_serialising_requests(&req);
        assert(!waited || !use_local_qiov);

        tail_buf = qemu_blockalign(bs, align);
        tail_iov = (struct iovec) {
            .iov_base   = tail_buf,
            .iov_len    = align,
        };
        qemu_iovec_init_external(&tail_qiov, &tail_iov, 1);

K
Kevin Wolf 已提交
1851
        bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_TAIL);
1852 1853
        ret = bdrv_aligned_preadv(child, &req, (offset + bytes) & ~(align - 1),
                                  align, align, &tail_qiov, 0);
1854 1855 1856
        if (ret < 0) {
            goto fail;
        }
K
Kevin Wolf 已提交
1857
        bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_TAIL);
1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870

        if (!use_local_qiov) {
            qemu_iovec_init(&local_qiov, qiov->niov + 1);
            qemu_iovec_concat(&local_qiov, qiov, 0, qiov->size);
            use_local_qiov = true;
        }

        tail_bytes = (offset + bytes) & (align - 1);
        qemu_iovec_add(&local_qiov, tail_buf + tail_bytes, align - tail_bytes);

        bytes = ROUND_UP(bytes, align);
    }

1871
    ret = bdrv_aligned_pwritev(child, &req, offset, bytes, align,
1872 1873
                               use_local_qiov ? &local_qiov : qiov,
                               flags);
1874 1875 1876 1877 1878 1879 1880 1881

fail:

    if (use_local_qiov) {
        qemu_iovec_destroy(&local_qiov);
    }
    qemu_vfree(head_buf);
    qemu_vfree(tail_buf);
1882 1883
out:
    tracked_request_end(&req);
1884
    bdrv_dec_in_flight(bs);
1885 1886 1887
    return ret;
}

1888
int coroutine_fn bdrv_co_pwrite_zeroes(BdrvChild *child, int64_t offset,
1889
                                       int bytes, BdrvRequestFlags flags)
1890
{
1891
    trace_bdrv_co_pwrite_zeroes(child->bs, offset, bytes, flags);
1892

1893
    if (!(child->bs->open_flags & BDRV_O_UNMAP)) {
1894 1895 1896
        flags &= ~BDRV_REQ_MAY_UNMAP;
    }

1897
    return bdrv_co_pwritev(child, offset, bytes, NULL,
1898
                           BDRV_REQ_ZERO_WRITE | flags);
1899 1900
}

J
John Snow 已提交
1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925
/*
 * Flush ALL BDSes regardless of if they are reachable via a BlkBackend or not.
 */
int bdrv_flush_all(void)
{
    BdrvNextIterator it;
    BlockDriverState *bs = NULL;
    int result = 0;

    for (bs = bdrv_first(&it); bs; bs = bdrv_next(&it)) {
        AioContext *aio_context = bdrv_get_aio_context(bs);
        int ret;

        aio_context_acquire(aio_context);
        ret = bdrv_flush(bs);
        if (ret < 0 && !result) {
            result = ret;
        }
        aio_context_release(aio_context);
    }

    return result;
}


1926
typedef struct BdrvCoBlockStatusData {
1927 1928
    BlockDriverState *bs;
    BlockDriverState *base;
1929
    bool want_zero;
1930 1931 1932 1933
    int64_t offset;
    int64_t bytes;
    int64_t *pnum;
    int64_t *map;
1934
    BlockDriverState **file;
1935
    int ret;
1936
    bool done;
1937
} BdrvCoBlockStatusData;
1938

1939 1940 1941 1942 1943 1944 1945
int coroutine_fn bdrv_co_block_status_from_file(BlockDriverState *bs,
                                                bool want_zero,
                                                int64_t offset,
                                                int64_t bytes,
                                                int64_t *pnum,
                                                int64_t *map,
                                                BlockDriverState **file)
1946 1947
{
    assert(bs->file && bs->file->bs);
1948 1949
    *pnum = bytes;
    *map = offset;
1950
    *file = bs->file->bs;
1951
    return BDRV_BLOCK_RAW | BDRV_BLOCK_OFFSET_VALID;
1952 1953
}

1954 1955 1956 1957 1958 1959 1960
int coroutine_fn bdrv_co_block_status_from_backing(BlockDriverState *bs,
                                                   bool want_zero,
                                                   int64_t offset,
                                                   int64_t bytes,
                                                   int64_t *pnum,
                                                   int64_t *map,
                                                   BlockDriverState **file)
1961 1962
{
    assert(bs->backing && bs->backing->bs);
1963 1964
    *pnum = bytes;
    *map = offset;
1965
    *file = bs->backing->bs;
1966
    return BDRV_BLOCK_RAW | BDRV_BLOCK_OFFSET_VALID;
1967 1968
}

1969 1970 1971 1972 1973
/*
 * Returns the allocation status of the specified sectors.
 * Drivers not implementing the functionality are assumed to not support
 * backing files, hence all their sectors are reported as allocated.
 *
1974 1975 1976 1977
 * If 'want_zero' is true, the caller is querying for mapping
 * purposes, with a focus on valid BDRV_BLOCK_OFFSET_VALID, _DATA, and
 * _ZERO where possible; otherwise, the result favors larger 'pnum',
 * with a focus on accurate BDRV_BLOCK_ALLOCATED.
1978
 *
1979
 * If 'offset' is beyond the end of the disk image the return value is
1980
 * BDRV_BLOCK_EOF and 'pnum' is set to 0.
1981
 *
1982
 * 'bytes' is the max value 'pnum' should be set to.  If bytes goes
1983 1984
 * beyond the end of the disk image it will be clamped; if 'pnum' is set to
 * the end of the image, then the returned value will include BDRV_BLOCK_EOF.
1985
 *
1986 1987 1988 1989 1990 1991 1992 1993 1994
 * 'pnum' is set to the number of bytes (including and immediately
 * following the specified offset) that are easily known to be in the
 * same allocated/unallocated state.  Note that a second call starting
 * at the original offset plus returned pnum may have the same status.
 * The returned value is non-zero on success except at end-of-file.
 *
 * Returns negative errno on failure.  Otherwise, if the
 * BDRV_BLOCK_OFFSET_VALID bit is set, 'map' and 'file' (if non-NULL) are
 * set to the host mapping and BDS corresponding to the guest offset.
1995
 */
1996 1997 1998 1999 2000 2001 2002 2003
static int coroutine_fn bdrv_co_block_status(BlockDriverState *bs,
                                             bool want_zero,
                                             int64_t offset, int64_t bytes,
                                             int64_t *pnum, int64_t *map,
                                             BlockDriverState **file)
{
    int64_t total_size;
    int64_t n; /* bytes */
E
Eric Blake 已提交
2004
    int ret;
2005
    int64_t local_map = 0;
2006
    BlockDriverState *local_file = NULL;
E
Eric Blake 已提交
2007 2008
    int64_t aligned_offset, aligned_bytes;
    uint32_t align;
2009

2010 2011
    assert(pnum);
    *pnum = 0;
2012 2013 2014
    total_size = bdrv_getlength(bs);
    if (total_size < 0) {
        ret = total_size;
2015
        goto early_out;
2016 2017
    }

2018
    if (offset >= total_size) {
2019 2020
        ret = BDRV_BLOCK_EOF;
        goto early_out;
2021
    }
2022
    if (!bytes) {
2023 2024
        ret = 0;
        goto early_out;
2025
    }
2026

2027 2028 2029
    n = total_size - offset;
    if (n < bytes) {
        bytes = n;
2030 2031
    }

M
Max Reitz 已提交
2032 2033
    /* Must be non-NULL or bdrv_getlength() would have failed */
    assert(bs->drv);
2034
    if (!bs->drv->bdrv_co_block_status) {
2035
        *pnum = bytes;
2036
        ret = BDRV_BLOCK_DATA | BDRV_BLOCK_ALLOCATED;
2037
        if (offset + bytes == total_size) {
2038 2039
            ret |= BDRV_BLOCK_EOF;
        }
2040
        if (bs->drv->protocol_name) {
2041 2042
            ret |= BDRV_BLOCK_OFFSET_VALID;
            local_map = offset;
2043
            local_file = bs;
2044
        }
2045
        goto early_out;
2046 2047
    }

2048
    bdrv_inc_in_flight(bs);
E
Eric Blake 已提交
2049 2050

    /* Round out to request_alignment boundaries */
2051
    align = bs->bl.request_alignment;
E
Eric Blake 已提交
2052 2053 2054
    aligned_offset = QEMU_ALIGN_DOWN(offset, align);
    aligned_bytes = ROUND_UP(offset + bytes, align) - aligned_offset;

2055 2056 2057 2058 2059 2060
    ret = bs->drv->bdrv_co_block_status(bs, want_zero, aligned_offset,
                                        aligned_bytes, pnum, &local_map,
                                        &local_file);
    if (ret < 0) {
        *pnum = 0;
        goto out;
E
Eric Blake 已提交
2061 2062
    }

2063
    /*
2064
     * The driver's result must be a non-zero multiple of request_alignment.
E
Eric Blake 已提交
2065
     * Clamp pnum and adjust map to original request.
2066
     */
2067 2068
    assert(*pnum && QEMU_IS_ALIGNED(*pnum, align) &&
           align > offset - aligned_offset);
E
Eric Blake 已提交
2069 2070 2071
    *pnum -= offset - aligned_offset;
    if (*pnum > bytes) {
        *pnum = bytes;
2072
    }
2073
    if (ret & BDRV_BLOCK_OFFSET_VALID) {
E
Eric Blake 已提交
2074
        local_map += offset - aligned_offset;
2075
    }
2076 2077

    if (ret & BDRV_BLOCK_RAW) {
2078
        assert(ret & BDRV_BLOCK_OFFSET_VALID && local_file);
2079 2080
        ret = bdrv_co_block_status(local_file, want_zero, local_map,
                                   *pnum, pnum, &local_map, &local_file);
2081
        goto out;
2082 2083 2084 2085
    }

    if (ret & (BDRV_BLOCK_DATA | BDRV_BLOCK_ZERO)) {
        ret |= BDRV_BLOCK_ALLOCATED;
2086
    } else if (want_zero) {
2087 2088
        if (bdrv_unallocated_blocks_are_zero(bs)) {
            ret |= BDRV_BLOCK_ZERO;
2089 2090
        } else if (bs->backing) {
            BlockDriverState *bs2 = bs->backing->bs;
2091
            int64_t size2 = bdrv_getlength(bs2);
2092

2093
            if (size2 >= 0 && offset >= size2) {
2094 2095 2096 2097 2098
                ret |= BDRV_BLOCK_ZERO;
            }
        }
    }

2099
    if (want_zero && local_file && local_file != bs &&
2100 2101
        (ret & BDRV_BLOCK_DATA) && !(ret & BDRV_BLOCK_ZERO) &&
        (ret & BDRV_BLOCK_OFFSET_VALID)) {
2102 2103
        int64_t file_pnum;
        int ret2;
2104

2105 2106
        ret2 = bdrv_co_block_status(local_file, want_zero, local_map,
                                    *pnum, &file_pnum, NULL, NULL);
2107 2108 2109 2110
        if (ret2 >= 0) {
            /* Ignore errors.  This is just providing extra information, it
             * is useful but not necessary.
             */
2111 2112 2113 2114 2115 2116 2117
            if (ret2 & BDRV_BLOCK_EOF &&
                (!file_pnum || ret2 & BDRV_BLOCK_ZERO)) {
                /*
                 * It is valid for the format block driver to read
                 * beyond the end of the underlying file's current
                 * size; such areas read as zero.
                 */
2118 2119 2120 2121 2122 2123 2124 2125 2126
                ret |= BDRV_BLOCK_ZERO;
            } else {
                /* Limit request to the range reported by the protocol driver */
                *pnum = file_pnum;
                ret |= (ret2 & BDRV_BLOCK_ZERO);
            }
        }
    }

2127 2128
out:
    bdrv_dec_in_flight(bs);
2129
    if (ret >= 0 && offset + *pnum == total_size) {
2130 2131
        ret |= BDRV_BLOCK_EOF;
    }
2132 2133 2134 2135
early_out:
    if (file) {
        *file = local_file;
    }
2136 2137 2138
    if (map) {
        *map = local_map;
    }
2139 2140 2141
    return ret;
}

2142 2143 2144 2145 2146 2147 2148 2149
static int coroutine_fn bdrv_co_block_status_above(BlockDriverState *bs,
                                                   BlockDriverState *base,
                                                   bool want_zero,
                                                   int64_t offset,
                                                   int64_t bytes,
                                                   int64_t *pnum,
                                                   int64_t *map,
                                                   BlockDriverState **file)
2150 2151
{
    BlockDriverState *p;
2152
    int ret = 0;
2153
    bool first = true;
2154 2155

    assert(bs != base);
2156
    for (p = bs; p != base; p = backing_bs(p)) {
2157 2158
        ret = bdrv_co_block_status(p, want_zero, offset, bytes, pnum, map,
                                   file);
2159 2160 2161 2162 2163 2164 2165 2166 2167 2168
        if (ret < 0) {
            break;
        }
        if (ret & BDRV_BLOCK_ZERO && ret & BDRV_BLOCK_EOF && !first) {
            /*
             * Reading beyond the end of the file continues to read
             * zeroes, but we can only widen the result to the
             * unallocated length we learned from an earlier
             * iteration.
             */
2169
            *pnum = bytes;
2170 2171
        }
        if (ret & (BDRV_BLOCK_ZERO | BDRV_BLOCK_DATA)) {
2172 2173
            break;
        }
2174 2175 2176
        /* [offset, pnum] unallocated on this layer, which could be only
         * the first part of [offset, bytes].  */
        bytes = MIN(bytes, *pnum);
2177
        first = false;
2178 2179 2180 2181
    }
    return ret;
}

2182
/* Coroutine wrapper for bdrv_block_status_above() */
2183
static void coroutine_fn bdrv_block_status_above_co_entry(void *opaque)
2184
{
2185
    BdrvCoBlockStatusData *data = opaque;
2186

2187 2188 2189 2190
    data->ret = bdrv_co_block_status_above(data->bs, data->base,
                                           data->want_zero,
                                           data->offset, data->bytes,
                                           data->pnum, data->map, data->file);
2191 2192 2193 2194
    data->done = true;
}

/*
2195
 * Synchronous wrapper around bdrv_co_block_status_above().
2196
 *
2197
 * See bdrv_co_block_status_above() for details.
2198
 */
2199 2200 2201 2202 2203 2204
static int bdrv_common_block_status_above(BlockDriverState *bs,
                                          BlockDriverState *base,
                                          bool want_zero, int64_t offset,
                                          int64_t bytes, int64_t *pnum,
                                          int64_t *map,
                                          BlockDriverState **file)
2205 2206
{
    Coroutine *co;
2207
    BdrvCoBlockStatusData data = {
2208
        .bs = bs,
2209
        .base = base,
2210
        .want_zero = want_zero,
2211 2212 2213 2214
        .offset = offset,
        .bytes = bytes,
        .pnum = pnum,
        .map = map,
2215
        .file = file,
2216 2217 2218 2219 2220
        .done = false,
    };

    if (qemu_in_coroutine()) {
        /* Fast-path if already in coroutine context */
2221
        bdrv_block_status_above_co_entry(&data);
2222
    } else {
2223
        co = qemu_coroutine_create(bdrv_block_status_above_co_entry, &data);
2224
        bdrv_coroutine_enter(bs, co);
P
Paolo Bonzini 已提交
2225
        BDRV_POLL_WHILE(bs, !data.done);
2226
    }
2227
    return data.ret;
2228 2229
}

2230 2231 2232
int bdrv_block_status_above(BlockDriverState *bs, BlockDriverState *base,
                            int64_t offset, int64_t bytes, int64_t *pnum,
                            int64_t *map, BlockDriverState **file)
2233
{
2234 2235
    return bdrv_common_block_status_above(bs, base, true, offset, bytes,
                                          pnum, map, file);
2236 2237
}

2238 2239
int bdrv_block_status(BlockDriverState *bs, int64_t offset, int64_t bytes,
                      int64_t *pnum, int64_t *map, BlockDriverState **file)
2240
{
2241 2242
    return bdrv_block_status_above(bs, backing_bs(bs),
                                   offset, bytes, pnum, map, file);
2243 2244
}

2245 2246
int coroutine_fn bdrv_is_allocated(BlockDriverState *bs, int64_t offset,
                                   int64_t bytes, int64_t *pnum)
2247
{
2248 2249
    int ret;
    int64_t dummy;
2250

2251 2252
    ret = bdrv_common_block_status_above(bs, backing_bs(bs), false, offset,
                                         bytes, pnum ? pnum : &dummy, NULL,
2253
                                         NULL);
2254 2255 2256 2257 2258 2259 2260 2261 2262
    if (ret < 0) {
        return ret;
    }
    return !!(ret & BDRV_BLOCK_ALLOCATED);
}

/*
 * Given an image chain: ... -> [BASE] -> [INTER1] -> [INTER2] -> [TOP]
 *
2263 2264 2265
 * Return true if (a prefix of) the given range is allocated in any image
 * between BASE and TOP (inclusive).  BASE can be NULL to check if the given
 * offset is allocated in any image of the chain.  Return false otherwise,
2266
 * or negative errno on failure.
2267
 *
2268 2269 2270 2271 2272 2273
 * 'pnum' is set to the number of bytes (including and immediately
 * following the specified offset) that are known to be in the same
 * allocated/unallocated state.  Note that a subsequent call starting
 * at 'offset + *pnum' may return the same allocation status (in other
 * words, the result is not necessarily the maximum possible range);
 * but 'pnum' will only be 0 when end of file is reached.
2274 2275 2276 2277
 *
 */
int bdrv_is_allocated_above(BlockDriverState *top,
                            BlockDriverState *base,
2278
                            int64_t offset, int64_t bytes, int64_t *pnum)
2279 2280
{
    BlockDriverState *intermediate;
2281 2282
    int ret;
    int64_t n = bytes;
2283 2284 2285

    intermediate = top;
    while (intermediate && intermediate != base) {
2286
        int64_t pnum_inter;
2287
        int64_t size_inter;
2288

2289
        ret = bdrv_is_allocated(intermediate, offset, bytes, &pnum_inter);
2290 2291
        if (ret < 0) {
            return ret;
2292 2293
        }
        if (ret) {
2294
            *pnum = pnum_inter;
2295 2296 2297
            return 1;
        }

2298
        size_inter = bdrv_getlength(intermediate);
2299 2300 2301
        if (size_inter < 0) {
            return size_inter;
        }
2302 2303 2304
        if (n > pnum_inter &&
            (intermediate == top || offset + pnum_inter < size_inter)) {
            n = pnum_inter;
2305 2306
        }

2307
        intermediate = backing_bs(intermediate);
2308 2309 2310 2311 2312 2313
    }

    *pnum = n;
    return 0;
}

2314 2315 2316 2317 2318 2319 2320 2321 2322 2323 2324 2325 2326
typedef struct BdrvVmstateCo {
    BlockDriverState    *bs;
    QEMUIOVector        *qiov;
    int64_t             pos;
    bool                is_read;
    int                 ret;
} BdrvVmstateCo;

static int coroutine_fn
bdrv_co_rw_vmstate(BlockDriverState *bs, QEMUIOVector *qiov, int64_t pos,
                   bool is_read)
{
    BlockDriver *drv = bs->drv;
2327 2328 2329
    int ret = -ENOTSUP;

    bdrv_inc_in_flight(bs);
2330 2331

    if (!drv) {
2332
        ret = -ENOMEDIUM;
2333
    } else if (drv->bdrv_load_vmstate) {
2334 2335 2336 2337 2338
        if (is_read) {
            ret = drv->bdrv_load_vmstate(bs, qiov, pos);
        } else {
            ret = drv->bdrv_save_vmstate(bs, qiov, pos);
        }
2339
    } else if (bs->file) {
2340
        ret = bdrv_co_rw_vmstate(bs->file->bs, qiov, pos, is_read);
2341 2342
    }

2343 2344
    bdrv_dec_in_flight(bs);
    return ret;
2345 2346 2347 2348 2349 2350 2351 2352 2353 2354 2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 2365 2366
}

static void coroutine_fn bdrv_co_rw_vmstate_entry(void *opaque)
{
    BdrvVmstateCo *co = opaque;
    co->ret = bdrv_co_rw_vmstate(co->bs, co->qiov, co->pos, co->is_read);
}

static inline int
bdrv_rw_vmstate(BlockDriverState *bs, QEMUIOVector *qiov, int64_t pos,
                bool is_read)
{
    if (qemu_in_coroutine()) {
        return bdrv_co_rw_vmstate(bs, qiov, pos, is_read);
    } else {
        BdrvVmstateCo data = {
            .bs         = bs,
            .qiov       = qiov,
            .pos        = pos,
            .is_read    = is_read,
            .ret        = -EINPROGRESS,
        };
2367
        Coroutine *co = qemu_coroutine_create(bdrv_co_rw_vmstate_entry, &data);
2368

2369
        bdrv_coroutine_enter(bs, co);
2370
        BDRV_POLL_WHILE(bs, data.ret == -EINPROGRESS);
2371 2372 2373 2374
        return data.ret;
    }
}

2375 2376 2377 2378 2379 2380 2381 2382
int bdrv_save_vmstate(BlockDriverState *bs, const uint8_t *buf,
                      int64_t pos, int size)
{
    QEMUIOVector qiov;
    struct iovec iov = {
        .iov_base   = (void *) buf,
        .iov_len    = size,
    };
2383
    int ret;
2384 2385

    qemu_iovec_init_external(&qiov, &iov, 1);
2386 2387 2388 2389 2390 2391 2392

    ret = bdrv_writev_vmstate(bs, &qiov, pos);
    if (ret < 0) {
        return ret;
    }

    return size;
2393 2394 2395 2396
}

int bdrv_writev_vmstate(BlockDriverState *bs, QEMUIOVector *qiov, int64_t pos)
{
2397
    return bdrv_rw_vmstate(bs, qiov, pos, false);
2398 2399 2400 2401
}

int bdrv_load_vmstate(BlockDriverState *bs, uint8_t *buf,
                      int64_t pos, int size)
2402 2403 2404 2405 2406 2407
{
    QEMUIOVector qiov;
    struct iovec iov = {
        .iov_base   = buf,
        .iov_len    = size,
    };
2408
    int ret;
2409 2410

    qemu_iovec_init_external(&qiov, &iov, 1);
2411 2412 2413 2414 2415 2416
    ret = bdrv_readv_vmstate(bs, &qiov, pos);
    if (ret < 0) {
        return ret;
    }

    return size;
2417 2418 2419
}

int bdrv_readv_vmstate(BlockDriverState *bs, QEMUIOVector *qiov, int64_t pos)
2420
{
2421
    return bdrv_rw_vmstate(bs, qiov, pos, true);
2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434
}

/**************************************************************/
/* async I/Os */

void bdrv_aio_cancel(BlockAIOCB *acb)
{
    qemu_aio_ref(acb);
    bdrv_aio_cancel_async(acb);
    while (acb->refcnt > 1) {
        if (acb->aiocb_info->get_aio_context) {
            aio_poll(acb->aiocb_info->get_aio_context(acb), true);
        } else if (acb->bs) {
2435 2436 2437 2438 2439
            /* qemu_aio_ref and qemu_aio_unref are not thread-safe, so
             * assert that we're not using an I/O thread.  Thread-safe
             * code should use bdrv_aio_cancel_async exclusively.
             */
            assert(bdrv_get_aio_context(acb->bs) == qemu_get_aio_context());
2440 2441 2442 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460
            aio_poll(bdrv_get_aio_context(acb->bs), true);
        } else {
            abort();
        }
    }
    qemu_aio_unref(acb);
}

/* Async version of aio cancel. The caller is not blocked if the acb implements
 * cancel_async, otherwise we do nothing and let the request normally complete.
 * In either case the completion callback must be called. */
void bdrv_aio_cancel_async(BlockAIOCB *acb)
{
    if (acb->aiocb_info->cancel_async) {
        acb->aiocb_info->cancel_async(acb);
    }
}

/**************************************************************/
/* Coroutine block device emulation */

2461 2462 2463 2464 2465 2466
typedef struct FlushCo {
    BlockDriverState *bs;
    int ret;
} FlushCo;


2467 2468
static void coroutine_fn bdrv_flush_co_entry(void *opaque)
{
2469
    FlushCo *rwco = opaque;
2470 2471 2472 2473 2474 2475

    rwco->ret = bdrv_co_flush(rwco->bs);
}

int coroutine_fn bdrv_co_flush(BlockDriverState *bs)
{
2476 2477 2478 2479
    int current_gen;
    int ret = 0;

    bdrv_inc_in_flight(bs);
2480

2481
    if (!bdrv_is_inserted(bs) || bdrv_is_read_only(bs) ||
2482
        bdrv_is_sg(bs)) {
2483
        goto early_exit;
2484 2485
    }

2486
    qemu_co_mutex_lock(&bs->reqs_lock);
2487
    current_gen = atomic_read(&bs->write_gen);
2488 2489

    /* Wait until any previous flushes are completed */
2490
    while (bs->active_flush_req) {
2491
        qemu_co_queue_wait(&bs->flush_queue, &bs->reqs_lock);
2492 2493
    }

2494
    /* Flushes reach this point in nondecreasing current_gen order.  */
2495
    bs->active_flush_req = true;
2496
    qemu_co_mutex_unlock(&bs->reqs_lock);
2497

P
Pavel Dovgalyuk 已提交
2498 2499 2500 2501 2502 2503
    /* Write back all layers by calling one driver function */
    if (bs->drv->bdrv_co_flush) {
        ret = bs->drv->bdrv_co_flush(bs);
        goto out;
    }

2504 2505 2506 2507 2508
    /* Write back cached data to the OS even with cache=unsafe */
    BLKDBG_EVENT(bs->file, BLKDBG_FLUSH_TO_OS);
    if (bs->drv->bdrv_co_flush_to_os) {
        ret = bs->drv->bdrv_co_flush_to_os(bs);
        if (ret < 0) {
F
Fam Zheng 已提交
2509
            goto out;
2510 2511 2512 2513 2514 2515 2516 2517
        }
    }

    /* But don't actually force it to the disk with cache=unsafe */
    if (bs->open_flags & BDRV_O_NO_FLUSH) {
        goto flush_parent;
    }

2518 2519 2520 2521 2522
    /* Check if we really need to flush anything */
    if (bs->flushed_gen == current_gen) {
        goto flush_parent;
    }

2523
    BLKDBG_EVENT(bs->file, BLKDBG_FLUSH_TO_DISK);
M
Max Reitz 已提交
2524 2525 2526 2527 2528 2529
    if (!bs->drv) {
        /* bs->drv->bdrv_co_flush() might have ejected the BDS
         * (even in case of apparent success) */
        ret = -ENOMEDIUM;
        goto out;
    }
2530 2531 2532 2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549 2550 2551 2552 2553 2554 2555 2556 2557 2558
    if (bs->drv->bdrv_co_flush_to_disk) {
        ret = bs->drv->bdrv_co_flush_to_disk(bs);
    } else if (bs->drv->bdrv_aio_flush) {
        BlockAIOCB *acb;
        CoroutineIOCompletion co = {
            .coroutine = qemu_coroutine_self(),
        };

        acb = bs->drv->bdrv_aio_flush(bs, bdrv_co_io_em_complete, &co);
        if (acb == NULL) {
            ret = -EIO;
        } else {
            qemu_coroutine_yield();
            ret = co.ret;
        }
    } else {
        /*
         * Some block drivers always operate in either writethrough or unsafe
         * mode and don't support bdrv_flush therefore. Usually qemu doesn't
         * know how the server works (because the behaviour is hardcoded or
         * depends on server-side configuration), so we can't ensure that
         * everything is safe on disk. Returning an error doesn't work because
         * that would break guests even if the server operates in writethrough
         * mode.
         *
         * Let's hope the user knows what he's doing.
         */
        ret = 0;
    }
2559

2560
    if (ret < 0) {
F
Fam Zheng 已提交
2561
        goto out;
2562 2563 2564 2565 2566 2567
    }

    /* Now flush the underlying protocol.  It will also have BDRV_O_NO_FLUSH
     * in the case of cache=unsafe, so there are no useless flushes.
     */
flush_parent:
F
Fam Zheng 已提交
2568 2569
    ret = bs->file ? bdrv_co_flush(bs->file->bs) : 0;
out:
2570
    /* Notify any pending flushes that we have completed */
2571 2572 2573
    if (ret == 0) {
        bs->flushed_gen = current_gen;
    }
2574 2575

    qemu_co_mutex_lock(&bs->reqs_lock);
2576
    bs->active_flush_req = false;
2577 2578
    /* Return value is ignored - it's ok if wait queue is empty */
    qemu_co_queue_next(&bs->flush_queue);
2579
    qemu_co_mutex_unlock(&bs->reqs_lock);
2580

2581
early_exit:
2582
    bdrv_dec_in_flight(bs);
F
Fam Zheng 已提交
2583
    return ret;
2584 2585 2586 2587 2588
}

int bdrv_flush(BlockDriverState *bs)
{
    Coroutine *co;
2589
    FlushCo flush_co = {
2590 2591 2592 2593 2594 2595
        .bs = bs,
        .ret = NOT_DONE,
    };

    if (qemu_in_coroutine()) {
        /* Fast-path if already in coroutine context */
2596
        bdrv_flush_co_entry(&flush_co);
2597
    } else {
2598
        co = qemu_coroutine_create(bdrv_flush_co_entry, &flush_co);
2599
        bdrv_coroutine_enter(bs, co);
P
Paolo Bonzini 已提交
2600
        BDRV_POLL_WHILE(bs, flush_co.ret == NOT_DONE);
2601 2602
    }

2603
    return flush_co.ret;
2604 2605 2606 2607
}

typedef struct DiscardCo {
    BlockDriverState *bs;
2608
    int64_t offset;
2609
    int bytes;
2610 2611
    int ret;
} DiscardCo;
2612
static void coroutine_fn bdrv_pdiscard_co_entry(void *opaque)
2613 2614 2615
{
    DiscardCo *rwco = opaque;

2616
    rwco->ret = bdrv_co_pdiscard(rwco->bs, rwco->offset, rwco->bytes);
2617 2618
}

2619
int coroutine_fn bdrv_co_pdiscard(BlockDriverState *bs, int64_t offset,
2620
                                  int bytes)
2621
{
F
Fam Zheng 已提交
2622
    BdrvTrackedRequest req;
2623
    int max_pdiscard, ret;
2624
    int head, tail, align;
2625 2626 2627 2628 2629

    if (!bs->drv) {
        return -ENOMEDIUM;
    }

2630 2631 2632 2633
    if (bdrv_has_readonly_bitmaps(bs)) {
        return -EPERM;
    }

2634
    ret = bdrv_check_byte_request(bs, offset, bytes);
2635 2636 2637
    if (ret < 0) {
        return ret;
    } else if (bs->read_only) {
2638
        return -EPERM;
2639
    }
2640
    assert(!(bs->open_flags & BDRV_O_INACTIVE));
2641 2642 2643 2644 2645 2646

    /* Do nothing if disabled.  */
    if (!(bs->open_flags & BDRV_O_UNMAP)) {
        return 0;
    }

E
Eric Blake 已提交
2647
    if (!bs->drv->bdrv_co_pdiscard && !bs->drv->bdrv_aio_pdiscard) {
2648 2649 2650
        return 0;
    }

2651 2652 2653 2654 2655
    /* Discard is advisory, but some devices track and coalesce
     * unaligned requests, so we must pass everything down rather than
     * round here.  Still, most devices will just silently ignore
     * unaligned requests (by returning -ENOTSUP), so we must fragment
     * the request accordingly.  */
E
Eric Blake 已提交
2656
    align = MAX(bs->bl.pdiscard_alignment, bs->bl.request_alignment);
2657 2658
    assert(align % bs->bl.request_alignment == 0);
    head = offset % align;
2659
    tail = (offset + bytes) % align;
2660

2661
    bdrv_inc_in_flight(bs);
2662
    tracked_request_begin(&req, bs, offset, bytes, BDRV_TRACKED_DISCARD);
2663

2664 2665 2666 2667 2668
    ret = notifier_with_return_list_notify(&bs->before_write_notifiers, &req);
    if (ret < 0) {
        goto out;
    }

2669 2670
    max_pdiscard = QEMU_ALIGN_DOWN(MIN_NON_ZERO(bs->bl.max_pdiscard, INT_MAX),
                                   align);
2671
    assert(max_pdiscard >= bs->bl.request_alignment);
2672

2673 2674
    while (bytes > 0) {
        int num = bytes;
2675 2676 2677

        if (head) {
            /* Make small requests to get to alignment boundaries. */
2678
            num = MIN(bytes, align - head);
2679 2680 2681 2682 2683 2684 2685 2686 2687 2688 2689 2690 2691 2692 2693 2694 2695 2696 2697
            if (!QEMU_IS_ALIGNED(num, bs->bl.request_alignment)) {
                num %= bs->bl.request_alignment;
            }
            head = (head + num) % align;
            assert(num < max_pdiscard);
        } else if (tail) {
            if (num > align) {
                /* Shorten the request to the last aligned cluster.  */
                num -= tail;
            } else if (!QEMU_IS_ALIGNED(tail, bs->bl.request_alignment) &&
                       tail > bs->bl.request_alignment) {
                tail %= bs->bl.request_alignment;
                num -= tail;
            }
        }
        /* limit request size */
        if (num > max_pdiscard) {
            num = max_pdiscard;
        }
2698

M
Max Reitz 已提交
2699 2700 2701 2702
        if (!bs->drv) {
            ret = -ENOMEDIUM;
            goto out;
        }
2703 2704
        if (bs->drv->bdrv_co_pdiscard) {
            ret = bs->drv->bdrv_co_pdiscard(bs, offset, num);
2705 2706 2707 2708 2709 2710
        } else {
            BlockAIOCB *acb;
            CoroutineIOCompletion co = {
                .coroutine = qemu_coroutine_self(),
            };

2711 2712
            acb = bs->drv->bdrv_aio_pdiscard(bs, offset, num,
                                             bdrv_co_io_em_complete, &co);
2713
            if (acb == NULL) {
F
Fam Zheng 已提交
2714 2715
                ret = -EIO;
                goto out;
2716 2717 2718 2719 2720 2721
            } else {
                qemu_coroutine_yield();
                ret = co.ret;
            }
        }
        if (ret && ret != -ENOTSUP) {
F
Fam Zheng 已提交
2722
            goto out;
2723 2724
        }

2725
        offset += num;
2726
        bytes -= num;
2727
    }
F
Fam Zheng 已提交
2728 2729
    ret = 0;
out:
2730
    atomic_inc(&bs->write_gen);
2731
    bdrv_set_dirty(bs, req.offset, req.bytes);
F
Fam Zheng 已提交
2732
    tracked_request_end(&req);
2733
    bdrv_dec_in_flight(bs);
F
Fam Zheng 已提交
2734
    return ret;
2735 2736
}

2737
int bdrv_pdiscard(BlockDriverState *bs, int64_t offset, int bytes)
2738 2739 2740 2741
{
    Coroutine *co;
    DiscardCo rwco = {
        .bs = bs,
2742
        .offset = offset,
2743
        .bytes = bytes,
2744 2745 2746 2747 2748
        .ret = NOT_DONE,
    };

    if (qemu_in_coroutine()) {
        /* Fast-path if already in coroutine context */
2749
        bdrv_pdiscard_co_entry(&rwco);
2750
    } else {
2751
        co = qemu_coroutine_create(bdrv_pdiscard_co_entry, &rwco);
2752
        bdrv_coroutine_enter(bs, co);
P
Paolo Bonzini 已提交
2753
        BDRV_POLL_WHILE(bs, rwco.ret == NOT_DONE);
2754 2755 2756 2757 2758
    }

    return rwco.ret;
}

2759
int bdrv_co_ioctl(BlockDriverState *bs, int req, void *buf)
2760 2761
{
    BlockDriver *drv = bs->drv;
2762 2763 2764 2765
    CoroutineIOCompletion co = {
        .coroutine = qemu_coroutine_self(),
    };
    BlockAIOCB *acb;
2766

2767
    bdrv_inc_in_flight(bs);
2768
    if (!drv || (!drv->bdrv_aio_ioctl && !drv->bdrv_co_ioctl)) {
2769 2770 2771 2772
        co.ret = -ENOTSUP;
        goto out;
    }

2773 2774 2775 2776 2777 2778 2779 2780 2781
    if (drv->bdrv_co_ioctl) {
        co.ret = drv->bdrv_co_ioctl(bs, req, buf);
    } else {
        acb = drv->bdrv_aio_ioctl(bs, req, buf, bdrv_co_io_em_complete, &co);
        if (!acb) {
            co.ret = -ENOTSUP;
            goto out;
        }
        qemu_coroutine_yield();
2782 2783
    }
out:
2784
    bdrv_dec_in_flight(bs);
2785 2786 2787
    return co.ret;
}

2788 2789 2790 2791 2792 2793 2794 2795 2796 2797 2798 2799 2800 2801 2802 2803 2804 2805 2806 2807 2808 2809 2810 2811 2812 2813 2814 2815 2816 2817 2818 2819 2820 2821 2822 2823 2824 2825 2826 2827
void *qemu_blockalign(BlockDriverState *bs, size_t size)
{
    return qemu_memalign(bdrv_opt_mem_align(bs), size);
}

void *qemu_blockalign0(BlockDriverState *bs, size_t size)
{
    return memset(qemu_blockalign(bs, size), 0, size);
}

void *qemu_try_blockalign(BlockDriverState *bs, size_t size)
{
    size_t align = bdrv_opt_mem_align(bs);

    /* Ensure that NULL is never returned on success */
    assert(align > 0);
    if (size == 0) {
        size = align;
    }

    return qemu_try_memalign(align, size);
}

void *qemu_try_blockalign0(BlockDriverState *bs, size_t size)
{
    void *mem = qemu_try_blockalign(bs, size);

    if (mem) {
        memset(mem, 0, size);
    }

    return mem;
}

/*
 * Check if all memory in this vector is sector aligned.
 */
bool bdrv_qiov_is_aligned(BlockDriverState *bs, QEMUIOVector *qiov)
{
    int i;
2828
    size_t alignment = bdrv_min_mem_align(bs);
2829 2830 2831 2832 2833 2834 2835 2836 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849

    for (i = 0; i < qiov->niov; i++) {
        if ((uintptr_t) qiov->iov[i].iov_base % alignment) {
            return false;
        }
        if (qiov->iov[i].iov_len % alignment) {
            return false;
        }
    }

    return true;
}

void bdrv_add_before_write_notifier(BlockDriverState *bs,
                                    NotifierWithReturn *notifier)
{
    notifier_with_return_list_add(&bs->before_write_notifiers, notifier);
}

void bdrv_io_plug(BlockDriverState *bs)
{
2850 2851 2852 2853 2854 2855
    BdrvChild *child;

    QLIST_FOREACH(child, &bs->children, next) {
        bdrv_io_plug(child->bs);
    }

2856
    if (atomic_fetch_inc(&bs->io_plugged) == 0) {
2857 2858 2859 2860
        BlockDriver *drv = bs->drv;
        if (drv && drv->bdrv_io_plug) {
            drv->bdrv_io_plug(bs);
        }
2861 2862 2863 2864 2865
    }
}

void bdrv_io_unplug(BlockDriverState *bs)
{
2866 2867 2868
    BdrvChild *child;

    assert(bs->io_plugged);
2869
    if (atomic_fetch_dec(&bs->io_plugged) == 1) {
2870 2871 2872 2873 2874 2875 2876 2877
        BlockDriver *drv = bs->drv;
        if (drv && drv->bdrv_io_unplug) {
            drv->bdrv_io_unplug(bs);
        }
    }

    QLIST_FOREACH(child, &bs->children, next) {
        bdrv_io_unplug(child->bs);
2878 2879
    }
}
F
Fam Zheng 已提交
2880 2881 2882 2883 2884 2885 2886 2887 2888 2889 2890 2891 2892 2893 2894 2895 2896 2897 2898 2899 2900 2901 2902 2903

void bdrv_register_buf(BlockDriverState *bs, void *host, size_t size)
{
    BdrvChild *child;

    if (bs->drv && bs->drv->bdrv_register_buf) {
        bs->drv->bdrv_register_buf(bs, host, size);
    }
    QLIST_FOREACH(child, &bs->children, next) {
        bdrv_register_buf(child->bs, host, size);
    }
}

void bdrv_unregister_buf(BlockDriverState *bs, void *host)
{
    BdrvChild *child;

    if (bs->drv && bs->drv->bdrv_unregister_buf) {
        bs->drv->bdrv_unregister_buf(bs, host);
    }
    QLIST_FOREACH(child, &bs->children, next) {
        bdrv_unregister_buf(child->bs, host);
    }
}
2904 2905 2906 2907 2908 2909 2910 2911 2912

static int coroutine_fn bdrv_co_copy_range_internal(BdrvChild *src,
                                                    uint64_t src_offset,
                                                    BdrvChild *dst,
                                                    uint64_t dst_offset,
                                                    uint64_t bytes,
                                                    BdrvRequestFlags flags,
                                                    bool recurse_src)
{
2913
    BdrvTrackedRequest src_req, dst_req;
2914 2915
    int ret;

2916
    if (!dst || !dst->bs) {
2917 2918 2919 2920 2921 2922 2923 2924 2925 2926
        return -ENOMEDIUM;
    }
    ret = bdrv_check_byte_request(dst->bs, dst_offset, bytes);
    if (ret) {
        return ret;
    }
    if (flags & BDRV_REQ_ZERO_WRITE) {
        return bdrv_co_pwrite_zeroes(dst, dst_offset, bytes, flags);
    }

2927 2928 2929 2930 2931 2932 2933 2934
    if (!src || !src->bs) {
        return -ENOMEDIUM;
    }
    ret = bdrv_check_byte_request(src->bs, src_offset, bytes);
    if (ret) {
        return ret;
    }

2935 2936 2937 2938 2939
    if (!src->bs->drv->bdrv_co_copy_range_from
        || !dst->bs->drv->bdrv_co_copy_range_to
        || src->bs->encrypted || dst->bs->encrypted) {
        return -ENOTSUP;
    }
2940 2941 2942
    bdrv_inc_in_flight(src->bs);
    bdrv_inc_in_flight(dst->bs);
    tracked_request_begin(&src_req, src->bs, src_offset,
2943
                          bytes, BDRV_TRACKED_READ);
2944
    tracked_request_begin(&dst_req, dst->bs, dst_offset,
2945 2946
                          bytes, BDRV_TRACKED_WRITE);

2947 2948 2949 2950
    if (!(flags & BDRV_REQ_NO_SERIALISING)) {
        wait_serialising_requests(&src_req);
        wait_serialising_requests(&dst_req);
    }
2951
    if (recurse_src) {
2952 2953 2954 2955
        ret = src->bs->drv->bdrv_co_copy_range_from(src->bs,
                                                    src, src_offset,
                                                    dst, dst_offset,
                                                    bytes, flags);
2956
    } else {
2957 2958 2959 2960
        ret = dst->bs->drv->bdrv_co_copy_range_to(dst->bs,
                                                  src, src_offset,
                                                  dst, dst_offset,
                                                  bytes, flags);
2961
    }
2962 2963
    tracked_request_end(&src_req);
    tracked_request_end(&dst_req);
2964 2965
    bdrv_dec_in_flight(src->bs);
    bdrv_dec_in_flight(dst->bs);
2966
    return ret;
2967 2968 2969 2970 2971 2972 2973 2974 2975 2976 2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989 2990 2991 2992 2993 2994 2995 2996
}

/* Copy range from @src to @dst.
 *
 * See the comment of bdrv_co_copy_range for the parameter and return value
 * semantics. */
int coroutine_fn bdrv_co_copy_range_from(BdrvChild *src, uint64_t src_offset,
                                         BdrvChild *dst, uint64_t dst_offset,
                                         uint64_t bytes, BdrvRequestFlags flags)
{
    return bdrv_co_copy_range_internal(src, src_offset, dst, dst_offset,
                                       bytes, flags, true);
}

/* Copy range from @src to @dst.
 *
 * See the comment of bdrv_co_copy_range for the parameter and return value
 * semantics. */
int coroutine_fn bdrv_co_copy_range_to(BdrvChild *src, uint64_t src_offset,
                                       BdrvChild *dst, uint64_t dst_offset,
                                       uint64_t bytes, BdrvRequestFlags flags)
{
    return bdrv_co_copy_range_internal(src, src_offset, dst, dst_offset,
                                       bytes, flags, false);
}

int coroutine_fn bdrv_co_copy_range(BdrvChild *src, uint64_t src_offset,
                                    BdrvChild *dst, uint64_t dst_offset,
                                    uint64_t bytes, BdrvRequestFlags flags)
{
2997 2998 2999
    return bdrv_co_copy_range_from(src, src_offset,
                                   dst, dst_offset,
                                   bytes, flags);
3000
}
3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019

static void bdrv_parent_cb_resize(BlockDriverState *bs)
{
    BdrvChild *c;
    QLIST_FOREACH(c, &bs->parents, next_parent) {
        if (c->role->resize) {
            c->role->resize(c);
        }
    }
}

/**
 * Truncate file to 'offset' bytes (needed only for file protocols)
 */
int coroutine_fn bdrv_co_truncate(BdrvChild *child, int64_t offset,
                                  PreallocMode prealloc, Error **errp)
{
    BlockDriverState *bs = child->bs;
    BlockDriver *drv = bs->drv;
3020 3021
    BdrvTrackedRequest req;
    int64_t old_size, new_bytes;
3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035
    int ret;

    assert(child->perm & BLK_PERM_RESIZE);

    /* if bs->drv == NULL, bs is closed, so there's nothing to do here */
    if (!drv) {
        error_setg(errp, "No medium inserted");
        return -ENOMEDIUM;
    }
    if (offset < 0) {
        error_setg(errp, "Image size cannot be negative");
        return -EINVAL;
    }

3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047
    old_size = bdrv_getlength(bs);
    if (old_size < 0) {
        error_setg_errno(errp, -old_size, "Failed to get old image size");
        return old_size;
    }

    if (offset > old_size) {
        new_bytes = offset - old_size;
    } else {
        new_bytes = 0;
    }

3048
    bdrv_inc_in_flight(bs);
3049 3050 3051 3052 3053 3054 3055 3056 3057
    tracked_request_begin(&req, bs, offset, new_bytes, BDRV_TRACKED_TRUNCATE);

    /* If we are growing the image and potentially using preallocation for the
     * new area, we need to make sure that no write requests are made to it
     * concurrently or they might be overwritten by preallocation. */
    if (new_bytes) {
        mark_request_serialising(&req, 1);
        wait_serialising_requests(&req);
    }
3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090

    if (!drv->bdrv_co_truncate) {
        if (bs->file && drv->is_filter) {
            ret = bdrv_co_truncate(bs->file, offset, prealloc, errp);
            goto out;
        }
        error_setg(errp, "Image format driver does not support resize");
        ret = -ENOTSUP;
        goto out;
    }
    if (bs->read_only) {
        error_setg(errp, "Image is read-only");
        ret = -EACCES;
        goto out;
    }

    assert(!(bs->open_flags & BDRV_O_INACTIVE));

    ret = drv->bdrv_co_truncate(bs, offset, prealloc, errp);
    if (ret < 0) {
        goto out;
    }
    ret = refresh_total_sectors(bs, offset >> BDRV_SECTOR_BITS);
    if (ret < 0) {
        error_setg_errno(errp, -ret, "Could not refresh total sector count");
    } else {
        offset = bs->total_sectors * BDRV_SECTOR_SIZE;
    }
    bdrv_dirty_bitmap_truncate(bs, offset);
    bdrv_parent_cb_resize(bs);
    atomic_inc(&bs->write_gen);

out:
3091
    tracked_request_end(&req);
3092
    bdrv_dec_in_flight(bs);
3093

3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 3131 3132 3133 3134
    return ret;
}

typedef struct TruncateCo {
    BdrvChild *child;
    int64_t offset;
    PreallocMode prealloc;
    Error **errp;
    int ret;
} TruncateCo;

static void coroutine_fn bdrv_truncate_co_entry(void *opaque)
{
    TruncateCo *tco = opaque;
    tco->ret = bdrv_co_truncate(tco->child, tco->offset, tco->prealloc,
                                tco->errp);
}

int bdrv_truncate(BdrvChild *child, int64_t offset, PreallocMode prealloc,
                  Error **errp)
{
    Coroutine *co;
    TruncateCo tco = {
        .child      = child,
        .offset     = offset,
        .prealloc   = prealloc,
        .errp       = errp,
        .ret        = NOT_DONE,
    };

    if (qemu_in_coroutine()) {
        /* Fast-path if already in coroutine context */
        bdrv_truncate_co_entry(&tco);
    } else {
        co = qemu_coroutine_create(bdrv_truncate_co_entry, &tco);
        qemu_coroutine_enter(co);
        BDRV_POLL_WHILE(child->bs, tco.ret == NOT_DONE);
    }

    return tco.ret;
}