2 * QEMU System Emulator block driver
4 * Copyright (c) 2003 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24 #include "config-host.h"
25 #include "qemu-common.h"
28 #include "block_int.h"
31 #include "qemu-coroutine.h"
32 #include "qmp-commands.h"
33 #include "qemu-timer.h"
36 #include <sys/types.h>
38 #include <sys/ioctl.h>
39 #include <sys/queue.h>
49 #define NOT_DONE 0x7fffffff /* used while emulated sync operation in progress */
52 BDRV_REQ_COPY_ON_READ
= 0x1,
53 BDRV_REQ_ZERO_WRITE
= 0x2,
56 static void bdrv_dev_change_media_cb(BlockDriverState
*bs
, bool load
);
57 static BlockDriverAIOCB
*bdrv_aio_readv_em(BlockDriverState
*bs
,
58 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
59 BlockDriverCompletionFunc
*cb
, void *opaque
);
60 static BlockDriverAIOCB
*bdrv_aio_writev_em(BlockDriverState
*bs
,
61 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
62 BlockDriverCompletionFunc
*cb
, void *opaque
);
63 static int coroutine_fn
bdrv_co_readv_em(BlockDriverState
*bs
,
64 int64_t sector_num
, int nb_sectors
,
66 static int coroutine_fn
bdrv_co_writev_em(BlockDriverState
*bs
,
67 int64_t sector_num
, int nb_sectors
,
69 static int coroutine_fn
bdrv_co_do_readv(BlockDriverState
*bs
,
70 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
,
71 BdrvRequestFlags flags
);
72 static int coroutine_fn
bdrv_co_do_writev(BlockDriverState
*bs
,
73 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
,
74 BdrvRequestFlags flags
);
75 static BlockDriverAIOCB
*bdrv_co_aio_rw_vector(BlockDriverState
*bs
,
79 BlockDriverCompletionFunc
*cb
,
82 static void coroutine_fn
bdrv_co_do_rw(void *opaque
);
83 static int coroutine_fn
bdrv_co_do_write_zeroes(BlockDriverState
*bs
,
84 int64_t sector_num
, int nb_sectors
);
86 static bool bdrv_exceed_bps_limits(BlockDriverState
*bs
, int nb_sectors
,
87 bool is_write
, double elapsed_time
, uint64_t *wait
);
88 static bool bdrv_exceed_iops_limits(BlockDriverState
*bs
, bool is_write
,
89 double elapsed_time
, uint64_t *wait
);
90 static bool bdrv_exceed_io_limits(BlockDriverState
*bs
, int nb_sectors
,
91 bool is_write
, int64_t *wait
);
93 static QTAILQ_HEAD(, BlockDriverState
) bdrv_states
=
94 QTAILQ_HEAD_INITIALIZER(bdrv_states
);
96 static QLIST_HEAD(, BlockDriver
) bdrv_drivers
=
97 QLIST_HEAD_INITIALIZER(bdrv_drivers
);
99 /* The device to use for VM snapshots */
100 static BlockDriverState
*bs_snapshots
;
102 /* If non-zero, use only whitelisted block drivers */
103 static int use_bdrv_whitelist
;
106 static int is_windows_drive_prefix(const char *filename
)
108 return (((filename
[0] >= 'a' && filename
[0] <= 'z') ||
109 (filename
[0] >= 'A' && filename
[0] <= 'Z')) &&
113 int is_windows_drive(const char *filename
)
115 if (is_windows_drive_prefix(filename
) &&
118 if (strstart(filename
, "\\\\.\\", NULL
) ||
119 strstart(filename
, "//./", NULL
))
125 /* throttling disk I/O limits */
126 void bdrv_io_limits_disable(BlockDriverState
*bs
)
128 bs
->io_limits_enabled
= false;
130 while (qemu_co_queue_next(&bs
->throttled_reqs
));
132 if (bs
->block_timer
) {
133 qemu_del_timer(bs
->block_timer
);
134 qemu_free_timer(bs
->block_timer
);
135 bs
->block_timer
= NULL
;
141 memset(&bs
->io_base
, 0, sizeof(bs
->io_base
));
144 static void bdrv_block_timer(void *opaque
)
146 BlockDriverState
*bs
= opaque
;
148 qemu_co_queue_next(&bs
->throttled_reqs
);
151 void bdrv_io_limits_enable(BlockDriverState
*bs
)
153 qemu_co_queue_init(&bs
->throttled_reqs
);
154 bs
->block_timer
= qemu_new_timer_ns(vm_clock
, bdrv_block_timer
, bs
);
155 bs
->slice_time
= 5 * BLOCK_IO_SLICE_TIME
;
156 bs
->slice_start
= qemu_get_clock_ns(vm_clock
);
157 bs
->slice_end
= bs
->slice_start
+ bs
->slice_time
;
158 memset(&bs
->io_base
, 0, sizeof(bs
->io_base
));
159 bs
->io_limits_enabled
= true;
162 bool bdrv_io_limits_enabled(BlockDriverState
*bs
)
164 BlockIOLimit
*io_limits
= &bs
->io_limits
;
165 return io_limits
->bps
[BLOCK_IO_LIMIT_READ
]
166 || io_limits
->bps
[BLOCK_IO_LIMIT_WRITE
]
167 || io_limits
->bps
[BLOCK_IO_LIMIT_TOTAL
]
168 || io_limits
->iops
[BLOCK_IO_LIMIT_READ
]
169 || io_limits
->iops
[BLOCK_IO_LIMIT_WRITE
]
170 || io_limits
->iops
[BLOCK_IO_LIMIT_TOTAL
];
173 static void bdrv_io_limits_intercept(BlockDriverState
*bs
,
174 bool is_write
, int nb_sectors
)
176 int64_t wait_time
= -1;
178 if (!qemu_co_queue_empty(&bs
->throttled_reqs
)) {
179 qemu_co_queue_wait(&bs
->throttled_reqs
);
182 /* In fact, we hope to keep each request's timing, in FIFO mode. The next
183 * throttled requests will not be dequeued until the current request is
184 * allowed to be serviced. So if the current request still exceeds the
185 * limits, it will be inserted to the head. All requests followed it will
186 * be still in throttled_reqs queue.
189 while (bdrv_exceed_io_limits(bs
, nb_sectors
, is_write
, &wait_time
)) {
190 qemu_mod_timer(bs
->block_timer
,
191 wait_time
+ qemu_get_clock_ns(vm_clock
));
192 qemu_co_queue_wait_insert_head(&bs
->throttled_reqs
);
195 qemu_co_queue_next(&bs
->throttled_reqs
);
198 /* check if the path starts with "<protocol>:" */
199 static int path_has_protocol(const char *path
)
204 if (is_windows_drive(path
) ||
205 is_windows_drive_prefix(path
)) {
208 p
= path
+ strcspn(path
, ":/\\");
210 p
= path
+ strcspn(path
, ":/");
216 int path_is_absolute(const char *path
)
219 /* specific case for names like: "\\.\d:" */
220 if (is_windows_drive(path
) || is_windows_drive_prefix(path
)) {
223 return (*path
== '/' || *path
== '\\');
225 return (*path
== '/');
229 /* if filename is absolute, just copy it to dest. Otherwise, build a
230 path to it by considering it is relative to base_path. URL are
232 void path_combine(char *dest
, int dest_size
,
233 const char *base_path
,
234 const char *filename
)
241 if (path_is_absolute(filename
)) {
242 pstrcpy(dest
, dest_size
, filename
);
244 p
= strchr(base_path
, ':');
249 p1
= strrchr(base_path
, '/');
253 p2
= strrchr(base_path
, '\\');
265 if (len
> dest_size
- 1)
267 memcpy(dest
, base_path
, len
);
269 pstrcat(dest
, dest_size
, filename
);
273 void bdrv_get_full_backing_filename(BlockDriverState
*bs
, char *dest
, size_t sz
)
275 if (bs
->backing_file
[0] == '\0' || path_has_protocol(bs
->backing_file
)) {
276 pstrcpy(dest
, sz
, bs
->backing_file
);
278 path_combine(dest
, sz
, bs
->filename
, bs
->backing_file
);
282 void bdrv_register(BlockDriver
*bdrv
)
284 /* Block drivers without coroutine functions need emulation */
285 if (!bdrv
->bdrv_co_readv
) {
286 bdrv
->bdrv_co_readv
= bdrv_co_readv_em
;
287 bdrv
->bdrv_co_writev
= bdrv_co_writev_em
;
289 /* bdrv_co_readv_em()/brdv_co_writev_em() work in terms of aio, so if
290 * the block driver lacks aio we need to emulate that too.
292 if (!bdrv
->bdrv_aio_readv
) {
293 /* add AIO emulation layer */
294 bdrv
->bdrv_aio_readv
= bdrv_aio_readv_em
;
295 bdrv
->bdrv_aio_writev
= bdrv_aio_writev_em
;
299 QLIST_INSERT_HEAD(&bdrv_drivers
, bdrv
, list
);
302 /* create a new block device (by default it is empty) */
303 BlockDriverState
*bdrv_new(const char *device_name
)
305 BlockDriverState
*bs
;
307 bs
= g_malloc0(sizeof(BlockDriverState
));
308 pstrcpy(bs
->device_name
, sizeof(bs
->device_name
), device_name
);
309 if (device_name
[0] != '\0') {
310 QTAILQ_INSERT_TAIL(&bdrv_states
, bs
, list
);
312 bdrv_iostatus_disable(bs
);
316 BlockDriver
*bdrv_find_format(const char *format_name
)
319 QLIST_FOREACH(drv1
, &bdrv_drivers
, list
) {
320 if (!strcmp(drv1
->format_name
, format_name
)) {
327 static int bdrv_is_whitelisted(BlockDriver
*drv
)
329 static const char *whitelist
[] = {
330 CONFIG_BDRV_WHITELIST
335 return 1; /* no whitelist, anything goes */
337 for (p
= whitelist
; *p
; p
++) {
338 if (!strcmp(drv
->format_name
, *p
)) {
345 BlockDriver
*bdrv_find_whitelisted_format(const char *format_name
)
347 BlockDriver
*drv
= bdrv_find_format(format_name
);
348 return drv
&& bdrv_is_whitelisted(drv
) ? drv
: NULL
;
351 typedef struct CreateCo
{
354 QEMUOptionParameter
*options
;
358 static void coroutine_fn
bdrv_create_co_entry(void *opaque
)
360 CreateCo
*cco
= opaque
;
363 cco
->ret
= cco
->drv
->bdrv_create(cco
->filename
, cco
->options
);
366 int bdrv_create(BlockDriver
*drv
, const char* filename
,
367 QEMUOptionParameter
*options
)
374 .filename
= g_strdup(filename
),
379 if (!drv
->bdrv_create
) {
383 if (qemu_in_coroutine()) {
384 /* Fast-path if already in coroutine context */
385 bdrv_create_co_entry(&cco
);
387 co
= qemu_coroutine_create(bdrv_create_co_entry
);
388 qemu_coroutine_enter(co
, &cco
);
389 while (cco
.ret
== NOT_DONE
) {
395 g_free(cco
.filename
);
400 int bdrv_create_file(const char* filename
, QEMUOptionParameter
*options
)
404 drv
= bdrv_find_protocol(filename
);
409 return bdrv_create(drv
, filename
, options
);
413 * Create a uniquely-named empty temporary file.
414 * Return 0 upon success, otherwise a negative errno value.
416 int get_tmp_filename(char *filename
, int size
)
419 char temp_dir
[MAX_PATH
];
420 /* GetTempFileName requires that its output buffer (4th param)
421 have length MAX_PATH or greater. */
422 assert(size
>= MAX_PATH
);
423 return (GetTempPath(MAX_PATH
, temp_dir
)
424 && GetTempFileName(temp_dir
, "qem", 0, filename
)
425 ? 0 : -GetLastError());
429 tmpdir
= getenv("TMPDIR");
432 if (snprintf(filename
, size
, "%s/vl.XXXXXX", tmpdir
) >= size
) {
435 fd
= mkstemp(filename
);
439 if (close(fd
) != 0) {
448 * Detect host devices. By convention, /dev/cdrom[N] is always
449 * recognized as a host CDROM.
451 static BlockDriver
*find_hdev_driver(const char *filename
)
453 int score_max
= 0, score
;
454 BlockDriver
*drv
= NULL
, *d
;
456 QLIST_FOREACH(d
, &bdrv_drivers
, list
) {
457 if (d
->bdrv_probe_device
) {
458 score
= d
->bdrv_probe_device(filename
);
459 if (score
> score_max
) {
469 BlockDriver
*bdrv_find_protocol(const char *filename
)
476 /* TODO Drivers without bdrv_file_open must be specified explicitly */
479 * XXX(hch): we really should not let host device detection
480 * override an explicit protocol specification, but moving this
481 * later breaks access to device names with colons in them.
482 * Thanks to the brain-dead persistent naming schemes on udev-
483 * based Linux systems those actually are quite common.
485 drv1
= find_hdev_driver(filename
);
490 if (!path_has_protocol(filename
)) {
491 return bdrv_find_format("file");
493 p
= strchr(filename
, ':');
496 if (len
> sizeof(protocol
) - 1)
497 len
= sizeof(protocol
) - 1;
498 memcpy(protocol
, filename
, len
);
499 protocol
[len
] = '\0';
500 QLIST_FOREACH(drv1
, &bdrv_drivers
, list
) {
501 if (drv1
->protocol_name
&&
502 !strcmp(drv1
->protocol_name
, protocol
)) {
509 static int find_image_format(const char *filename
, BlockDriver
**pdrv
)
511 int ret
, score
, score_max
;
512 BlockDriver
*drv1
, *drv
;
514 BlockDriverState
*bs
;
516 ret
= bdrv_file_open(&bs
, filename
, 0);
522 /* Return the raw BlockDriver * to scsi-generic devices or empty drives */
523 if (bs
->sg
|| !bdrv_is_inserted(bs
)) {
525 drv
= bdrv_find_format("raw");
533 ret
= bdrv_pread(bs
, 0, buf
, sizeof(buf
));
542 QLIST_FOREACH(drv1
, &bdrv_drivers
, list
) {
543 if (drv1
->bdrv_probe
) {
544 score
= drv1
->bdrv_probe(buf
, ret
, filename
);
545 if (score
> score_max
) {
559 * Set the current 'total_sectors' value
561 static int refresh_total_sectors(BlockDriverState
*bs
, int64_t hint
)
563 BlockDriver
*drv
= bs
->drv
;
565 /* Do not attempt drv->bdrv_getlength() on scsi-generic devices */
569 /* query actual device if possible, otherwise just trust the hint */
570 if (drv
->bdrv_getlength
) {
571 int64_t length
= drv
->bdrv_getlength(bs
);
575 hint
= length
>> BDRV_SECTOR_BITS
;
578 bs
->total_sectors
= hint
;
583 * Set open flags for a given cache mode
585 * Return 0 on success, -1 if the cache mode was invalid.
587 int bdrv_parse_cache_flags(const char *mode
, int *flags
)
589 *flags
&= ~BDRV_O_CACHE_MASK
;
591 if (!strcmp(mode
, "off") || !strcmp(mode
, "none")) {
592 *flags
|= BDRV_O_NOCACHE
| BDRV_O_CACHE_WB
;
593 } else if (!strcmp(mode
, "directsync")) {
594 *flags
|= BDRV_O_NOCACHE
;
595 } else if (!strcmp(mode
, "writeback")) {
596 *flags
|= BDRV_O_CACHE_WB
;
597 } else if (!strcmp(mode
, "unsafe")) {
598 *flags
|= BDRV_O_CACHE_WB
;
599 *flags
|= BDRV_O_NO_FLUSH
;
600 } else if (!strcmp(mode
, "writethrough")) {
601 /* this is the default */
610 * The copy-on-read flag is actually a reference count so multiple users may
611 * use the feature without worrying about clobbering its previous state.
612 * Copy-on-read stays enabled until all users have called to disable it.
614 void bdrv_enable_copy_on_read(BlockDriverState
*bs
)
619 void bdrv_disable_copy_on_read(BlockDriverState
*bs
)
621 assert(bs
->copy_on_read
> 0);
626 * Common part for opening disk images and files
628 static int bdrv_open_common(BlockDriverState
*bs
, const char *filename
,
629 int flags
, BlockDriver
*drv
)
634 assert(bs
->file
== NULL
);
636 trace_bdrv_open_common(bs
, filename
, flags
, drv
->format_name
);
638 bs
->open_flags
= flags
;
639 bs
->buffer_alignment
= 512;
641 assert(bs
->copy_on_read
== 0); /* bdrv_new() and bdrv_close() make it so */
642 if ((flags
& BDRV_O_RDWR
) && (flags
& BDRV_O_COPY_ON_READ
)) {
643 bdrv_enable_copy_on_read(bs
);
646 pstrcpy(bs
->filename
, sizeof(bs
->filename
), filename
);
648 if (use_bdrv_whitelist
&& !bdrv_is_whitelisted(drv
)) {
653 bs
->opaque
= g_malloc0(drv
->instance_size
);
655 bs
->enable_write_cache
= !!(flags
& BDRV_O_CACHE_WB
);
656 open_flags
= flags
| BDRV_O_CACHE_WB
;
659 * Clear flags that are internal to the block layer before opening the
662 open_flags
&= ~(BDRV_O_SNAPSHOT
| BDRV_O_NO_BACKING
);
665 * Snapshots should be writable.
667 if (bs
->is_temporary
) {
668 open_flags
|= BDRV_O_RDWR
;
671 bs
->read_only
= !(open_flags
& BDRV_O_RDWR
);
673 /* Open the image, either directly or using a protocol */
674 if (drv
->bdrv_file_open
) {
675 ret
= drv
->bdrv_file_open(bs
, filename
, open_flags
);
677 ret
= bdrv_file_open(&bs
->file
, filename
, open_flags
);
679 ret
= drv
->bdrv_open(bs
, open_flags
);
687 ret
= refresh_total_sectors(bs
, bs
->total_sectors
);
693 if (bs
->is_temporary
) {
701 bdrv_delete(bs
->file
);
711 * Opens a file using a protocol (file, host_device, nbd, ...)
713 int bdrv_file_open(BlockDriverState
**pbs
, const char *filename
, int flags
)
715 BlockDriverState
*bs
;
719 drv
= bdrv_find_protocol(filename
);
725 ret
= bdrv_open_common(bs
, filename
, flags
, drv
);
736 * Opens a disk image (raw, qcow2, vmdk, ...)
738 int bdrv_open(BlockDriverState
*bs
, const char *filename
, int flags
,
742 char tmp_filename
[PATH_MAX
];
744 if (flags
& BDRV_O_SNAPSHOT
) {
745 BlockDriverState
*bs1
;
748 BlockDriver
*bdrv_qcow2
;
749 QEMUOptionParameter
*options
;
750 char backing_filename
[PATH_MAX
];
752 /* if snapshot, we create a temporary backing file and open it
753 instead of opening 'filename' directly */
755 /* if there is a backing file, use it */
757 ret
= bdrv_open(bs1
, filename
, 0, drv
);
762 total_size
= bdrv_getlength(bs1
) & BDRV_SECTOR_MASK
;
764 if (bs1
->drv
&& bs1
->drv
->protocol_name
)
769 ret
= get_tmp_filename(tmp_filename
, sizeof(tmp_filename
));
774 /* Real path is meaningless for protocols */
776 snprintf(backing_filename
, sizeof(backing_filename
),
778 else if (!realpath(filename
, backing_filename
))
781 bdrv_qcow2
= bdrv_find_format("qcow2");
782 options
= parse_option_parameters("", bdrv_qcow2
->create_options
, NULL
);
784 set_option_parameter_int(options
, BLOCK_OPT_SIZE
, total_size
);
785 set_option_parameter(options
, BLOCK_OPT_BACKING_FILE
, backing_filename
);
787 set_option_parameter(options
, BLOCK_OPT_BACKING_FMT
,
791 ret
= bdrv_create(bdrv_qcow2
, tmp_filename
, options
);
792 free_option_parameters(options
);
797 filename
= tmp_filename
;
799 bs
->is_temporary
= 1;
802 /* Find the right image format driver */
804 ret
= find_image_format(filename
, &drv
);
808 goto unlink_and_fail
;
811 if (flags
& BDRV_O_RDWR
) {
812 flags
|= BDRV_O_ALLOW_RDWR
;
816 ret
= bdrv_open_common(bs
, filename
, flags
, drv
);
818 goto unlink_and_fail
;
821 /* If there is a backing file, use it */
822 if ((flags
& BDRV_O_NO_BACKING
) == 0 && bs
->backing_file
[0] != '\0') {
823 char backing_filename
[PATH_MAX
];
825 BlockDriver
*back_drv
= NULL
;
827 bs
->backing_hd
= bdrv_new("");
828 bdrv_get_full_backing_filename(bs
, backing_filename
,
829 sizeof(backing_filename
));
831 if (bs
->backing_format
[0] != '\0') {
832 back_drv
= bdrv_find_format(bs
->backing_format
);
835 /* backing files always opened read-only */
837 flags
& ~(BDRV_O_RDWR
| BDRV_O_SNAPSHOT
| BDRV_O_NO_BACKING
);
839 ret
= bdrv_open(bs
->backing_hd
, backing_filename
, back_flags
, back_drv
);
846 if (!bdrv_key_required(bs
)) {
847 bdrv_dev_change_media_cb(bs
, true);
850 /* throttling disk I/O limits */
851 if (bs
->io_limits_enabled
) {
852 bdrv_io_limits_enable(bs
);
858 if (bs
->is_temporary
) {
864 typedef struct BlockReopenQueueEntry
{
866 BDRVReopenState state
;
867 QSIMPLEQ_ENTRY(BlockReopenQueueEntry
) entry
;
868 } BlockReopenQueueEntry
;
871 * Adds a BlockDriverState to a simple queue for an atomic, transactional
872 * reopen of multiple devices.
874 * bs_queue can either be an existing BlockReopenQueue that has had QSIMPLE_INIT
875 * already performed, or alternatively may be NULL a new BlockReopenQueue will
876 * be created and initialized. This newly created BlockReopenQueue should be
877 * passed back in for subsequent calls that are intended to be of the same
880 * bs is the BlockDriverState to add to the reopen queue.
882 * flags contains the open flags for the associated bs
884 * returns a pointer to bs_queue, which is either the newly allocated
885 * bs_queue, or the existing bs_queue being used.
888 BlockReopenQueue
*bdrv_reopen_queue(BlockReopenQueue
*bs_queue
,
889 BlockDriverState
*bs
, int flags
)
893 BlockReopenQueueEntry
*bs_entry
;
894 if (bs_queue
== NULL
) {
895 bs_queue
= g_new0(BlockReopenQueue
, 1);
896 QSIMPLEQ_INIT(bs_queue
);
900 bdrv_reopen_queue(bs_queue
, bs
->file
, flags
);
903 bs_entry
= g_new0(BlockReopenQueueEntry
, 1);
904 QSIMPLEQ_INSERT_TAIL(bs_queue
, bs_entry
, entry
);
906 bs_entry
->state
.bs
= bs
;
907 bs_entry
->state
.flags
= flags
;
913 * Reopen multiple BlockDriverStates atomically & transactionally.
915 * The queue passed in (bs_queue) must have been built up previous
916 * via bdrv_reopen_queue().
918 * Reopens all BDS specified in the queue, with the appropriate
919 * flags. All devices are prepared for reopen, and failure of any
920 * device will cause all device changes to be abandonded, and intermediate
923 * If all devices prepare successfully, then the changes are committed
927 int bdrv_reopen_multiple(BlockReopenQueue
*bs_queue
, Error
**errp
)
930 BlockReopenQueueEntry
*bs_entry
, *next
;
931 Error
*local_err
= NULL
;
933 assert(bs_queue
!= NULL
);
937 QSIMPLEQ_FOREACH(bs_entry
, bs_queue
, entry
) {
938 if (bdrv_reopen_prepare(&bs_entry
->state
, bs_queue
, &local_err
)) {
939 error_propagate(errp
, local_err
);
942 bs_entry
->prepared
= true;
945 /* If we reach this point, we have success and just need to apply the
948 QSIMPLEQ_FOREACH(bs_entry
, bs_queue
, entry
) {
949 bdrv_reopen_commit(&bs_entry
->state
);
955 QSIMPLEQ_FOREACH_SAFE(bs_entry
, bs_queue
, entry
, next
) {
956 if (ret
&& bs_entry
->prepared
) {
957 bdrv_reopen_abort(&bs_entry
->state
);
966 /* Reopen a single BlockDriverState with the specified flags. */
967 int bdrv_reopen(BlockDriverState
*bs
, int bdrv_flags
, Error
**errp
)
970 Error
*local_err
= NULL
;
971 BlockReopenQueue
*queue
= bdrv_reopen_queue(NULL
, bs
, bdrv_flags
);
973 ret
= bdrv_reopen_multiple(queue
, &local_err
);
974 if (local_err
!= NULL
) {
975 error_propagate(errp
, local_err
);
982 * Prepares a BlockDriverState for reopen. All changes are staged in the
983 * 'opaque' field of the BDRVReopenState, which is used and allocated by
984 * the block driver layer .bdrv_reopen_prepare()
986 * bs is the BlockDriverState to reopen
987 * flags are the new open flags
988 * queue is the reopen queue
990 * Returns 0 on success, non-zero on error. On error errp will be set
993 * On failure, bdrv_reopen_abort() will be called to clean up any data.
994 * It is the responsibility of the caller to then call the abort() or
995 * commit() for any other BDS that have been left in a prepare() state
998 int bdrv_reopen_prepare(BDRVReopenState
*reopen_state
, BlockReopenQueue
*queue
,
1002 Error
*local_err
= NULL
;
1005 assert(reopen_state
!= NULL
);
1006 assert(reopen_state
->bs
->drv
!= NULL
);
1007 drv
= reopen_state
->bs
->drv
;
1009 /* if we are to stay read-only, do not allow permission change
1011 if (!(reopen_state
->bs
->open_flags
& BDRV_O_ALLOW_RDWR
) &&
1012 reopen_state
->flags
& BDRV_O_RDWR
) {
1013 error_set(errp
, QERR_DEVICE_IS_READ_ONLY
,
1014 reopen_state
->bs
->device_name
);
1019 ret
= bdrv_flush(reopen_state
->bs
);
1021 error_set(errp
, ERROR_CLASS_GENERIC_ERROR
, "Error (%s) flushing drive",
1026 if (drv
->bdrv_reopen_prepare
) {
1027 ret
= drv
->bdrv_reopen_prepare(reopen_state
, queue
, &local_err
);
1029 if (local_err
!= NULL
) {
1030 error_propagate(errp
, local_err
);
1032 error_set(errp
, QERR_OPEN_FILE_FAILED
,
1033 reopen_state
->bs
->filename
);
1038 /* It is currently mandatory to have a bdrv_reopen_prepare()
1039 * handler for each supported drv. */
1040 error_set(errp
, QERR_BLOCK_FORMAT_FEATURE_NOT_SUPPORTED
,
1041 drv
->format_name
, reopen_state
->bs
->device_name
,
1042 "reopening of file");
1054 * Takes the staged changes for the reopen from bdrv_reopen_prepare(), and
1055 * makes them final by swapping the staging BlockDriverState contents into
1056 * the active BlockDriverState contents.
1058 void bdrv_reopen_commit(BDRVReopenState
*reopen_state
)
1062 assert(reopen_state
!= NULL
);
1063 drv
= reopen_state
->bs
->drv
;
1064 assert(drv
!= NULL
);
1066 /* If there are any driver level actions to take */
1067 if (drv
->bdrv_reopen_commit
) {
1068 drv
->bdrv_reopen_commit(reopen_state
);
1071 /* set BDS specific flags now */
1072 reopen_state
->bs
->open_flags
= reopen_state
->flags
;
1073 reopen_state
->bs
->enable_write_cache
= !!(reopen_state
->flags
&
1075 reopen_state
->bs
->read_only
= !(reopen_state
->flags
& BDRV_O_RDWR
);
1079 * Abort the reopen, and delete and free the staged changes in
1082 void bdrv_reopen_abort(BDRVReopenState
*reopen_state
)
1086 assert(reopen_state
!= NULL
);
1087 drv
= reopen_state
->bs
->drv
;
1088 assert(drv
!= NULL
);
1090 if (drv
->bdrv_reopen_abort
) {
1091 drv
->bdrv_reopen_abort(reopen_state
);
1096 void bdrv_close(BlockDriverState
*bs
)
1101 block_job_cancel_sync(bs
->job
);
1105 if (bs
== bs_snapshots
) {
1106 bs_snapshots
= NULL
;
1108 if (bs
->backing_hd
) {
1109 bdrv_delete(bs
->backing_hd
);
1110 bs
->backing_hd
= NULL
;
1112 bs
->drv
->bdrv_close(bs
);
1115 if (bs
->is_temporary
) {
1116 unlink(bs
->filename
);
1121 bs
->copy_on_read
= 0;
1122 bs
->backing_file
[0] = '\0';
1123 bs
->backing_format
[0] = '\0';
1124 bs
->total_sectors
= 0;
1130 if (bs
->file
!= NULL
) {
1131 bdrv_delete(bs
->file
);
1136 bdrv_dev_change_media_cb(bs
, false);
1138 /*throttling disk I/O limits*/
1139 if (bs
->io_limits_enabled
) {
1140 bdrv_io_limits_disable(bs
);
1144 void bdrv_close_all(void)
1146 BlockDriverState
*bs
;
1148 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1154 * Wait for pending requests to complete across all BlockDriverStates
1156 * This function does not flush data to disk, use bdrv_flush_all() for that
1157 * after calling this function.
1159 * Note that completion of an asynchronous I/O operation can trigger any
1160 * number of other I/O operations on other devices---for example a coroutine
1161 * can be arbitrarily complex and a constant flow of I/O can come until the
1162 * coroutine is complete. Because of this, it is not possible to have a
1163 * function to drain a single device's I/O queue.
1165 void bdrv_drain_all(void)
1167 BlockDriverState
*bs
;
1171 busy
= qemu_aio_wait();
1173 /* FIXME: We do not have timer support here, so this is effectively
1176 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1177 if (!qemu_co_queue_empty(&bs
->throttled_reqs
)) {
1178 qemu_co_queue_restart_all(&bs
->throttled_reqs
);
1184 /* If requests are still pending there is a bug somewhere */
1185 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1186 assert(QLIST_EMPTY(&bs
->tracked_requests
));
1187 assert(qemu_co_queue_empty(&bs
->throttled_reqs
));
1191 /* make a BlockDriverState anonymous by removing from bdrv_state list.
1192 Also, NULL terminate the device_name to prevent double remove */
1193 void bdrv_make_anon(BlockDriverState
*bs
)
1195 if (bs
->device_name
[0] != '\0') {
1196 QTAILQ_REMOVE(&bdrv_states
, bs
, list
);
1198 bs
->device_name
[0] = '\0';
1201 static void bdrv_rebind(BlockDriverState
*bs
)
1203 if (bs
->drv
&& bs
->drv
->bdrv_rebind
) {
1204 bs
->drv
->bdrv_rebind(bs
);
1208 static void bdrv_move_feature_fields(BlockDriverState
*bs_dest
,
1209 BlockDriverState
*bs_src
)
1211 /* move some fields that need to stay attached to the device */
1212 bs_dest
->open_flags
= bs_src
->open_flags
;
1215 bs_dest
->dev_ops
= bs_src
->dev_ops
;
1216 bs_dest
->dev_opaque
= bs_src
->dev_opaque
;
1217 bs_dest
->dev
= bs_src
->dev
;
1218 bs_dest
->buffer_alignment
= bs_src
->buffer_alignment
;
1219 bs_dest
->copy_on_read
= bs_src
->copy_on_read
;
1221 bs_dest
->enable_write_cache
= bs_src
->enable_write_cache
;
1223 /* i/o timing parameters */
1224 bs_dest
->slice_time
= bs_src
->slice_time
;
1225 bs_dest
->slice_start
= bs_src
->slice_start
;
1226 bs_dest
->slice_end
= bs_src
->slice_end
;
1227 bs_dest
->io_limits
= bs_src
->io_limits
;
1228 bs_dest
->io_base
= bs_src
->io_base
;
1229 bs_dest
->throttled_reqs
= bs_src
->throttled_reqs
;
1230 bs_dest
->block_timer
= bs_src
->block_timer
;
1231 bs_dest
->io_limits_enabled
= bs_src
->io_limits_enabled
;
1234 bs_dest
->on_read_error
= bs_src
->on_read_error
;
1235 bs_dest
->on_write_error
= bs_src
->on_write_error
;
1238 bs_dest
->iostatus_enabled
= bs_src
->iostatus_enabled
;
1239 bs_dest
->iostatus
= bs_src
->iostatus
;
1242 bs_dest
->dirty_count
= bs_src
->dirty_count
;
1243 bs_dest
->dirty_bitmap
= bs_src
->dirty_bitmap
;
1246 bs_dest
->in_use
= bs_src
->in_use
;
1247 bs_dest
->job
= bs_src
->job
;
1249 /* keep the same entry in bdrv_states */
1250 pstrcpy(bs_dest
->device_name
, sizeof(bs_dest
->device_name
),
1251 bs_src
->device_name
);
1252 bs_dest
->list
= bs_src
->list
;
1256 * Swap bs contents for two image chains while they are live,
1257 * while keeping required fields on the BlockDriverState that is
1258 * actually attached to a device.
1260 * This will modify the BlockDriverState fields, and swap contents
1261 * between bs_new and bs_old. Both bs_new and bs_old are modified.
1263 * bs_new is required to be anonymous.
1265 * This function does not create any image files.
1267 void bdrv_swap(BlockDriverState
*bs_new
, BlockDriverState
*bs_old
)
1269 BlockDriverState tmp
;
1271 /* bs_new must be anonymous and shouldn't have anything fancy enabled */
1272 assert(bs_new
->device_name
[0] == '\0');
1273 assert(bs_new
->dirty_bitmap
== NULL
);
1274 assert(bs_new
->job
== NULL
);
1275 assert(bs_new
->dev
== NULL
);
1276 assert(bs_new
->in_use
== 0);
1277 assert(bs_new
->io_limits_enabled
== false);
1278 assert(bs_new
->block_timer
== NULL
);
1284 /* there are some fields that should not be swapped, move them back */
1285 bdrv_move_feature_fields(&tmp
, bs_old
);
1286 bdrv_move_feature_fields(bs_old
, bs_new
);
1287 bdrv_move_feature_fields(bs_new
, &tmp
);
1289 /* bs_new shouldn't be in bdrv_states even after the swap! */
1290 assert(bs_new
->device_name
[0] == '\0');
1292 /* Check a few fields that should remain attached to the device */
1293 assert(bs_new
->dev
== NULL
);
1294 assert(bs_new
->job
== NULL
);
1295 assert(bs_new
->in_use
== 0);
1296 assert(bs_new
->io_limits_enabled
== false);
1297 assert(bs_new
->block_timer
== NULL
);
1299 bdrv_rebind(bs_new
);
1300 bdrv_rebind(bs_old
);
1304 * Add new bs contents at the top of an image chain while the chain is
1305 * live, while keeping required fields on the top layer.
1307 * This will modify the BlockDriverState fields, and swap contents
1308 * between bs_new and bs_top. Both bs_new and bs_top are modified.
1310 * bs_new is required to be anonymous.
1312 * This function does not create any image files.
1314 void bdrv_append(BlockDriverState
*bs_new
, BlockDriverState
*bs_top
)
1316 bdrv_swap(bs_new
, bs_top
);
1318 /* The contents of 'tmp' will become bs_top, as we are
1319 * swapping bs_new and bs_top contents. */
1320 bs_top
->backing_hd
= bs_new
;
1321 bs_top
->open_flags
&= ~BDRV_O_NO_BACKING
;
1322 pstrcpy(bs_top
->backing_file
, sizeof(bs_top
->backing_file
),
1324 pstrcpy(bs_top
->backing_format
, sizeof(bs_top
->backing_format
),
1325 bs_new
->drv
? bs_new
->drv
->format_name
: "");
1328 void bdrv_delete(BlockDriverState
*bs
)
1332 assert(!bs
->in_use
);
1334 /* remove from list, if necessary */
1339 assert(bs
!= bs_snapshots
);
1343 int bdrv_attach_dev(BlockDriverState
*bs
, void *dev
)
1344 /* TODO change to DeviceState *dev when all users are qdevified */
1350 bdrv_iostatus_reset(bs
);
1354 /* TODO qdevified devices don't use this, remove when devices are qdevified */
1355 void bdrv_attach_dev_nofail(BlockDriverState
*bs
, void *dev
)
1357 if (bdrv_attach_dev(bs
, dev
) < 0) {
1362 void bdrv_detach_dev(BlockDriverState
*bs
, void *dev
)
1363 /* TODO change to DeviceState *dev when all users are qdevified */
1365 assert(bs
->dev
== dev
);
1368 bs
->dev_opaque
= NULL
;
1369 bs
->buffer_alignment
= 512;
1372 /* TODO change to return DeviceState * when all users are qdevified */
1373 void *bdrv_get_attached_dev(BlockDriverState
*bs
)
1378 void bdrv_set_dev_ops(BlockDriverState
*bs
, const BlockDevOps
*ops
,
1382 bs
->dev_opaque
= opaque
;
1383 if (bdrv_dev_has_removable_media(bs
) && bs
== bs_snapshots
) {
1384 bs_snapshots
= NULL
;
1388 void bdrv_emit_qmp_error_event(const BlockDriverState
*bdrv
,
1389 BlockQMPEventAction action
, int is_read
)
1392 const char *action_str
;
1395 case BDRV_ACTION_REPORT
:
1396 action_str
= "report";
1398 case BDRV_ACTION_IGNORE
:
1399 action_str
= "ignore";
1401 case BDRV_ACTION_STOP
:
1402 action_str
= "stop";
1408 data
= qobject_from_jsonf("{ 'device': %s, 'action': %s, 'operation': %s }",
1411 is_read
? "read" : "write");
1412 monitor_protocol_event(QEVENT_BLOCK_IO_ERROR
, data
);
1414 qobject_decref(data
);
1417 static void bdrv_emit_qmp_eject_event(BlockDriverState
*bs
, bool ejected
)
1421 data
= qobject_from_jsonf("{ 'device': %s, 'tray-open': %i }",
1422 bdrv_get_device_name(bs
), ejected
);
1423 monitor_protocol_event(QEVENT_DEVICE_TRAY_MOVED
, data
);
1425 qobject_decref(data
);
1428 static void bdrv_dev_change_media_cb(BlockDriverState
*bs
, bool load
)
1430 if (bs
->dev_ops
&& bs
->dev_ops
->change_media_cb
) {
1431 bool tray_was_closed
= !bdrv_dev_is_tray_open(bs
);
1432 bs
->dev_ops
->change_media_cb(bs
->dev_opaque
, load
);
1433 if (tray_was_closed
) {
1435 bdrv_emit_qmp_eject_event(bs
, true);
1439 bdrv_emit_qmp_eject_event(bs
, false);
1444 bool bdrv_dev_has_removable_media(BlockDriverState
*bs
)
1446 return !bs
->dev
|| (bs
->dev_ops
&& bs
->dev_ops
->change_media_cb
);
1449 void bdrv_dev_eject_request(BlockDriverState
*bs
, bool force
)
1451 if (bs
->dev_ops
&& bs
->dev_ops
->eject_request_cb
) {
1452 bs
->dev_ops
->eject_request_cb(bs
->dev_opaque
, force
);
1456 bool bdrv_dev_is_tray_open(BlockDriverState
*bs
)
1458 if (bs
->dev_ops
&& bs
->dev_ops
->is_tray_open
) {
1459 return bs
->dev_ops
->is_tray_open(bs
->dev_opaque
);
1464 static void bdrv_dev_resize_cb(BlockDriverState
*bs
)
1466 if (bs
->dev_ops
&& bs
->dev_ops
->resize_cb
) {
1467 bs
->dev_ops
->resize_cb(bs
->dev_opaque
);
1471 bool bdrv_dev_is_medium_locked(BlockDriverState
*bs
)
1473 if (bs
->dev_ops
&& bs
->dev_ops
->is_medium_locked
) {
1474 return bs
->dev_ops
->is_medium_locked(bs
->dev_opaque
);
1480 * Run consistency checks on an image
1482 * Returns 0 if the check could be completed (it doesn't mean that the image is
1483 * free of errors) or -errno when an internal error occurred. The results of the
1484 * check are stored in res.
1486 int bdrv_check(BlockDriverState
*bs
, BdrvCheckResult
*res
, BdrvCheckMode fix
)
1488 if (bs
->drv
->bdrv_check
== NULL
) {
1492 memset(res
, 0, sizeof(*res
));
1493 return bs
->drv
->bdrv_check(bs
, res
, fix
);
1496 #define COMMIT_BUF_SECTORS 2048
1498 /* commit COW file into the raw image */
1499 int bdrv_commit(BlockDriverState
*bs
)
1501 BlockDriver
*drv
= bs
->drv
;
1502 int64_t sector
, total_sectors
;
1503 int n
, ro
, open_flags
;
1506 char filename
[1024];
1511 if (!bs
->backing_hd
) {
1515 if (bdrv_in_use(bs
) || bdrv_in_use(bs
->backing_hd
)) {
1519 ro
= bs
->backing_hd
->read_only
;
1520 strncpy(filename
, bs
->backing_hd
->filename
, sizeof(filename
));
1521 open_flags
= bs
->backing_hd
->open_flags
;
1524 if (bdrv_reopen(bs
->backing_hd
, open_flags
| BDRV_O_RDWR
, NULL
)) {
1529 total_sectors
= bdrv_getlength(bs
) >> BDRV_SECTOR_BITS
;
1530 buf
= g_malloc(COMMIT_BUF_SECTORS
* BDRV_SECTOR_SIZE
);
1532 for (sector
= 0; sector
< total_sectors
; sector
+= n
) {
1533 if (bdrv_is_allocated(bs
, sector
, COMMIT_BUF_SECTORS
, &n
)) {
1535 if (bdrv_read(bs
, sector
, buf
, n
) != 0) {
1540 if (bdrv_write(bs
->backing_hd
, sector
, buf
, n
) != 0) {
1547 if (drv
->bdrv_make_empty
) {
1548 ret
= drv
->bdrv_make_empty(bs
);
1553 * Make sure all data we wrote to the backing device is actually
1557 bdrv_flush(bs
->backing_hd
);
1563 /* ignoring error return here */
1564 bdrv_reopen(bs
->backing_hd
, open_flags
& ~BDRV_O_RDWR
, NULL
);
1570 int bdrv_commit_all(void)
1572 BlockDriverState
*bs
;
1574 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1575 int ret
= bdrv_commit(bs
);
1583 struct BdrvTrackedRequest
{
1584 BlockDriverState
*bs
;
1588 QLIST_ENTRY(BdrvTrackedRequest
) list
;
1589 Coroutine
*co
; /* owner, used for deadlock detection */
1590 CoQueue wait_queue
; /* coroutines blocked on this request */
1594 * Remove an active request from the tracked requests list
1596 * This function should be called when a tracked request is completing.
1598 static void tracked_request_end(BdrvTrackedRequest
*req
)
1600 QLIST_REMOVE(req
, list
);
1601 qemu_co_queue_restart_all(&req
->wait_queue
);
1605 * Add an active request to the tracked requests list
1607 static void tracked_request_begin(BdrvTrackedRequest
*req
,
1608 BlockDriverState
*bs
,
1610 int nb_sectors
, bool is_write
)
1612 *req
= (BdrvTrackedRequest
){
1614 .sector_num
= sector_num
,
1615 .nb_sectors
= nb_sectors
,
1616 .is_write
= is_write
,
1617 .co
= qemu_coroutine_self(),
1620 qemu_co_queue_init(&req
->wait_queue
);
1622 QLIST_INSERT_HEAD(&bs
->tracked_requests
, req
, list
);
1626 * Round a region to cluster boundaries
1628 static void round_to_clusters(BlockDriverState
*bs
,
1629 int64_t sector_num
, int nb_sectors
,
1630 int64_t *cluster_sector_num
,
1631 int *cluster_nb_sectors
)
1633 BlockDriverInfo bdi
;
1635 if (bdrv_get_info(bs
, &bdi
) < 0 || bdi
.cluster_size
== 0) {
1636 *cluster_sector_num
= sector_num
;
1637 *cluster_nb_sectors
= nb_sectors
;
1639 int64_t c
= bdi
.cluster_size
/ BDRV_SECTOR_SIZE
;
1640 *cluster_sector_num
= QEMU_ALIGN_DOWN(sector_num
, c
);
1641 *cluster_nb_sectors
= QEMU_ALIGN_UP(sector_num
- *cluster_sector_num
+
1646 static bool tracked_request_overlaps(BdrvTrackedRequest
*req
,
1647 int64_t sector_num
, int nb_sectors
) {
1649 if (sector_num
>= req
->sector_num
+ req
->nb_sectors
) {
1653 if (req
->sector_num
>= sector_num
+ nb_sectors
) {
1659 static void coroutine_fn
wait_for_overlapping_requests(BlockDriverState
*bs
,
1660 int64_t sector_num
, int nb_sectors
)
1662 BdrvTrackedRequest
*req
;
1663 int64_t cluster_sector_num
;
1664 int cluster_nb_sectors
;
1667 /* If we touch the same cluster it counts as an overlap. This guarantees
1668 * that allocating writes will be serialized and not race with each other
1669 * for the same cluster. For example, in copy-on-read it ensures that the
1670 * CoR read and write operations are atomic and guest writes cannot
1671 * interleave between them.
1673 round_to_clusters(bs
, sector_num
, nb_sectors
,
1674 &cluster_sector_num
, &cluster_nb_sectors
);
1678 QLIST_FOREACH(req
, &bs
->tracked_requests
, list
) {
1679 if (tracked_request_overlaps(req
, cluster_sector_num
,
1680 cluster_nb_sectors
)) {
1681 /* Hitting this means there was a reentrant request, for
1682 * example, a block driver issuing nested requests. This must
1683 * never happen since it means deadlock.
1685 assert(qemu_coroutine_self() != req
->co
);
1687 qemu_co_queue_wait(&req
->wait_queue
);
1698 * -EINVAL - backing format specified, but no file
1699 * -ENOSPC - can't update the backing file because no space is left in the
1701 * -ENOTSUP - format driver doesn't support changing the backing file
1703 int bdrv_change_backing_file(BlockDriverState
*bs
,
1704 const char *backing_file
, const char *backing_fmt
)
1706 BlockDriver
*drv
= bs
->drv
;
1709 /* Backing file format doesn't make sense without a backing file */
1710 if (backing_fmt
&& !backing_file
) {
1714 if (drv
->bdrv_change_backing_file
!= NULL
) {
1715 ret
= drv
->bdrv_change_backing_file(bs
, backing_file
, backing_fmt
);
1721 pstrcpy(bs
->backing_file
, sizeof(bs
->backing_file
), backing_file
?: "");
1722 pstrcpy(bs
->backing_format
, sizeof(bs
->backing_format
), backing_fmt
?: "");
1727 static int bdrv_check_byte_request(BlockDriverState
*bs
, int64_t offset
,
1732 if (!bdrv_is_inserted(bs
))
1738 len
= bdrv_getlength(bs
);
1743 if ((offset
> len
) || (len
- offset
< size
))
1749 static int bdrv_check_request(BlockDriverState
*bs
, int64_t sector_num
,
1752 return bdrv_check_byte_request(bs
, sector_num
* BDRV_SECTOR_SIZE
,
1753 nb_sectors
* BDRV_SECTOR_SIZE
);
1756 typedef struct RwCo
{
1757 BlockDriverState
*bs
;
1765 static void coroutine_fn
bdrv_rw_co_entry(void *opaque
)
1767 RwCo
*rwco
= opaque
;
1769 if (!rwco
->is_write
) {
1770 rwco
->ret
= bdrv_co_do_readv(rwco
->bs
, rwco
->sector_num
,
1771 rwco
->nb_sectors
, rwco
->qiov
, 0);
1773 rwco
->ret
= bdrv_co_do_writev(rwco
->bs
, rwco
->sector_num
,
1774 rwco
->nb_sectors
, rwco
->qiov
, 0);
1779 * Process a synchronous request using coroutines
1781 static int bdrv_rw_co(BlockDriverState
*bs
, int64_t sector_num
, uint8_t *buf
,
1782 int nb_sectors
, bool is_write
)
1785 struct iovec iov
= {
1786 .iov_base
= (void *)buf
,
1787 .iov_len
= nb_sectors
* BDRV_SECTOR_SIZE
,
1792 .sector_num
= sector_num
,
1793 .nb_sectors
= nb_sectors
,
1795 .is_write
= is_write
,
1799 qemu_iovec_init_external(&qiov
, &iov
, 1);
1802 * In sync call context, when the vcpu is blocked, this throttling timer
1803 * will not fire; so the I/O throttling function has to be disabled here
1804 * if it has been enabled.
1806 if (bs
->io_limits_enabled
) {
1807 fprintf(stderr
, "Disabling I/O throttling on '%s' due "
1808 "to synchronous I/O.\n", bdrv_get_device_name(bs
));
1809 bdrv_io_limits_disable(bs
);
1812 if (qemu_in_coroutine()) {
1813 /* Fast-path if already in coroutine context */
1814 bdrv_rw_co_entry(&rwco
);
1816 co
= qemu_coroutine_create(bdrv_rw_co_entry
);
1817 qemu_coroutine_enter(co
, &rwco
);
1818 while (rwco
.ret
== NOT_DONE
) {
1825 /* return < 0 if error. See bdrv_write() for the return codes */
1826 int bdrv_read(BlockDriverState
*bs
, int64_t sector_num
,
1827 uint8_t *buf
, int nb_sectors
)
1829 return bdrv_rw_co(bs
, sector_num
, buf
, nb_sectors
, false);
1832 /* Just like bdrv_read(), but with I/O throttling temporarily disabled */
1833 int bdrv_read_unthrottled(BlockDriverState
*bs
, int64_t sector_num
,
1834 uint8_t *buf
, int nb_sectors
)
1839 enabled
= bs
->io_limits_enabled
;
1840 bs
->io_limits_enabled
= false;
1841 ret
= bdrv_read(bs
, 0, buf
, 1);
1842 bs
->io_limits_enabled
= enabled
;
1846 #define BITS_PER_LONG (sizeof(unsigned long) * 8)
1848 static void set_dirty_bitmap(BlockDriverState
*bs
, int64_t sector_num
,
1849 int nb_sectors
, int dirty
)
1852 unsigned long val
, idx
, bit
;
1854 start
= sector_num
/ BDRV_SECTORS_PER_DIRTY_CHUNK
;
1855 end
= (sector_num
+ nb_sectors
- 1) / BDRV_SECTORS_PER_DIRTY_CHUNK
;
1857 for (; start
<= end
; start
++) {
1858 idx
= start
/ BITS_PER_LONG
;
1859 bit
= start
% BITS_PER_LONG
;
1860 val
= bs
->dirty_bitmap
[idx
];
1862 if (!(val
& (1UL << bit
))) {
1867 if (val
& (1UL << bit
)) {
1869 val
&= ~(1UL << bit
);
1872 bs
->dirty_bitmap
[idx
] = val
;
1876 /* Return < 0 if error. Important errors are:
1877 -EIO generic I/O error (may happen for all errors)
1878 -ENOMEDIUM No media inserted.
1879 -EINVAL Invalid sector number or nb_sectors
1880 -EACCES Trying to write a read-only device
1882 int bdrv_write(BlockDriverState
*bs
, int64_t sector_num
,
1883 const uint8_t *buf
, int nb_sectors
)
1885 return bdrv_rw_co(bs
, sector_num
, (uint8_t *)buf
, nb_sectors
, true);
1888 int bdrv_pread(BlockDriverState
*bs
, int64_t offset
,
1889 void *buf
, int count1
)
1891 uint8_t tmp_buf
[BDRV_SECTOR_SIZE
];
1892 int len
, nb_sectors
, count
;
1897 /* first read to align to sector start */
1898 len
= (BDRV_SECTOR_SIZE
- offset
) & (BDRV_SECTOR_SIZE
- 1);
1901 sector_num
= offset
>> BDRV_SECTOR_BITS
;
1903 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
1905 memcpy(buf
, tmp_buf
+ (offset
& (BDRV_SECTOR_SIZE
- 1)), len
);
1913 /* read the sectors "in place" */
1914 nb_sectors
= count
>> BDRV_SECTOR_BITS
;
1915 if (nb_sectors
> 0) {
1916 if ((ret
= bdrv_read(bs
, sector_num
, buf
, nb_sectors
)) < 0)
1918 sector_num
+= nb_sectors
;
1919 len
= nb_sectors
<< BDRV_SECTOR_BITS
;
1924 /* add data from the last sector */
1926 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
1928 memcpy(buf
, tmp_buf
, count
);
1933 int bdrv_pwrite(BlockDriverState
*bs
, int64_t offset
,
1934 const void *buf
, int count1
)
1936 uint8_t tmp_buf
[BDRV_SECTOR_SIZE
];
1937 int len
, nb_sectors
, count
;
1942 /* first write to align to sector start */
1943 len
= (BDRV_SECTOR_SIZE
- offset
) & (BDRV_SECTOR_SIZE
- 1);
1946 sector_num
= offset
>> BDRV_SECTOR_BITS
;
1948 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
1950 memcpy(tmp_buf
+ (offset
& (BDRV_SECTOR_SIZE
- 1)), buf
, len
);
1951 if ((ret
= bdrv_write(bs
, sector_num
, tmp_buf
, 1)) < 0)
1960 /* write the sectors "in place" */
1961 nb_sectors
= count
>> BDRV_SECTOR_BITS
;
1962 if (nb_sectors
> 0) {
1963 if ((ret
= bdrv_write(bs
, sector_num
, buf
, nb_sectors
)) < 0)
1965 sector_num
+= nb_sectors
;
1966 len
= nb_sectors
<< BDRV_SECTOR_BITS
;
1971 /* add data from the last sector */
1973 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
1975 memcpy(tmp_buf
, buf
, count
);
1976 if ((ret
= bdrv_write(bs
, sector_num
, tmp_buf
, 1)) < 0)
1983 * Writes to the file and ensures that no writes are reordered across this
1984 * request (acts as a barrier)
1986 * Returns 0 on success, -errno in error cases.
1988 int bdrv_pwrite_sync(BlockDriverState
*bs
, int64_t offset
,
1989 const void *buf
, int count
)
1993 ret
= bdrv_pwrite(bs
, offset
, buf
, count
);
1998 /* No flush needed for cache modes that already do it */
1999 if (bs
->enable_write_cache
) {
2006 static int coroutine_fn
bdrv_co_do_copy_on_readv(BlockDriverState
*bs
,
2007 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
)
2009 /* Perform I/O through a temporary buffer so that users who scribble over
2010 * their read buffer while the operation is in progress do not end up
2011 * modifying the image file. This is critical for zero-copy guest I/O
2012 * where anything might happen inside guest memory.
2014 void *bounce_buffer
;
2016 BlockDriver
*drv
= bs
->drv
;
2018 QEMUIOVector bounce_qiov
;
2019 int64_t cluster_sector_num
;
2020 int cluster_nb_sectors
;
2024 /* Cover entire cluster so no additional backing file I/O is required when
2025 * allocating cluster in the image file.
2027 round_to_clusters(bs
, sector_num
, nb_sectors
,
2028 &cluster_sector_num
, &cluster_nb_sectors
);
2030 trace_bdrv_co_do_copy_on_readv(bs
, sector_num
, nb_sectors
,
2031 cluster_sector_num
, cluster_nb_sectors
);
2033 iov
.iov_len
= cluster_nb_sectors
* BDRV_SECTOR_SIZE
;
2034 iov
.iov_base
= bounce_buffer
= qemu_blockalign(bs
, iov
.iov_len
);
2035 qemu_iovec_init_external(&bounce_qiov
, &iov
, 1);
2037 ret
= drv
->bdrv_co_readv(bs
, cluster_sector_num
, cluster_nb_sectors
,
2043 if (drv
->bdrv_co_write_zeroes
&&
2044 buffer_is_zero(bounce_buffer
, iov
.iov_len
)) {
2045 ret
= bdrv_co_do_write_zeroes(bs
, cluster_sector_num
,
2046 cluster_nb_sectors
);
2048 /* This does not change the data on the disk, it is not necessary
2049 * to flush even in cache=writethrough mode.
2051 ret
= drv
->bdrv_co_writev(bs
, cluster_sector_num
, cluster_nb_sectors
,
2056 /* It might be okay to ignore write errors for guest requests. If this
2057 * is a deliberate copy-on-read then we don't want to ignore the error.
2058 * Simply report it in all cases.
2063 skip_bytes
= (sector_num
- cluster_sector_num
) * BDRV_SECTOR_SIZE
;
2064 qemu_iovec_from_buf(qiov
, 0, bounce_buffer
+ skip_bytes
,
2065 nb_sectors
* BDRV_SECTOR_SIZE
);
2068 qemu_vfree(bounce_buffer
);
2073 * Handle a read request in coroutine context
2075 static int coroutine_fn
bdrv_co_do_readv(BlockDriverState
*bs
,
2076 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
,
2077 BdrvRequestFlags flags
)
2079 BlockDriver
*drv
= bs
->drv
;
2080 BdrvTrackedRequest req
;
2086 if (bdrv_check_request(bs
, sector_num
, nb_sectors
)) {
2090 /* throttling disk read I/O */
2091 if (bs
->io_limits_enabled
) {
2092 bdrv_io_limits_intercept(bs
, false, nb_sectors
);
2095 if (bs
->copy_on_read
) {
2096 flags
|= BDRV_REQ_COPY_ON_READ
;
2098 if (flags
& BDRV_REQ_COPY_ON_READ
) {
2099 bs
->copy_on_read_in_flight
++;
2102 if (bs
->copy_on_read_in_flight
) {
2103 wait_for_overlapping_requests(bs
, sector_num
, nb_sectors
);
2106 tracked_request_begin(&req
, bs
, sector_num
, nb_sectors
, false);
2108 if (flags
& BDRV_REQ_COPY_ON_READ
) {
2111 ret
= bdrv_co_is_allocated(bs
, sector_num
, nb_sectors
, &pnum
);
2116 if (!ret
|| pnum
!= nb_sectors
) {
2117 ret
= bdrv_co_do_copy_on_readv(bs
, sector_num
, nb_sectors
, qiov
);
2122 ret
= drv
->bdrv_co_readv(bs
, sector_num
, nb_sectors
, qiov
);
2125 tracked_request_end(&req
);
2127 if (flags
& BDRV_REQ_COPY_ON_READ
) {
2128 bs
->copy_on_read_in_flight
--;
2134 int coroutine_fn
bdrv_co_readv(BlockDriverState
*bs
, int64_t sector_num
,
2135 int nb_sectors
, QEMUIOVector
*qiov
)
2137 trace_bdrv_co_readv(bs
, sector_num
, nb_sectors
);
2139 return bdrv_co_do_readv(bs
, sector_num
, nb_sectors
, qiov
, 0);
2142 int coroutine_fn
bdrv_co_copy_on_readv(BlockDriverState
*bs
,
2143 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
)
2145 trace_bdrv_co_copy_on_readv(bs
, sector_num
, nb_sectors
);
2147 return bdrv_co_do_readv(bs
, sector_num
, nb_sectors
, qiov
,
2148 BDRV_REQ_COPY_ON_READ
);
2151 static int coroutine_fn
bdrv_co_do_write_zeroes(BlockDriverState
*bs
,
2152 int64_t sector_num
, int nb_sectors
)
2154 BlockDriver
*drv
= bs
->drv
;
2159 /* TODO Emulate only part of misaligned requests instead of letting block
2160 * drivers return -ENOTSUP and emulate everything */
2162 /* First try the efficient write zeroes operation */
2163 if (drv
->bdrv_co_write_zeroes
) {
2164 ret
= drv
->bdrv_co_write_zeroes(bs
, sector_num
, nb_sectors
);
2165 if (ret
!= -ENOTSUP
) {
2170 /* Fall back to bounce buffer if write zeroes is unsupported */
2171 iov
.iov_len
= nb_sectors
* BDRV_SECTOR_SIZE
;
2172 iov
.iov_base
= qemu_blockalign(bs
, iov
.iov_len
);
2173 memset(iov
.iov_base
, 0, iov
.iov_len
);
2174 qemu_iovec_init_external(&qiov
, &iov
, 1);
2176 ret
= drv
->bdrv_co_writev(bs
, sector_num
, nb_sectors
, &qiov
);
2178 qemu_vfree(iov
.iov_base
);
2183 * Handle a write request in coroutine context
2185 static int coroutine_fn
bdrv_co_do_writev(BlockDriverState
*bs
,
2186 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
,
2187 BdrvRequestFlags flags
)
2189 BlockDriver
*drv
= bs
->drv
;
2190 BdrvTrackedRequest req
;
2196 if (bs
->read_only
) {
2199 if (bdrv_check_request(bs
, sector_num
, nb_sectors
)) {
2203 /* throttling disk write I/O */
2204 if (bs
->io_limits_enabled
) {
2205 bdrv_io_limits_intercept(bs
, true, nb_sectors
);
2208 if (bs
->copy_on_read_in_flight
) {
2209 wait_for_overlapping_requests(bs
, sector_num
, nb_sectors
);
2212 tracked_request_begin(&req
, bs
, sector_num
, nb_sectors
, true);
2214 if (flags
& BDRV_REQ_ZERO_WRITE
) {
2215 ret
= bdrv_co_do_write_zeroes(bs
, sector_num
, nb_sectors
);
2217 ret
= drv
->bdrv_co_writev(bs
, sector_num
, nb_sectors
, qiov
);
2220 if (ret
== 0 && !bs
->enable_write_cache
) {
2221 ret
= bdrv_co_flush(bs
);
2224 if (bs
->dirty_bitmap
) {
2225 set_dirty_bitmap(bs
, sector_num
, nb_sectors
, 1);
2228 if (bs
->wr_highest_sector
< sector_num
+ nb_sectors
- 1) {
2229 bs
->wr_highest_sector
= sector_num
+ nb_sectors
- 1;
2232 tracked_request_end(&req
);
2237 int coroutine_fn
bdrv_co_writev(BlockDriverState
*bs
, int64_t sector_num
,
2238 int nb_sectors
, QEMUIOVector
*qiov
)
2240 trace_bdrv_co_writev(bs
, sector_num
, nb_sectors
);
2242 return bdrv_co_do_writev(bs
, sector_num
, nb_sectors
, qiov
, 0);
2245 int coroutine_fn
bdrv_co_write_zeroes(BlockDriverState
*bs
,
2246 int64_t sector_num
, int nb_sectors
)
2248 trace_bdrv_co_write_zeroes(bs
, sector_num
, nb_sectors
);
2250 return bdrv_co_do_writev(bs
, sector_num
, nb_sectors
, NULL
,
2251 BDRV_REQ_ZERO_WRITE
);
2255 * Truncate file to 'offset' bytes (needed only for file protocols)
2257 int bdrv_truncate(BlockDriverState
*bs
, int64_t offset
)
2259 BlockDriver
*drv
= bs
->drv
;
2263 if (!drv
->bdrv_truncate
)
2267 if (bdrv_in_use(bs
))
2269 ret
= drv
->bdrv_truncate(bs
, offset
);
2271 ret
= refresh_total_sectors(bs
, offset
>> BDRV_SECTOR_BITS
);
2272 bdrv_dev_resize_cb(bs
);
2278 * Length of a allocated file in bytes. Sparse files are counted by actual
2279 * allocated space. Return < 0 if error or unknown.
2281 int64_t bdrv_get_allocated_file_size(BlockDriverState
*bs
)
2283 BlockDriver
*drv
= bs
->drv
;
2287 if (drv
->bdrv_get_allocated_file_size
) {
2288 return drv
->bdrv_get_allocated_file_size(bs
);
2291 return bdrv_get_allocated_file_size(bs
->file
);
2297 * Length of a file in bytes. Return < 0 if error or unknown.
2299 int64_t bdrv_getlength(BlockDriverState
*bs
)
2301 BlockDriver
*drv
= bs
->drv
;
2305 if (bs
->growable
|| bdrv_dev_has_removable_media(bs
)) {
2306 if (drv
->bdrv_getlength
) {
2307 return drv
->bdrv_getlength(bs
);
2310 return bs
->total_sectors
* BDRV_SECTOR_SIZE
;
2313 /* return 0 as number of sectors if no device present or error */
2314 void bdrv_get_geometry(BlockDriverState
*bs
, uint64_t *nb_sectors_ptr
)
2317 length
= bdrv_getlength(bs
);
2321 length
= length
>> BDRV_SECTOR_BITS
;
2322 *nb_sectors_ptr
= length
;
2325 /* throttling disk io limits */
2326 void bdrv_set_io_limits(BlockDriverState
*bs
,
2327 BlockIOLimit
*io_limits
)
2329 bs
->io_limits
= *io_limits
;
2330 bs
->io_limits_enabled
= bdrv_io_limits_enabled(bs
);
2333 void bdrv_set_on_error(BlockDriverState
*bs
, BlockErrorAction on_read_error
,
2334 BlockErrorAction on_write_error
)
2336 bs
->on_read_error
= on_read_error
;
2337 bs
->on_write_error
= on_write_error
;
2340 BlockErrorAction
bdrv_get_on_error(BlockDriverState
*bs
, int is_read
)
2342 return is_read
? bs
->on_read_error
: bs
->on_write_error
;
2345 int bdrv_is_read_only(BlockDriverState
*bs
)
2347 return bs
->read_only
;
2350 int bdrv_is_sg(BlockDriverState
*bs
)
2355 int bdrv_enable_write_cache(BlockDriverState
*bs
)
2357 return bs
->enable_write_cache
;
2360 void bdrv_set_enable_write_cache(BlockDriverState
*bs
, bool wce
)
2362 bs
->enable_write_cache
= wce
;
2364 /* so a reopen() will preserve wce */
2366 bs
->open_flags
|= BDRV_O_CACHE_WB
;
2368 bs
->open_flags
&= ~BDRV_O_CACHE_WB
;
2372 int bdrv_is_encrypted(BlockDriverState
*bs
)
2374 if (bs
->backing_hd
&& bs
->backing_hd
->encrypted
)
2376 return bs
->encrypted
;
2379 int bdrv_key_required(BlockDriverState
*bs
)
2381 BlockDriverState
*backing_hd
= bs
->backing_hd
;
2383 if (backing_hd
&& backing_hd
->encrypted
&& !backing_hd
->valid_key
)
2385 return (bs
->encrypted
&& !bs
->valid_key
);
2388 int bdrv_set_key(BlockDriverState
*bs
, const char *key
)
2391 if (bs
->backing_hd
&& bs
->backing_hd
->encrypted
) {
2392 ret
= bdrv_set_key(bs
->backing_hd
, key
);
2398 if (!bs
->encrypted
) {
2400 } else if (!bs
->drv
|| !bs
->drv
->bdrv_set_key
) {
2403 ret
= bs
->drv
->bdrv_set_key(bs
, key
);
2406 } else if (!bs
->valid_key
) {
2408 /* call the change callback now, we skipped it on open */
2409 bdrv_dev_change_media_cb(bs
, true);
2414 const char *bdrv_get_format_name(BlockDriverState
*bs
)
2416 return bs
->drv
? bs
->drv
->format_name
: NULL
;
2419 void bdrv_iterate_format(void (*it
)(void *opaque
, const char *name
),
2424 QLIST_FOREACH(drv
, &bdrv_drivers
, list
) {
2425 it(opaque
, drv
->format_name
);
2429 BlockDriverState
*bdrv_find(const char *name
)
2431 BlockDriverState
*bs
;
2433 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2434 if (!strcmp(name
, bs
->device_name
)) {
2441 BlockDriverState
*bdrv_next(BlockDriverState
*bs
)
2444 return QTAILQ_FIRST(&bdrv_states
);
2446 return QTAILQ_NEXT(bs
, list
);
2449 void bdrv_iterate(void (*it
)(void *opaque
, BlockDriverState
*bs
), void *opaque
)
2451 BlockDriverState
*bs
;
2453 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2458 const char *bdrv_get_device_name(BlockDriverState
*bs
)
2460 return bs
->device_name
;
2463 int bdrv_get_flags(BlockDriverState
*bs
)
2465 return bs
->open_flags
;
2468 void bdrv_flush_all(void)
2470 BlockDriverState
*bs
;
2472 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2477 int bdrv_has_zero_init(BlockDriverState
*bs
)
2481 if (bs
->drv
->bdrv_has_zero_init
) {
2482 return bs
->drv
->bdrv_has_zero_init(bs
);
2488 typedef struct BdrvCoIsAllocatedData
{
2489 BlockDriverState
*bs
;
2495 } BdrvCoIsAllocatedData
;
2498 * Returns true iff the specified sector is present in the disk image. Drivers
2499 * not implementing the functionality are assumed to not support backing files,
2500 * hence all their sectors are reported as allocated.
2502 * If 'sector_num' is beyond the end of the disk image the return value is 0
2503 * and 'pnum' is set to 0.
2505 * 'pnum' is set to the number of sectors (including and immediately following
2506 * the specified sector) that are known to be in the same
2507 * allocated/unallocated state.
2509 * 'nb_sectors' is the max value 'pnum' should be set to. If nb_sectors goes
2510 * beyond the end of the disk image it will be clamped.
2512 int coroutine_fn
bdrv_co_is_allocated(BlockDriverState
*bs
, int64_t sector_num
,
2513 int nb_sectors
, int *pnum
)
2517 if (sector_num
>= bs
->total_sectors
) {
2522 n
= bs
->total_sectors
- sector_num
;
2523 if (n
< nb_sectors
) {
2527 if (!bs
->drv
->bdrv_co_is_allocated
) {
2532 return bs
->drv
->bdrv_co_is_allocated(bs
, sector_num
, nb_sectors
, pnum
);
2535 /* Coroutine wrapper for bdrv_is_allocated() */
2536 static void coroutine_fn
bdrv_is_allocated_co_entry(void *opaque
)
2538 BdrvCoIsAllocatedData
*data
= opaque
;
2539 BlockDriverState
*bs
= data
->bs
;
2541 data
->ret
= bdrv_co_is_allocated(bs
, data
->sector_num
, data
->nb_sectors
,
2547 * Synchronous wrapper around bdrv_co_is_allocated().
2549 * See bdrv_co_is_allocated() for details.
2551 int bdrv_is_allocated(BlockDriverState
*bs
, int64_t sector_num
, int nb_sectors
,
2555 BdrvCoIsAllocatedData data
= {
2557 .sector_num
= sector_num
,
2558 .nb_sectors
= nb_sectors
,
2563 co
= qemu_coroutine_create(bdrv_is_allocated_co_entry
);
2564 qemu_coroutine_enter(co
, &data
);
2565 while (!data
.done
) {
2572 * Given an image chain: ... -> [BASE] -> [INTER1] -> [INTER2] -> [TOP]
2574 * Return true if the given sector is allocated in any image between
2575 * BASE and TOP (inclusive). BASE can be NULL to check if the given
2576 * sector is allocated in any image of the chain. Return false otherwise.
2578 * 'pnum' is set to the number of sectors (including and immediately following
2579 * the specified sector) that are known to be in the same
2580 * allocated/unallocated state.
2583 int coroutine_fn
bdrv_co_is_allocated_above(BlockDriverState
*top
,
2584 BlockDriverState
*base
,
2586 int nb_sectors
, int *pnum
)
2588 BlockDriverState
*intermediate
;
2589 int ret
, n
= nb_sectors
;
2592 while (intermediate
&& intermediate
!= base
) {
2594 ret
= bdrv_co_is_allocated(intermediate
, sector_num
, nb_sectors
,
2604 * [sector_num, nb_sectors] is unallocated on top but intermediate
2607 * [sector_num+x, nr_sectors] allocated.
2609 if (n
> pnum_inter
) {
2613 intermediate
= intermediate
->backing_hd
;
2620 BlockInfoList
*qmp_query_block(Error
**errp
)
2622 BlockInfoList
*head
= NULL
, *cur_item
= NULL
;
2623 BlockDriverState
*bs
;
2625 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2626 BlockInfoList
*info
= g_malloc0(sizeof(*info
));
2628 info
->value
= g_malloc0(sizeof(*info
->value
));
2629 info
->value
->device
= g_strdup(bs
->device_name
);
2630 info
->value
->type
= g_strdup("unknown");
2631 info
->value
->locked
= bdrv_dev_is_medium_locked(bs
);
2632 info
->value
->removable
= bdrv_dev_has_removable_media(bs
);
2634 if (bdrv_dev_has_removable_media(bs
)) {
2635 info
->value
->has_tray_open
= true;
2636 info
->value
->tray_open
= bdrv_dev_is_tray_open(bs
);
2639 if (bdrv_iostatus_is_enabled(bs
)) {
2640 info
->value
->has_io_status
= true;
2641 info
->value
->io_status
= bs
->iostatus
;
2645 info
->value
->has_inserted
= true;
2646 info
->value
->inserted
= g_malloc0(sizeof(*info
->value
->inserted
));
2647 info
->value
->inserted
->file
= g_strdup(bs
->filename
);
2648 info
->value
->inserted
->ro
= bs
->read_only
;
2649 info
->value
->inserted
->drv
= g_strdup(bs
->drv
->format_name
);
2650 info
->value
->inserted
->encrypted
= bs
->encrypted
;
2651 info
->value
->inserted
->encryption_key_missing
= bdrv_key_required(bs
);
2652 if (bs
->backing_file
[0]) {
2653 info
->value
->inserted
->has_backing_file
= true;
2654 info
->value
->inserted
->backing_file
= g_strdup(bs
->backing_file
);
2657 info
->value
->inserted
->backing_file_depth
=
2658 bdrv_get_backing_file_depth(bs
);
2660 if (bs
->io_limits_enabled
) {
2661 info
->value
->inserted
->bps
=
2662 bs
->io_limits
.bps
[BLOCK_IO_LIMIT_TOTAL
];
2663 info
->value
->inserted
->bps_rd
=
2664 bs
->io_limits
.bps
[BLOCK_IO_LIMIT_READ
];
2665 info
->value
->inserted
->bps_wr
=
2666 bs
->io_limits
.bps
[BLOCK_IO_LIMIT_WRITE
];
2667 info
->value
->inserted
->iops
=
2668 bs
->io_limits
.iops
[BLOCK_IO_LIMIT_TOTAL
];
2669 info
->value
->inserted
->iops_rd
=
2670 bs
->io_limits
.iops
[BLOCK_IO_LIMIT_READ
];
2671 info
->value
->inserted
->iops_wr
=
2672 bs
->io_limits
.iops
[BLOCK_IO_LIMIT_WRITE
];
2676 /* XXX: waiting for the qapi to support GSList */
2678 head
= cur_item
= info
;
2680 cur_item
->next
= info
;
2688 /* Consider exposing this as a full fledged QMP command */
2689 static BlockStats
*qmp_query_blockstat(const BlockDriverState
*bs
, Error
**errp
)
2693 s
= g_malloc0(sizeof(*s
));
2695 if (bs
->device_name
[0]) {
2696 s
->has_device
= true;
2697 s
->device
= g_strdup(bs
->device_name
);
2700 s
->stats
= g_malloc0(sizeof(*s
->stats
));
2701 s
->stats
->rd_bytes
= bs
->nr_bytes
[BDRV_ACCT_READ
];
2702 s
->stats
->wr_bytes
= bs
->nr_bytes
[BDRV_ACCT_WRITE
];
2703 s
->stats
->rd_operations
= bs
->nr_ops
[BDRV_ACCT_READ
];
2704 s
->stats
->wr_operations
= bs
->nr_ops
[BDRV_ACCT_WRITE
];
2705 s
->stats
->wr_highest_offset
= bs
->wr_highest_sector
* BDRV_SECTOR_SIZE
;
2706 s
->stats
->flush_operations
= bs
->nr_ops
[BDRV_ACCT_FLUSH
];
2707 s
->stats
->wr_total_time_ns
= bs
->total_time_ns
[BDRV_ACCT_WRITE
];
2708 s
->stats
->rd_total_time_ns
= bs
->total_time_ns
[BDRV_ACCT_READ
];
2709 s
->stats
->flush_total_time_ns
= bs
->total_time_ns
[BDRV_ACCT_FLUSH
];
2712 s
->has_parent
= true;
2713 s
->parent
= qmp_query_blockstat(bs
->file
, NULL
);
2719 BlockStatsList
*qmp_query_blockstats(Error
**errp
)
2721 BlockStatsList
*head
= NULL
, *cur_item
= NULL
;
2722 BlockDriverState
*bs
;
2724 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2725 BlockStatsList
*info
= g_malloc0(sizeof(*info
));
2726 info
->value
= qmp_query_blockstat(bs
, NULL
);
2728 /* XXX: waiting for the qapi to support GSList */
2730 head
= cur_item
= info
;
2732 cur_item
->next
= info
;
2740 const char *bdrv_get_encrypted_filename(BlockDriverState
*bs
)
2742 if (bs
->backing_hd
&& bs
->backing_hd
->encrypted
)
2743 return bs
->backing_file
;
2744 else if (bs
->encrypted
)
2745 return bs
->filename
;
2750 void bdrv_get_backing_filename(BlockDriverState
*bs
,
2751 char *filename
, int filename_size
)
2753 pstrcpy(filename
, filename_size
, bs
->backing_file
);
2756 int bdrv_write_compressed(BlockDriverState
*bs
, int64_t sector_num
,
2757 const uint8_t *buf
, int nb_sectors
)
2759 BlockDriver
*drv
= bs
->drv
;
2762 if (!drv
->bdrv_write_compressed
)
2764 if (bdrv_check_request(bs
, sector_num
, nb_sectors
))
2767 if (bs
->dirty_bitmap
) {
2768 set_dirty_bitmap(bs
, sector_num
, nb_sectors
, 1);
2771 return drv
->bdrv_write_compressed(bs
, sector_num
, buf
, nb_sectors
);
2774 int bdrv_get_info(BlockDriverState
*bs
, BlockDriverInfo
*bdi
)
2776 BlockDriver
*drv
= bs
->drv
;
2779 if (!drv
->bdrv_get_info
)
2781 memset(bdi
, 0, sizeof(*bdi
));
2782 return drv
->bdrv_get_info(bs
, bdi
);
2785 int bdrv_save_vmstate(BlockDriverState
*bs
, const uint8_t *buf
,
2786 int64_t pos
, int size
)
2788 BlockDriver
*drv
= bs
->drv
;
2791 if (drv
->bdrv_save_vmstate
)
2792 return drv
->bdrv_save_vmstate(bs
, buf
, pos
, size
);
2794 return bdrv_save_vmstate(bs
->file
, buf
, pos
, size
);
2798 int bdrv_load_vmstate(BlockDriverState
*bs
, uint8_t *buf
,
2799 int64_t pos
, int size
)
2801 BlockDriver
*drv
= bs
->drv
;
2804 if (drv
->bdrv_load_vmstate
)
2805 return drv
->bdrv_load_vmstate(bs
, buf
, pos
, size
);
2807 return bdrv_load_vmstate(bs
->file
, buf
, pos
, size
);
2811 void bdrv_debug_event(BlockDriverState
*bs
, BlkDebugEvent event
)
2813 BlockDriver
*drv
= bs
->drv
;
2815 if (!drv
|| !drv
->bdrv_debug_event
) {
2819 drv
->bdrv_debug_event(bs
, event
);
2823 /**************************************************************/
2824 /* handling of snapshots */
2826 int bdrv_can_snapshot(BlockDriverState
*bs
)
2828 BlockDriver
*drv
= bs
->drv
;
2829 if (!drv
|| !bdrv_is_inserted(bs
) || bdrv_is_read_only(bs
)) {
2833 if (!drv
->bdrv_snapshot_create
) {
2834 if (bs
->file
!= NULL
) {
2835 return bdrv_can_snapshot(bs
->file
);
2843 int bdrv_is_snapshot(BlockDriverState
*bs
)
2845 return !!(bs
->open_flags
& BDRV_O_SNAPSHOT
);
2848 BlockDriverState
*bdrv_snapshots(void)
2850 BlockDriverState
*bs
;
2853 return bs_snapshots
;
2857 while ((bs
= bdrv_next(bs
))) {
2858 if (bdrv_can_snapshot(bs
)) {
2866 int bdrv_snapshot_create(BlockDriverState
*bs
,
2867 QEMUSnapshotInfo
*sn_info
)
2869 BlockDriver
*drv
= bs
->drv
;
2872 if (drv
->bdrv_snapshot_create
)
2873 return drv
->bdrv_snapshot_create(bs
, sn_info
);
2875 return bdrv_snapshot_create(bs
->file
, sn_info
);
2879 int bdrv_snapshot_goto(BlockDriverState
*bs
,
2880 const char *snapshot_id
)
2882 BlockDriver
*drv
= bs
->drv
;
2887 if (drv
->bdrv_snapshot_goto
)
2888 return drv
->bdrv_snapshot_goto(bs
, snapshot_id
);
2891 drv
->bdrv_close(bs
);
2892 ret
= bdrv_snapshot_goto(bs
->file
, snapshot_id
);
2893 open_ret
= drv
->bdrv_open(bs
, bs
->open_flags
);
2895 bdrv_delete(bs
->file
);
2905 int bdrv_snapshot_delete(BlockDriverState
*bs
, const char *snapshot_id
)
2907 BlockDriver
*drv
= bs
->drv
;
2910 if (drv
->bdrv_snapshot_delete
)
2911 return drv
->bdrv_snapshot_delete(bs
, snapshot_id
);
2913 return bdrv_snapshot_delete(bs
->file
, snapshot_id
);
2917 int bdrv_snapshot_list(BlockDriverState
*bs
,
2918 QEMUSnapshotInfo
**psn_info
)
2920 BlockDriver
*drv
= bs
->drv
;
2923 if (drv
->bdrv_snapshot_list
)
2924 return drv
->bdrv_snapshot_list(bs
, psn_info
);
2926 return bdrv_snapshot_list(bs
->file
, psn_info
);
2930 int bdrv_snapshot_load_tmp(BlockDriverState
*bs
,
2931 const char *snapshot_name
)
2933 BlockDriver
*drv
= bs
->drv
;
2937 if (!bs
->read_only
) {
2940 if (drv
->bdrv_snapshot_load_tmp
) {
2941 return drv
->bdrv_snapshot_load_tmp(bs
, snapshot_name
);
2946 BlockDriverState
*bdrv_find_backing_image(BlockDriverState
*bs
,
2947 const char *backing_file
)
2953 if (bs
->backing_hd
) {
2954 if (strcmp(bs
->backing_file
, backing_file
) == 0) {
2955 return bs
->backing_hd
;
2957 return bdrv_find_backing_image(bs
->backing_hd
, backing_file
);
2964 int bdrv_get_backing_file_depth(BlockDriverState
*bs
)
2970 if (!bs
->backing_hd
) {
2974 return 1 + bdrv_get_backing_file_depth(bs
->backing_hd
);
2977 #define NB_SUFFIXES 4
2979 char *get_human_readable_size(char *buf
, int buf_size
, int64_t size
)
2981 static const char suffixes
[NB_SUFFIXES
] = "KMGT";
2986 snprintf(buf
, buf_size
, "%" PRId64
, size
);
2989 for(i
= 0; i
< NB_SUFFIXES
; i
++) {
2990 if (size
< (10 * base
)) {
2991 snprintf(buf
, buf_size
, "%0.1f%c",
2992 (double)size
/ base
,
2995 } else if (size
< (1000 * base
) || i
== (NB_SUFFIXES
- 1)) {
2996 snprintf(buf
, buf_size
, "%" PRId64
"%c",
2997 ((size
+ (base
>> 1)) / base
),
3007 char *bdrv_snapshot_dump(char *buf
, int buf_size
, QEMUSnapshotInfo
*sn
)
3009 char buf1
[128], date_buf
[128], clock_buf
[128];
3019 snprintf(buf
, buf_size
,
3020 "%-10s%-20s%7s%20s%15s",
3021 "ID", "TAG", "VM SIZE", "DATE", "VM CLOCK");
3025 ptm
= localtime(&ti
);
3026 strftime(date_buf
, sizeof(date_buf
),
3027 "%Y-%m-%d %H:%M:%S", ptm
);
3029 localtime_r(&ti
, &tm
);
3030 strftime(date_buf
, sizeof(date_buf
),
3031 "%Y-%m-%d %H:%M:%S", &tm
);
3033 secs
= sn
->vm_clock_nsec
/ 1000000000;
3034 snprintf(clock_buf
, sizeof(clock_buf
),
3035 "%02d:%02d:%02d.%03d",
3037 (int)((secs
/ 60) % 60),
3039 (int)((sn
->vm_clock_nsec
/ 1000000) % 1000));
3040 snprintf(buf
, buf_size
,
3041 "%-10s%-20s%7s%20s%15s",
3042 sn
->id_str
, sn
->name
,
3043 get_human_readable_size(buf1
, sizeof(buf1
), sn
->vm_state_size
),
3050 /**************************************************************/
3053 BlockDriverAIOCB
*bdrv_aio_readv(BlockDriverState
*bs
, int64_t sector_num
,
3054 QEMUIOVector
*qiov
, int nb_sectors
,
3055 BlockDriverCompletionFunc
*cb
, void *opaque
)
3057 trace_bdrv_aio_readv(bs
, sector_num
, nb_sectors
, opaque
);
3059 return bdrv_co_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
,
3063 BlockDriverAIOCB
*bdrv_aio_writev(BlockDriverState
*bs
, int64_t sector_num
,
3064 QEMUIOVector
*qiov
, int nb_sectors
,
3065 BlockDriverCompletionFunc
*cb
, void *opaque
)
3067 trace_bdrv_aio_writev(bs
, sector_num
, nb_sectors
, opaque
);
3069 return bdrv_co_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
,
3074 typedef struct MultiwriteCB
{
3079 BlockDriverCompletionFunc
*cb
;
3081 QEMUIOVector
*free_qiov
;
3085 static void multiwrite_user_cb(MultiwriteCB
*mcb
)
3089 for (i
= 0; i
< mcb
->num_callbacks
; i
++) {
3090 mcb
->callbacks
[i
].cb(mcb
->callbacks
[i
].opaque
, mcb
->error
);
3091 if (mcb
->callbacks
[i
].free_qiov
) {
3092 qemu_iovec_destroy(mcb
->callbacks
[i
].free_qiov
);
3094 g_free(mcb
->callbacks
[i
].free_qiov
);
3098 static void multiwrite_cb(void *opaque
, int ret
)
3100 MultiwriteCB
*mcb
= opaque
;
3102 trace_multiwrite_cb(mcb
, ret
);
3104 if (ret
< 0 && !mcb
->error
) {
3108 mcb
->num_requests
--;
3109 if (mcb
->num_requests
== 0) {
3110 multiwrite_user_cb(mcb
);
3115 static int multiwrite_req_compare(const void *a
, const void *b
)
3117 const BlockRequest
*req1
= a
, *req2
= b
;
3120 * Note that we can't simply subtract req2->sector from req1->sector
3121 * here as that could overflow the return value.
3123 if (req1
->sector
> req2
->sector
) {
3125 } else if (req1
->sector
< req2
->sector
) {
3133 * Takes a bunch of requests and tries to merge them. Returns the number of
3134 * requests that remain after merging.
3136 static int multiwrite_merge(BlockDriverState
*bs
, BlockRequest
*reqs
,
3137 int num_reqs
, MultiwriteCB
*mcb
)
3141 // Sort requests by start sector
3142 qsort(reqs
, num_reqs
, sizeof(*reqs
), &multiwrite_req_compare
);
3144 // Check if adjacent requests touch the same clusters. If so, combine them,
3145 // filling up gaps with zero sectors.
3147 for (i
= 1; i
< num_reqs
; i
++) {
3149 int64_t oldreq_last
= reqs
[outidx
].sector
+ reqs
[outidx
].nb_sectors
;
3151 // Handle exactly sequential writes and overlapping writes.
3152 if (reqs
[i
].sector
<= oldreq_last
) {
3156 if (reqs
[outidx
].qiov
->niov
+ reqs
[i
].qiov
->niov
+ 1 > IOV_MAX
) {
3162 QEMUIOVector
*qiov
= g_malloc0(sizeof(*qiov
));
3163 qemu_iovec_init(qiov
,
3164 reqs
[outidx
].qiov
->niov
+ reqs
[i
].qiov
->niov
+ 1);
3166 // Add the first request to the merged one. If the requests are
3167 // overlapping, drop the last sectors of the first request.
3168 size
= (reqs
[i
].sector
- reqs
[outidx
].sector
) << 9;
3169 qemu_iovec_concat(qiov
, reqs
[outidx
].qiov
, 0, size
);
3171 // We should need to add any zeros between the two requests
3172 assert (reqs
[i
].sector
<= oldreq_last
);
3174 // Add the second request
3175 qemu_iovec_concat(qiov
, reqs
[i
].qiov
, 0, reqs
[i
].qiov
->size
);
3177 reqs
[outidx
].nb_sectors
= qiov
->size
>> 9;
3178 reqs
[outidx
].qiov
= qiov
;
3180 mcb
->callbacks
[i
].free_qiov
= reqs
[outidx
].qiov
;
3183 reqs
[outidx
].sector
= reqs
[i
].sector
;
3184 reqs
[outidx
].nb_sectors
= reqs
[i
].nb_sectors
;
3185 reqs
[outidx
].qiov
= reqs
[i
].qiov
;
3193 * Submit multiple AIO write requests at once.
3195 * On success, the function returns 0 and all requests in the reqs array have
3196 * been submitted. In error case this function returns -1, and any of the
3197 * requests may or may not be submitted yet. In particular, this means that the
3198 * callback will be called for some of the requests, for others it won't. The
3199 * caller must check the error field of the BlockRequest to wait for the right
3200 * callbacks (if error != 0, no callback will be called).
3202 * The implementation may modify the contents of the reqs array, e.g. to merge
3203 * requests. However, the fields opaque and error are left unmodified as they
3204 * are used to signal failure for a single request to the caller.
3206 int bdrv_aio_multiwrite(BlockDriverState
*bs
, BlockRequest
*reqs
, int num_reqs
)
3211 /* don't submit writes if we don't have a medium */
3212 if (bs
->drv
== NULL
) {
3213 for (i
= 0; i
< num_reqs
; i
++) {
3214 reqs
[i
].error
= -ENOMEDIUM
;
3219 if (num_reqs
== 0) {
3223 // Create MultiwriteCB structure
3224 mcb
= g_malloc0(sizeof(*mcb
) + num_reqs
* sizeof(*mcb
->callbacks
));
3225 mcb
->num_requests
= 0;
3226 mcb
->num_callbacks
= num_reqs
;
3228 for (i
= 0; i
< num_reqs
; i
++) {
3229 mcb
->callbacks
[i
].cb
= reqs
[i
].cb
;
3230 mcb
->callbacks
[i
].opaque
= reqs
[i
].opaque
;
3233 // Check for mergable requests
3234 num_reqs
= multiwrite_merge(bs
, reqs
, num_reqs
, mcb
);
3236 trace_bdrv_aio_multiwrite(mcb
, mcb
->num_callbacks
, num_reqs
);
3238 /* Run the aio requests. */
3239 mcb
->num_requests
= num_reqs
;
3240 for (i
= 0; i
< num_reqs
; i
++) {
3241 bdrv_aio_writev(bs
, reqs
[i
].sector
, reqs
[i
].qiov
,
3242 reqs
[i
].nb_sectors
, multiwrite_cb
, mcb
);
3248 void bdrv_aio_cancel(BlockDriverAIOCB
*acb
)
3250 acb
->pool
->cancel(acb
);
3253 /* block I/O throttling */
3254 static bool bdrv_exceed_bps_limits(BlockDriverState
*bs
, int nb_sectors
,
3255 bool is_write
, double elapsed_time
, uint64_t *wait
)
3257 uint64_t bps_limit
= 0;
3258 double bytes_limit
, bytes_base
, bytes_res
;
3259 double slice_time
, wait_time
;
3261 if (bs
->io_limits
.bps
[BLOCK_IO_LIMIT_TOTAL
]) {
3262 bps_limit
= bs
->io_limits
.bps
[BLOCK_IO_LIMIT_TOTAL
];
3263 } else if (bs
->io_limits
.bps
[is_write
]) {
3264 bps_limit
= bs
->io_limits
.bps
[is_write
];
3273 slice_time
= bs
->slice_end
- bs
->slice_start
;
3274 slice_time
/= (NANOSECONDS_PER_SECOND
);
3275 bytes_limit
= bps_limit
* slice_time
;
3276 bytes_base
= bs
->nr_bytes
[is_write
] - bs
->io_base
.bytes
[is_write
];
3277 if (bs
->io_limits
.bps
[BLOCK_IO_LIMIT_TOTAL
]) {
3278 bytes_base
+= bs
->nr_bytes
[!is_write
] - bs
->io_base
.bytes
[!is_write
];
3281 /* bytes_base: the bytes of data which have been read/written; and
3282 * it is obtained from the history statistic info.
3283 * bytes_res: the remaining bytes of data which need to be read/written.
3284 * (bytes_base + bytes_res) / bps_limit: used to calcuate
3285 * the total time for completing reading/writting all data.
3287 bytes_res
= (unsigned) nb_sectors
* BDRV_SECTOR_SIZE
;
3289 if (bytes_base
+ bytes_res
<= bytes_limit
) {
3297 /* Calc approx time to dispatch */
3298 wait_time
= (bytes_base
+ bytes_res
) / bps_limit
- elapsed_time
;
3300 /* When the I/O rate at runtime exceeds the limits,
3301 * bs->slice_end need to be extended in order that the current statistic
3302 * info can be kept until the timer fire, so it is increased and tuned
3303 * based on the result of experiment.
3305 bs
->slice_time
= wait_time
* BLOCK_IO_SLICE_TIME
* 10;
3306 bs
->slice_end
+= bs
->slice_time
- 3 * BLOCK_IO_SLICE_TIME
;
3308 *wait
= wait_time
* BLOCK_IO_SLICE_TIME
* 10;
3314 static bool bdrv_exceed_iops_limits(BlockDriverState
*bs
, bool is_write
,
3315 double elapsed_time
, uint64_t *wait
)
3317 uint64_t iops_limit
= 0;
3318 double ios_limit
, ios_base
;
3319 double slice_time
, wait_time
;
3321 if (bs
->io_limits
.iops
[BLOCK_IO_LIMIT_TOTAL
]) {
3322 iops_limit
= bs
->io_limits
.iops
[BLOCK_IO_LIMIT_TOTAL
];
3323 } else if (bs
->io_limits
.iops
[is_write
]) {
3324 iops_limit
= bs
->io_limits
.iops
[is_write
];
3333 slice_time
= bs
->slice_end
- bs
->slice_start
;
3334 slice_time
/= (NANOSECONDS_PER_SECOND
);
3335 ios_limit
= iops_limit
* slice_time
;
3336 ios_base
= bs
->nr_ops
[is_write
] - bs
->io_base
.ios
[is_write
];
3337 if (bs
->io_limits
.iops
[BLOCK_IO_LIMIT_TOTAL
]) {
3338 ios_base
+= bs
->nr_ops
[!is_write
] - bs
->io_base
.ios
[!is_write
];
3341 if (ios_base
+ 1 <= ios_limit
) {
3349 /* Calc approx time to dispatch */
3350 wait_time
= (ios_base
+ 1) / iops_limit
;
3351 if (wait_time
> elapsed_time
) {
3352 wait_time
= wait_time
- elapsed_time
;
3357 bs
->slice_time
= wait_time
* BLOCK_IO_SLICE_TIME
* 10;
3358 bs
->slice_end
+= bs
->slice_time
- 3 * BLOCK_IO_SLICE_TIME
;
3360 *wait
= wait_time
* BLOCK_IO_SLICE_TIME
* 10;
3366 static bool bdrv_exceed_io_limits(BlockDriverState
*bs
, int nb_sectors
,
3367 bool is_write
, int64_t *wait
)
3369 int64_t now
, max_wait
;
3370 uint64_t bps_wait
= 0, iops_wait
= 0;
3371 double elapsed_time
;
3372 int bps_ret
, iops_ret
;
3374 now
= qemu_get_clock_ns(vm_clock
);
3375 if ((bs
->slice_start
< now
)
3376 && (bs
->slice_end
> now
)) {
3377 bs
->slice_end
= now
+ bs
->slice_time
;
3379 bs
->slice_time
= 5 * BLOCK_IO_SLICE_TIME
;
3380 bs
->slice_start
= now
;
3381 bs
->slice_end
= now
+ bs
->slice_time
;
3383 bs
->io_base
.bytes
[is_write
] = bs
->nr_bytes
[is_write
];
3384 bs
->io_base
.bytes
[!is_write
] = bs
->nr_bytes
[!is_write
];
3386 bs
->io_base
.ios
[is_write
] = bs
->nr_ops
[is_write
];
3387 bs
->io_base
.ios
[!is_write
] = bs
->nr_ops
[!is_write
];
3390 elapsed_time
= now
- bs
->slice_start
;
3391 elapsed_time
/= (NANOSECONDS_PER_SECOND
);
3393 bps_ret
= bdrv_exceed_bps_limits(bs
, nb_sectors
,
3394 is_write
, elapsed_time
, &bps_wait
);
3395 iops_ret
= bdrv_exceed_iops_limits(bs
, is_write
,
3396 elapsed_time
, &iops_wait
);
3397 if (bps_ret
|| iops_ret
) {
3398 max_wait
= bps_wait
> iops_wait
? bps_wait
: iops_wait
;
3403 now
= qemu_get_clock_ns(vm_clock
);
3404 if (bs
->slice_end
< now
+ max_wait
) {
3405 bs
->slice_end
= now
+ max_wait
;
3418 /**************************************************************/
3419 /* async block device emulation */
3421 typedef struct BlockDriverAIOCBSync
{
3422 BlockDriverAIOCB common
;
3425 /* vector translation state */
3429 } BlockDriverAIOCBSync
;
3431 static void bdrv_aio_cancel_em(BlockDriverAIOCB
*blockacb
)
3433 BlockDriverAIOCBSync
*acb
=
3434 container_of(blockacb
, BlockDriverAIOCBSync
, common
);
3435 qemu_bh_delete(acb
->bh
);
3437 qemu_aio_release(acb
);
3440 static AIOPool bdrv_em_aio_pool
= {
3441 .aiocb_size
= sizeof(BlockDriverAIOCBSync
),
3442 .cancel
= bdrv_aio_cancel_em
,
3445 static void bdrv_aio_bh_cb(void *opaque
)
3447 BlockDriverAIOCBSync
*acb
= opaque
;
3450 qemu_iovec_from_buf(acb
->qiov
, 0, acb
->bounce
, acb
->qiov
->size
);
3451 qemu_vfree(acb
->bounce
);
3452 acb
->common
.cb(acb
->common
.opaque
, acb
->ret
);
3453 qemu_bh_delete(acb
->bh
);
3455 qemu_aio_release(acb
);
3458 static BlockDriverAIOCB
*bdrv_aio_rw_vector(BlockDriverState
*bs
,
3462 BlockDriverCompletionFunc
*cb
,
3467 BlockDriverAIOCBSync
*acb
;
3469 acb
= qemu_aio_get(&bdrv_em_aio_pool
, bs
, cb
, opaque
);
3470 acb
->is_write
= is_write
;
3472 acb
->bounce
= qemu_blockalign(bs
, qiov
->size
);
3473 acb
->bh
= qemu_bh_new(bdrv_aio_bh_cb
, acb
);
3476 qemu_iovec_to_buf(acb
->qiov
, 0, acb
->bounce
, qiov
->size
);
3477 acb
->ret
= bs
->drv
->bdrv_write(bs
, sector_num
, acb
->bounce
, nb_sectors
);
3479 acb
->ret
= bs
->drv
->bdrv_read(bs
, sector_num
, acb
->bounce
, nb_sectors
);
3482 qemu_bh_schedule(acb
->bh
);
3484 return &acb
->common
;
3487 static BlockDriverAIOCB
*bdrv_aio_readv_em(BlockDriverState
*bs
,
3488 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
3489 BlockDriverCompletionFunc
*cb
, void *opaque
)
3491 return bdrv_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
, cb
, opaque
, 0);
3494 static BlockDriverAIOCB
*bdrv_aio_writev_em(BlockDriverState
*bs
,
3495 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
3496 BlockDriverCompletionFunc
*cb
, void *opaque
)
3498 return bdrv_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
, cb
, opaque
, 1);
3502 typedef struct BlockDriverAIOCBCoroutine
{
3503 BlockDriverAIOCB common
;
3507 } BlockDriverAIOCBCoroutine
;
3509 static void bdrv_aio_co_cancel_em(BlockDriverAIOCB
*blockacb
)
3514 static AIOPool bdrv_em_co_aio_pool
= {
3515 .aiocb_size
= sizeof(BlockDriverAIOCBCoroutine
),
3516 .cancel
= bdrv_aio_co_cancel_em
,
3519 static void bdrv_co_em_bh(void *opaque
)
3521 BlockDriverAIOCBCoroutine
*acb
= opaque
;
3523 acb
->common
.cb(acb
->common
.opaque
, acb
->req
.error
);
3524 qemu_bh_delete(acb
->bh
);
3525 qemu_aio_release(acb
);
3528 /* Invoke bdrv_co_do_readv/bdrv_co_do_writev */
3529 static void coroutine_fn
bdrv_co_do_rw(void *opaque
)
3531 BlockDriverAIOCBCoroutine
*acb
= opaque
;
3532 BlockDriverState
*bs
= acb
->common
.bs
;
3534 if (!acb
->is_write
) {
3535 acb
->req
.error
= bdrv_co_do_readv(bs
, acb
->req
.sector
,
3536 acb
->req
.nb_sectors
, acb
->req
.qiov
, 0);
3538 acb
->req
.error
= bdrv_co_do_writev(bs
, acb
->req
.sector
,
3539 acb
->req
.nb_sectors
, acb
->req
.qiov
, 0);
3542 acb
->bh
= qemu_bh_new(bdrv_co_em_bh
, acb
);
3543 qemu_bh_schedule(acb
->bh
);
3546 static BlockDriverAIOCB
*bdrv_co_aio_rw_vector(BlockDriverState
*bs
,
3550 BlockDriverCompletionFunc
*cb
,
3555 BlockDriverAIOCBCoroutine
*acb
;
3557 acb
= qemu_aio_get(&bdrv_em_co_aio_pool
, bs
, cb
, opaque
);
3558 acb
->req
.sector
= sector_num
;
3559 acb
->req
.nb_sectors
= nb_sectors
;
3560 acb
->req
.qiov
= qiov
;
3561 acb
->is_write
= is_write
;
3563 co
= qemu_coroutine_create(bdrv_co_do_rw
);
3564 qemu_coroutine_enter(co
, acb
);
3566 return &acb
->common
;
3569 static void coroutine_fn
bdrv_aio_flush_co_entry(void *opaque
)
3571 BlockDriverAIOCBCoroutine
*acb
= opaque
;
3572 BlockDriverState
*bs
= acb
->common
.bs
;
3574 acb
->req
.error
= bdrv_co_flush(bs
);
3575 acb
->bh
= qemu_bh_new(bdrv_co_em_bh
, acb
);
3576 qemu_bh_schedule(acb
->bh
);
3579 BlockDriverAIOCB
*bdrv_aio_flush(BlockDriverState
*bs
,
3580 BlockDriverCompletionFunc
*cb
, void *opaque
)
3582 trace_bdrv_aio_flush(bs
, opaque
);
3585 BlockDriverAIOCBCoroutine
*acb
;
3587 acb
= qemu_aio_get(&bdrv_em_co_aio_pool
, bs
, cb
, opaque
);
3588 co
= qemu_coroutine_create(bdrv_aio_flush_co_entry
);
3589 qemu_coroutine_enter(co
, acb
);
3591 return &acb
->common
;
3594 static void coroutine_fn
bdrv_aio_discard_co_entry(void *opaque
)
3596 BlockDriverAIOCBCoroutine
*acb
= opaque
;
3597 BlockDriverState
*bs
= acb
->common
.bs
;
3599 acb
->req
.error
= bdrv_co_discard(bs
, acb
->req
.sector
, acb
->req
.nb_sectors
);
3600 acb
->bh
= qemu_bh_new(bdrv_co_em_bh
, acb
);
3601 qemu_bh_schedule(acb
->bh
);
3604 BlockDriverAIOCB
*bdrv_aio_discard(BlockDriverState
*bs
,
3605 int64_t sector_num
, int nb_sectors
,
3606 BlockDriverCompletionFunc
*cb
, void *opaque
)
3609 BlockDriverAIOCBCoroutine
*acb
;
3611 trace_bdrv_aio_discard(bs
, sector_num
, nb_sectors
, opaque
);
3613 acb
= qemu_aio_get(&bdrv_em_co_aio_pool
, bs
, cb
, opaque
);
3614 acb
->req
.sector
= sector_num
;
3615 acb
->req
.nb_sectors
= nb_sectors
;
3616 co
= qemu_coroutine_create(bdrv_aio_discard_co_entry
);
3617 qemu_coroutine_enter(co
, acb
);
3619 return &acb
->common
;
3622 void bdrv_init(void)
3624 module_call_init(MODULE_INIT_BLOCK
);
3627 void bdrv_init_with_whitelist(void)
3629 use_bdrv_whitelist
= 1;
3633 void *qemu_aio_get(AIOPool
*pool
, BlockDriverState
*bs
,
3634 BlockDriverCompletionFunc
*cb
, void *opaque
)
3636 BlockDriverAIOCB
*acb
;
3638 if (pool
->free_aiocb
) {
3639 acb
= pool
->free_aiocb
;
3640 pool
->free_aiocb
= acb
->next
;
3642 acb
= g_malloc0(pool
->aiocb_size
);
3647 acb
->opaque
= opaque
;
3651 void qemu_aio_release(void *p
)
3653 BlockDriverAIOCB
*acb
= (BlockDriverAIOCB
*)p
;
3654 AIOPool
*pool
= acb
->pool
;
3655 acb
->next
= pool
->free_aiocb
;
3656 pool
->free_aiocb
= acb
;
3659 /**************************************************************/
3660 /* Coroutine block device emulation */
3662 typedef struct CoroutineIOCompletion
{
3663 Coroutine
*coroutine
;
3665 } CoroutineIOCompletion
;
3667 static void bdrv_co_io_em_complete(void *opaque
, int ret
)
3669 CoroutineIOCompletion
*co
= opaque
;
3672 qemu_coroutine_enter(co
->coroutine
, NULL
);
3675 static int coroutine_fn
bdrv_co_io_em(BlockDriverState
*bs
, int64_t sector_num
,
3676 int nb_sectors
, QEMUIOVector
*iov
,
3679 CoroutineIOCompletion co
= {
3680 .coroutine
= qemu_coroutine_self(),
3682 BlockDriverAIOCB
*acb
;
3685 acb
= bs
->drv
->bdrv_aio_writev(bs
, sector_num
, iov
, nb_sectors
,
3686 bdrv_co_io_em_complete
, &co
);
3688 acb
= bs
->drv
->bdrv_aio_readv(bs
, sector_num
, iov
, nb_sectors
,
3689 bdrv_co_io_em_complete
, &co
);
3692 trace_bdrv_co_io_em(bs
, sector_num
, nb_sectors
, is_write
, acb
);
3696 qemu_coroutine_yield();
3701 static int coroutine_fn
bdrv_co_readv_em(BlockDriverState
*bs
,
3702 int64_t sector_num
, int nb_sectors
,
3705 return bdrv_co_io_em(bs
, sector_num
, nb_sectors
, iov
, false);
3708 static int coroutine_fn
bdrv_co_writev_em(BlockDriverState
*bs
,
3709 int64_t sector_num
, int nb_sectors
,
3712 return bdrv_co_io_em(bs
, sector_num
, nb_sectors
, iov
, true);
3715 static void coroutine_fn
bdrv_flush_co_entry(void *opaque
)
3717 RwCo
*rwco
= opaque
;
3719 rwco
->ret
= bdrv_co_flush(rwco
->bs
);
3722 int coroutine_fn
bdrv_co_flush(BlockDriverState
*bs
)
3726 if (!bs
|| !bdrv_is_inserted(bs
) || bdrv_is_read_only(bs
)) {
3730 /* Write back cached data to the OS even with cache=unsafe */
3731 if (bs
->drv
->bdrv_co_flush_to_os
) {
3732 ret
= bs
->drv
->bdrv_co_flush_to_os(bs
);
3738 /* But don't actually force it to the disk with cache=unsafe */
3739 if (bs
->open_flags
& BDRV_O_NO_FLUSH
) {
3743 if (bs
->drv
->bdrv_co_flush_to_disk
) {
3744 ret
= bs
->drv
->bdrv_co_flush_to_disk(bs
);
3745 } else if (bs
->drv
->bdrv_aio_flush
) {
3746 BlockDriverAIOCB
*acb
;
3747 CoroutineIOCompletion co
= {
3748 .coroutine
= qemu_coroutine_self(),
3751 acb
= bs
->drv
->bdrv_aio_flush(bs
, bdrv_co_io_em_complete
, &co
);
3755 qemu_coroutine_yield();
3760 * Some block drivers always operate in either writethrough or unsafe
3761 * mode and don't support bdrv_flush therefore. Usually qemu doesn't
3762 * know how the server works (because the behaviour is hardcoded or
3763 * depends on server-side configuration), so we can't ensure that
3764 * everything is safe on disk. Returning an error doesn't work because
3765 * that would break guests even if the server operates in writethrough
3768 * Let's hope the user knows what he's doing.
3776 /* Now flush the underlying protocol. It will also have BDRV_O_NO_FLUSH
3777 * in the case of cache=unsafe, so there are no useless flushes.
3780 return bdrv_co_flush(bs
->file
);
3783 void bdrv_invalidate_cache(BlockDriverState
*bs
)
3785 if (bs
->drv
&& bs
->drv
->bdrv_invalidate_cache
) {
3786 bs
->drv
->bdrv_invalidate_cache(bs
);
3790 void bdrv_invalidate_cache_all(void)
3792 BlockDriverState
*bs
;
3794 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
3795 bdrv_invalidate_cache(bs
);
3799 void bdrv_clear_incoming_migration_all(void)
3801 BlockDriverState
*bs
;
3803 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
3804 bs
->open_flags
= bs
->open_flags
& ~(BDRV_O_INCOMING
);
3808 int bdrv_flush(BlockDriverState
*bs
)
3816 if (qemu_in_coroutine()) {
3817 /* Fast-path if already in coroutine context */
3818 bdrv_flush_co_entry(&rwco
);
3820 co
= qemu_coroutine_create(bdrv_flush_co_entry
);
3821 qemu_coroutine_enter(co
, &rwco
);
3822 while (rwco
.ret
== NOT_DONE
) {
3830 static void coroutine_fn
bdrv_discard_co_entry(void *opaque
)
3832 RwCo
*rwco
= opaque
;
3834 rwco
->ret
= bdrv_co_discard(rwco
->bs
, rwco
->sector_num
, rwco
->nb_sectors
);
3837 int coroutine_fn
bdrv_co_discard(BlockDriverState
*bs
, int64_t sector_num
,
3842 } else if (bdrv_check_request(bs
, sector_num
, nb_sectors
)) {
3844 } else if (bs
->read_only
) {
3846 } else if (bs
->drv
->bdrv_co_discard
) {
3847 return bs
->drv
->bdrv_co_discard(bs
, sector_num
, nb_sectors
);
3848 } else if (bs
->drv
->bdrv_aio_discard
) {
3849 BlockDriverAIOCB
*acb
;
3850 CoroutineIOCompletion co
= {
3851 .coroutine
= qemu_coroutine_self(),
3854 acb
= bs
->drv
->bdrv_aio_discard(bs
, sector_num
, nb_sectors
,
3855 bdrv_co_io_em_complete
, &co
);
3859 qemu_coroutine_yield();
3867 int bdrv_discard(BlockDriverState
*bs
, int64_t sector_num
, int nb_sectors
)
3872 .sector_num
= sector_num
,
3873 .nb_sectors
= nb_sectors
,
3877 if (qemu_in_coroutine()) {
3878 /* Fast-path if already in coroutine context */
3879 bdrv_discard_co_entry(&rwco
);
3881 co
= qemu_coroutine_create(bdrv_discard_co_entry
);
3882 qemu_coroutine_enter(co
, &rwco
);
3883 while (rwco
.ret
== NOT_DONE
) {
3891 /**************************************************************/
3892 /* removable device support */
3895 * Return TRUE if the media is present
3897 int bdrv_is_inserted(BlockDriverState
*bs
)
3899 BlockDriver
*drv
= bs
->drv
;
3903 if (!drv
->bdrv_is_inserted
)
3905 return drv
->bdrv_is_inserted(bs
);
3909 * Return whether the media changed since the last call to this
3910 * function, or -ENOTSUP if we don't know. Most drivers don't know.
3912 int bdrv_media_changed(BlockDriverState
*bs
)
3914 BlockDriver
*drv
= bs
->drv
;
3916 if (drv
&& drv
->bdrv_media_changed
) {
3917 return drv
->bdrv_media_changed(bs
);
3923 * If eject_flag is TRUE, eject the media. Otherwise, close the tray
3925 void bdrv_eject(BlockDriverState
*bs
, bool eject_flag
)
3927 BlockDriver
*drv
= bs
->drv
;
3929 if (drv
&& drv
->bdrv_eject
) {
3930 drv
->bdrv_eject(bs
, eject_flag
);
3933 if (bs
->device_name
[0] != '\0') {
3934 bdrv_emit_qmp_eject_event(bs
, eject_flag
);
3939 * Lock or unlock the media (if it is locked, the user won't be able
3940 * to eject it manually).
3942 void bdrv_lock_medium(BlockDriverState
*bs
, bool locked
)
3944 BlockDriver
*drv
= bs
->drv
;
3946 trace_bdrv_lock_medium(bs
, locked
);
3948 if (drv
&& drv
->bdrv_lock_medium
) {
3949 drv
->bdrv_lock_medium(bs
, locked
);
3953 /* needed for generic scsi interface */
3955 int bdrv_ioctl(BlockDriverState
*bs
, unsigned long int req
, void *buf
)
3957 BlockDriver
*drv
= bs
->drv
;
3959 if (drv
&& drv
->bdrv_ioctl
)
3960 return drv
->bdrv_ioctl(bs
, req
, buf
);
3964 BlockDriverAIOCB
*bdrv_aio_ioctl(BlockDriverState
*bs
,
3965 unsigned long int req
, void *buf
,
3966 BlockDriverCompletionFunc
*cb
, void *opaque
)
3968 BlockDriver
*drv
= bs
->drv
;
3970 if (drv
&& drv
->bdrv_aio_ioctl
)
3971 return drv
->bdrv_aio_ioctl(bs
, req
, buf
, cb
, opaque
);
3975 void bdrv_set_buffer_alignment(BlockDriverState
*bs
, int align
)
3977 bs
->buffer_alignment
= align
;
3980 void *qemu_blockalign(BlockDriverState
*bs
, size_t size
)
3982 return qemu_memalign((bs
&& bs
->buffer_alignment
) ? bs
->buffer_alignment
: 512, size
);
3985 void bdrv_set_dirty_tracking(BlockDriverState
*bs
, int enable
)
3987 int64_t bitmap_size
;
3989 bs
->dirty_count
= 0;
3991 if (!bs
->dirty_bitmap
) {
3992 bitmap_size
= (bdrv_getlength(bs
) >> BDRV_SECTOR_BITS
) +
3993 BDRV_SECTORS_PER_DIRTY_CHUNK
* BITS_PER_LONG
- 1;
3994 bitmap_size
/= BDRV_SECTORS_PER_DIRTY_CHUNK
* BITS_PER_LONG
;
3996 bs
->dirty_bitmap
= g_new0(unsigned long, bitmap_size
);
3999 if (bs
->dirty_bitmap
) {
4000 g_free(bs
->dirty_bitmap
);
4001 bs
->dirty_bitmap
= NULL
;
4006 int bdrv_get_dirty(BlockDriverState
*bs
, int64_t sector
)
4008 int64_t chunk
= sector
/ (int64_t)BDRV_SECTORS_PER_DIRTY_CHUNK
;
4010 if (bs
->dirty_bitmap
&&
4011 (sector
<< BDRV_SECTOR_BITS
) < bdrv_getlength(bs
)) {
4012 return !!(bs
->dirty_bitmap
[chunk
/ (sizeof(unsigned long) * 8)] &
4013 (1UL << (chunk
% (sizeof(unsigned long) * 8))));
4019 void bdrv_reset_dirty(BlockDriverState
*bs
, int64_t cur_sector
,
4022 set_dirty_bitmap(bs
, cur_sector
, nr_sectors
, 0);
4025 int64_t bdrv_get_dirty_count(BlockDriverState
*bs
)
4027 return bs
->dirty_count
;
4030 void bdrv_set_in_use(BlockDriverState
*bs
, int in_use
)
4032 assert(bs
->in_use
!= in_use
);
4033 bs
->in_use
= in_use
;
4036 int bdrv_in_use(BlockDriverState
*bs
)
4041 void bdrv_iostatus_enable(BlockDriverState
*bs
)
4043 bs
->iostatus_enabled
= true;
4044 bs
->iostatus
= BLOCK_DEVICE_IO_STATUS_OK
;
4047 /* The I/O status is only enabled if the drive explicitly
4048 * enables it _and_ the VM is configured to stop on errors */
4049 bool bdrv_iostatus_is_enabled(const BlockDriverState
*bs
)
4051 return (bs
->iostatus_enabled
&&
4052 (bs
->on_write_error
== BLOCK_ERR_STOP_ENOSPC
||
4053 bs
->on_write_error
== BLOCK_ERR_STOP_ANY
||
4054 bs
->on_read_error
== BLOCK_ERR_STOP_ANY
));
4057 void bdrv_iostatus_disable(BlockDriverState
*bs
)
4059 bs
->iostatus_enabled
= false;
4062 void bdrv_iostatus_reset(BlockDriverState
*bs
)
4064 if (bdrv_iostatus_is_enabled(bs
)) {
4065 bs
->iostatus
= BLOCK_DEVICE_IO_STATUS_OK
;
4069 /* XXX: Today this is set by device models because it makes the implementation
4070 quite simple. However, the block layer knows about the error, so it's
4071 possible to implement this without device models being involved */
4072 void bdrv_iostatus_set_err(BlockDriverState
*bs
, int error
)
4074 if (bdrv_iostatus_is_enabled(bs
) &&
4075 bs
->iostatus
== BLOCK_DEVICE_IO_STATUS_OK
) {
4077 bs
->iostatus
= error
== ENOSPC
? BLOCK_DEVICE_IO_STATUS_NOSPACE
:
4078 BLOCK_DEVICE_IO_STATUS_FAILED
;
4083 bdrv_acct_start(BlockDriverState
*bs
, BlockAcctCookie
*cookie
, int64_t bytes
,
4084 enum BlockAcctType type
)
4086 assert(type
< BDRV_MAX_IOTYPE
);
4088 cookie
->bytes
= bytes
;
4089 cookie
->start_time_ns
= get_clock();
4090 cookie
->type
= type
;
4094 bdrv_acct_done(BlockDriverState
*bs
, BlockAcctCookie
*cookie
)
4096 assert(cookie
->type
< BDRV_MAX_IOTYPE
);
4098 bs
->nr_bytes
[cookie
->type
] += cookie
->bytes
;
4099 bs
->nr_ops
[cookie
->type
]++;
4100 bs
->total_time_ns
[cookie
->type
] += get_clock() - cookie
->start_time_ns
;
4103 int bdrv_img_create(const char *filename
, const char *fmt
,
4104 const char *base_filename
, const char *base_fmt
,
4105 char *options
, uint64_t img_size
, int flags
)
4107 QEMUOptionParameter
*param
= NULL
, *create_options
= NULL
;
4108 QEMUOptionParameter
*backing_fmt
, *backing_file
, *size
;
4109 BlockDriverState
*bs
= NULL
;
4110 BlockDriver
*drv
, *proto_drv
;
4111 BlockDriver
*backing_drv
= NULL
;
4114 /* Find driver and parse its options */
4115 drv
= bdrv_find_format(fmt
);
4117 error_report("Unknown file format '%s'", fmt
);
4122 proto_drv
= bdrv_find_protocol(filename
);
4124 error_report("Unknown protocol '%s'", filename
);
4129 create_options
= append_option_parameters(create_options
,
4130 drv
->create_options
);
4131 create_options
= append_option_parameters(create_options
,
4132 proto_drv
->create_options
);
4134 /* Create parameter list with default values */
4135 param
= parse_option_parameters("", create_options
, param
);
4137 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, img_size
);
4139 /* Parse -o options */
4141 param
= parse_option_parameters(options
, create_options
, param
);
4142 if (param
== NULL
) {
4143 error_report("Invalid options for file format '%s'.", fmt
);
4149 if (base_filename
) {
4150 if (set_option_parameter(param
, BLOCK_OPT_BACKING_FILE
,
4152 error_report("Backing file not supported for file format '%s'",
4160 if (set_option_parameter(param
, BLOCK_OPT_BACKING_FMT
, base_fmt
)) {
4161 error_report("Backing file format not supported for file "
4162 "format '%s'", fmt
);
4168 backing_file
= get_option_parameter(param
, BLOCK_OPT_BACKING_FILE
);
4169 if (backing_file
&& backing_file
->value
.s
) {
4170 if (!strcmp(filename
, backing_file
->value
.s
)) {
4171 error_report("Error: Trying to create an image with the "
4172 "same filename as the backing file");
4178 backing_fmt
= get_option_parameter(param
, BLOCK_OPT_BACKING_FMT
);
4179 if (backing_fmt
&& backing_fmt
->value
.s
) {
4180 backing_drv
= bdrv_find_format(backing_fmt
->value
.s
);
4182 error_report("Unknown backing file format '%s'",
4183 backing_fmt
->value
.s
);
4189 // The size for the image must always be specified, with one exception:
4190 // If we are using a backing file, we can obtain the size from there
4191 size
= get_option_parameter(param
, BLOCK_OPT_SIZE
);
4192 if (size
&& size
->value
.n
== -1) {
4193 if (backing_file
&& backing_file
->value
.s
) {
4198 /* backing files always opened read-only */
4200 flags
& ~(BDRV_O_RDWR
| BDRV_O_SNAPSHOT
| BDRV_O_NO_BACKING
);
4204 ret
= bdrv_open(bs
, backing_file
->value
.s
, back_flags
, backing_drv
);
4206 error_report("Could not open '%s'", backing_file
->value
.s
);
4209 bdrv_get_geometry(bs
, &size
);
4212 snprintf(buf
, sizeof(buf
), "%" PRId64
, size
);
4213 set_option_parameter(param
, BLOCK_OPT_SIZE
, buf
);
4215 error_report("Image creation needs a size parameter");
4221 printf("Formatting '%s', fmt=%s ", filename
, fmt
);
4222 print_option_parameters(param
);
4225 ret
= bdrv_create(drv
, filename
, param
);
4228 if (ret
== -ENOTSUP
) {
4229 error_report("Formatting or formatting option not supported for "
4230 "file format '%s'", fmt
);
4231 } else if (ret
== -EFBIG
) {
4232 error_report("The image size is too large for file format '%s'",
4235 error_report("%s: error while creating %s: %s", filename
, fmt
,
4241 free_option_parameters(create_options
);
4242 free_option_parameters(param
);
4251 void *block_job_create(const BlockJobType
*job_type
, BlockDriverState
*bs
,
4252 int64_t speed
, BlockDriverCompletionFunc
*cb
,
4253 void *opaque
, Error
**errp
)
4257 if (bs
->job
|| bdrv_in_use(bs
)) {
4258 error_set(errp
, QERR_DEVICE_IN_USE
, bdrv_get_device_name(bs
));
4261 bdrv_set_in_use(bs
, 1);
4263 job
= g_malloc0(job_type
->instance_size
);
4264 job
->job_type
= job_type
;
4267 job
->opaque
= opaque
;
4271 /* Only set speed when necessary to avoid NotSupported error */
4273 Error
*local_err
= NULL
;
4275 block_job_set_speed(job
, speed
, &local_err
);
4276 if (error_is_set(&local_err
)) {
4279 bdrv_set_in_use(bs
, 0);
4280 error_propagate(errp
, local_err
);
4287 void block_job_complete(BlockJob
*job
, int ret
)
4289 BlockDriverState
*bs
= job
->bs
;
4291 assert(bs
->job
== job
);
4292 job
->cb(job
->opaque
, ret
);
4295 bdrv_set_in_use(bs
, 0);
4298 void block_job_set_speed(BlockJob
*job
, int64_t speed
, Error
**errp
)
4300 Error
*local_err
= NULL
;
4302 if (!job
->job_type
->set_speed
) {
4303 error_set(errp
, QERR_NOT_SUPPORTED
);
4306 job
->job_type
->set_speed(job
, speed
, &local_err
);
4307 if (error_is_set(&local_err
)) {
4308 error_propagate(errp
, local_err
);
4315 void block_job_cancel(BlockJob
*job
)
4317 job
->cancelled
= true;
4318 if (job
->co
&& !job
->busy
) {
4319 qemu_coroutine_enter(job
->co
, NULL
);
4323 bool block_job_is_cancelled(BlockJob
*job
)
4325 return job
->cancelled
;
4328 struct BlockCancelData
{
4330 BlockDriverCompletionFunc
*cb
;
4336 static void block_job_cancel_cb(void *opaque
, int ret
)
4338 struct BlockCancelData
*data
= opaque
;
4340 data
->cancelled
= block_job_is_cancelled(data
->job
);
4342 data
->cb(data
->opaque
, ret
);
4345 int block_job_cancel_sync(BlockJob
*job
)
4347 struct BlockCancelData data
;
4348 BlockDriverState
*bs
= job
->bs
;
4350 assert(bs
->job
== job
);
4352 /* Set up our own callback to store the result and chain to
4353 * the original callback.
4357 data
.opaque
= job
->opaque
;
4358 data
.ret
= -EINPROGRESS
;
4359 job
->cb
= block_job_cancel_cb
;
4360 job
->opaque
= &data
;
4361 block_job_cancel(job
);
4362 while (data
.ret
== -EINPROGRESS
) {
4365 return (data
.cancelled
&& data
.ret
== 0) ? -ECANCELED
: data
.ret
;
4368 void block_job_sleep_ns(BlockJob
*job
, QEMUClock
*clock
, int64_t ns
)
4370 /* Check cancellation *before* setting busy = false, too! */
4371 if (!block_job_is_cancelled(job
)) {
4373 co_sleep_ns(clock
, ns
);