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
);
84 static bool bdrv_exceed_bps_limits(BlockDriverState
*bs
, int nb_sectors
,
85 bool is_write
, double elapsed_time
, uint64_t *wait
);
86 static bool bdrv_exceed_iops_limits(BlockDriverState
*bs
, bool is_write
,
87 double elapsed_time
, uint64_t *wait
);
88 static bool bdrv_exceed_io_limits(BlockDriverState
*bs
, int nb_sectors
,
89 bool is_write
, int64_t *wait
);
91 static QTAILQ_HEAD(, BlockDriverState
) bdrv_states
=
92 QTAILQ_HEAD_INITIALIZER(bdrv_states
);
94 static QLIST_HEAD(, BlockDriver
) bdrv_drivers
=
95 QLIST_HEAD_INITIALIZER(bdrv_drivers
);
97 /* The device to use for VM snapshots */
98 static BlockDriverState
*bs_snapshots
;
100 /* If non-zero, use only whitelisted block drivers */
101 static int use_bdrv_whitelist
;
104 static int is_windows_drive_prefix(const char *filename
)
106 return (((filename
[0] >= 'a' && filename
[0] <= 'z') ||
107 (filename
[0] >= 'A' && filename
[0] <= 'Z')) &&
111 int is_windows_drive(const char *filename
)
113 if (is_windows_drive_prefix(filename
) &&
116 if (strstart(filename
, "\\\\.\\", NULL
) ||
117 strstart(filename
, "//./", NULL
))
123 /* throttling disk I/O limits */
124 void bdrv_io_limits_disable(BlockDriverState
*bs
)
126 bs
->io_limits_enabled
= false;
128 while (qemu_co_queue_next(&bs
->throttled_reqs
));
130 if (bs
->block_timer
) {
131 qemu_del_timer(bs
->block_timer
);
132 qemu_free_timer(bs
->block_timer
);
133 bs
->block_timer
= NULL
;
139 memset(&bs
->io_base
, 0, sizeof(bs
->io_base
));
142 static void bdrv_block_timer(void *opaque
)
144 BlockDriverState
*bs
= opaque
;
146 qemu_co_queue_next(&bs
->throttled_reqs
);
149 void bdrv_io_limits_enable(BlockDriverState
*bs
)
151 qemu_co_queue_init(&bs
->throttled_reqs
);
152 bs
->block_timer
= qemu_new_timer_ns(vm_clock
, bdrv_block_timer
, bs
);
153 bs
->slice_time
= 5 * BLOCK_IO_SLICE_TIME
;
154 bs
->slice_start
= qemu_get_clock_ns(vm_clock
);
155 bs
->slice_end
= bs
->slice_start
+ bs
->slice_time
;
156 memset(&bs
->io_base
, 0, sizeof(bs
->io_base
));
157 bs
->io_limits_enabled
= true;
160 bool bdrv_io_limits_enabled(BlockDriverState
*bs
)
162 BlockIOLimit
*io_limits
= &bs
->io_limits
;
163 return io_limits
->bps
[BLOCK_IO_LIMIT_READ
]
164 || io_limits
->bps
[BLOCK_IO_LIMIT_WRITE
]
165 || io_limits
->bps
[BLOCK_IO_LIMIT_TOTAL
]
166 || io_limits
->iops
[BLOCK_IO_LIMIT_READ
]
167 || io_limits
->iops
[BLOCK_IO_LIMIT_WRITE
]
168 || io_limits
->iops
[BLOCK_IO_LIMIT_TOTAL
];
171 static void bdrv_io_limits_intercept(BlockDriverState
*bs
,
172 bool is_write
, int nb_sectors
)
174 int64_t wait_time
= -1;
176 if (!qemu_co_queue_empty(&bs
->throttled_reqs
)) {
177 qemu_co_queue_wait(&bs
->throttled_reqs
);
180 /* In fact, we hope to keep each request's timing, in FIFO mode. The next
181 * throttled requests will not be dequeued until the current request is
182 * allowed to be serviced. So if the current request still exceeds the
183 * limits, it will be inserted to the head. All requests followed it will
184 * be still in throttled_reqs queue.
187 while (bdrv_exceed_io_limits(bs
, nb_sectors
, is_write
, &wait_time
)) {
188 qemu_mod_timer(bs
->block_timer
,
189 wait_time
+ qemu_get_clock_ns(vm_clock
));
190 qemu_co_queue_wait_insert_head(&bs
->throttled_reqs
);
193 qemu_co_queue_next(&bs
->throttled_reqs
);
196 /* check if the path starts with "<protocol>:" */
197 static int path_has_protocol(const char *path
)
200 if (is_windows_drive(path
) ||
201 is_windows_drive_prefix(path
)) {
206 return strchr(path
, ':') != NULL
;
209 int path_is_absolute(const char *path
)
213 /* specific case for names like: "\\.\d:" */
214 if (*path
== '/' || *path
== '\\')
217 p
= strchr(path
, ':');
223 return (*p
== '/' || *p
== '\\');
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_register(BlockDriver
*bdrv
)
275 /* Block drivers without coroutine functions need emulation */
276 if (!bdrv
->bdrv_co_readv
) {
277 bdrv
->bdrv_co_readv
= bdrv_co_readv_em
;
278 bdrv
->bdrv_co_writev
= bdrv_co_writev_em
;
280 /* bdrv_co_readv_em()/brdv_co_writev_em() work in terms of aio, so if
281 * the block driver lacks aio we need to emulate that too.
283 if (!bdrv
->bdrv_aio_readv
) {
284 /* add AIO emulation layer */
285 bdrv
->bdrv_aio_readv
= bdrv_aio_readv_em
;
286 bdrv
->bdrv_aio_writev
= bdrv_aio_writev_em
;
290 QLIST_INSERT_HEAD(&bdrv_drivers
, bdrv
, list
);
293 /* create a new block device (by default it is empty) */
294 BlockDriverState
*bdrv_new(const char *device_name
)
296 BlockDriverState
*bs
;
298 bs
= g_malloc0(sizeof(BlockDriverState
));
299 pstrcpy(bs
->device_name
, sizeof(bs
->device_name
), device_name
);
300 if (device_name
[0] != '\0') {
301 QTAILQ_INSERT_TAIL(&bdrv_states
, bs
, list
);
303 bdrv_iostatus_disable(bs
);
307 BlockDriver
*bdrv_find_format(const char *format_name
)
310 QLIST_FOREACH(drv1
, &bdrv_drivers
, list
) {
311 if (!strcmp(drv1
->format_name
, format_name
)) {
318 static int bdrv_is_whitelisted(BlockDriver
*drv
)
320 static const char *whitelist
[] = {
321 CONFIG_BDRV_WHITELIST
326 return 1; /* no whitelist, anything goes */
328 for (p
= whitelist
; *p
; p
++) {
329 if (!strcmp(drv
->format_name
, *p
)) {
336 BlockDriver
*bdrv_find_whitelisted_format(const char *format_name
)
338 BlockDriver
*drv
= bdrv_find_format(format_name
);
339 return drv
&& bdrv_is_whitelisted(drv
) ? drv
: NULL
;
342 int bdrv_create(BlockDriver
*drv
, const char* filename
,
343 QEMUOptionParameter
*options
)
345 if (!drv
->bdrv_create
)
348 return drv
->bdrv_create(filename
, options
);
351 int bdrv_create_file(const char* filename
, QEMUOptionParameter
*options
)
355 drv
= bdrv_find_protocol(filename
);
360 return bdrv_create(drv
, filename
, options
);
364 void get_tmp_filename(char *filename
, int size
)
366 char temp_dir
[MAX_PATH
];
368 GetTempPath(MAX_PATH
, temp_dir
);
369 GetTempFileName(temp_dir
, "qem", 0, filename
);
372 void get_tmp_filename(char *filename
, int size
)
376 /* XXX: race condition possible */
377 tmpdir
= getenv("TMPDIR");
380 snprintf(filename
, size
, "%s/vl.XXXXXX", tmpdir
);
381 fd
= mkstemp(filename
);
387 * Detect host devices. By convention, /dev/cdrom[N] is always
388 * recognized as a host CDROM.
390 static BlockDriver
*find_hdev_driver(const char *filename
)
392 int score_max
= 0, score
;
393 BlockDriver
*drv
= NULL
, *d
;
395 QLIST_FOREACH(d
, &bdrv_drivers
, list
) {
396 if (d
->bdrv_probe_device
) {
397 score
= d
->bdrv_probe_device(filename
);
398 if (score
> score_max
) {
408 BlockDriver
*bdrv_find_protocol(const char *filename
)
415 /* TODO Drivers without bdrv_file_open must be specified explicitly */
418 * XXX(hch): we really should not let host device detection
419 * override an explicit protocol specification, but moving this
420 * later breaks access to device names with colons in them.
421 * Thanks to the brain-dead persistent naming schemes on udev-
422 * based Linux systems those actually are quite common.
424 drv1
= find_hdev_driver(filename
);
429 if (!path_has_protocol(filename
)) {
430 return bdrv_find_format("file");
432 p
= strchr(filename
, ':');
435 if (len
> sizeof(protocol
) - 1)
436 len
= sizeof(protocol
) - 1;
437 memcpy(protocol
, filename
, len
);
438 protocol
[len
] = '\0';
439 QLIST_FOREACH(drv1
, &bdrv_drivers
, list
) {
440 if (drv1
->protocol_name
&&
441 !strcmp(drv1
->protocol_name
, protocol
)) {
448 static int find_image_format(const char *filename
, BlockDriver
**pdrv
)
450 int ret
, score
, score_max
;
451 BlockDriver
*drv1
, *drv
;
453 BlockDriverState
*bs
;
455 ret
= bdrv_file_open(&bs
, filename
, 0);
461 /* Return the raw BlockDriver * to scsi-generic devices or empty drives */
462 if (bs
->sg
|| !bdrv_is_inserted(bs
)) {
464 drv
= bdrv_find_format("raw");
472 ret
= bdrv_pread(bs
, 0, buf
, sizeof(buf
));
481 QLIST_FOREACH(drv1
, &bdrv_drivers
, list
) {
482 if (drv1
->bdrv_probe
) {
483 score
= drv1
->bdrv_probe(buf
, ret
, filename
);
484 if (score
> score_max
) {
498 * Set the current 'total_sectors' value
500 static int refresh_total_sectors(BlockDriverState
*bs
, int64_t hint
)
502 BlockDriver
*drv
= bs
->drv
;
504 /* Do not attempt drv->bdrv_getlength() on scsi-generic devices */
508 /* query actual device if possible, otherwise just trust the hint */
509 if (drv
->bdrv_getlength
) {
510 int64_t length
= drv
->bdrv_getlength(bs
);
514 hint
= length
>> BDRV_SECTOR_BITS
;
517 bs
->total_sectors
= hint
;
522 * Set open flags for a given cache mode
524 * Return 0 on success, -1 if the cache mode was invalid.
526 int bdrv_parse_cache_flags(const char *mode
, int *flags
)
528 *flags
&= ~BDRV_O_CACHE_MASK
;
530 if (!strcmp(mode
, "off") || !strcmp(mode
, "none")) {
531 *flags
|= BDRV_O_NOCACHE
| BDRV_O_CACHE_WB
;
532 } else if (!strcmp(mode
, "directsync")) {
533 *flags
|= BDRV_O_NOCACHE
;
534 } else if (!strcmp(mode
, "writeback")) {
535 *flags
|= BDRV_O_CACHE_WB
;
536 } else if (!strcmp(mode
, "unsafe")) {
537 *flags
|= BDRV_O_CACHE_WB
;
538 *flags
|= BDRV_O_NO_FLUSH
;
539 } else if (!strcmp(mode
, "writethrough")) {
540 /* this is the default */
549 * The copy-on-read flag is actually a reference count so multiple users may
550 * use the feature without worrying about clobbering its previous state.
551 * Copy-on-read stays enabled until all users have called to disable it.
553 void bdrv_enable_copy_on_read(BlockDriverState
*bs
)
558 void bdrv_disable_copy_on_read(BlockDriverState
*bs
)
560 assert(bs
->copy_on_read
> 0);
565 * Common part for opening disk images and files
567 static int bdrv_open_common(BlockDriverState
*bs
, const char *filename
,
568 int flags
, BlockDriver
*drv
)
574 trace_bdrv_open_common(bs
, filename
, flags
, drv
->format_name
);
577 bs
->total_sectors
= 0;
581 bs
->open_flags
= flags
;
583 bs
->buffer_alignment
= 512;
585 assert(bs
->copy_on_read
== 0); /* bdrv_new() and bdrv_close() make it so */
586 if ((flags
& BDRV_O_RDWR
) && (flags
& BDRV_O_COPY_ON_READ
)) {
587 bdrv_enable_copy_on_read(bs
);
590 pstrcpy(bs
->filename
, sizeof(bs
->filename
), filename
);
591 bs
->backing_file
[0] = '\0';
593 if (use_bdrv_whitelist
&& !bdrv_is_whitelisted(drv
)) {
598 bs
->opaque
= g_malloc0(drv
->instance_size
);
600 bs
->enable_write_cache
= !!(flags
& BDRV_O_CACHE_WB
);
603 * Clear flags that are internal to the block layer before opening the
606 open_flags
= flags
& ~(BDRV_O_SNAPSHOT
| BDRV_O_NO_BACKING
);
609 * Snapshots should be writable.
611 if (bs
->is_temporary
) {
612 open_flags
|= BDRV_O_RDWR
;
615 bs
->keep_read_only
= bs
->read_only
= !(open_flags
& BDRV_O_RDWR
);
617 /* Open the image, either directly or using a protocol */
618 if (drv
->bdrv_file_open
) {
619 ret
= drv
->bdrv_file_open(bs
, filename
, open_flags
);
621 ret
= bdrv_file_open(&bs
->file
, filename
, open_flags
);
623 ret
= drv
->bdrv_open(bs
, open_flags
);
631 ret
= refresh_total_sectors(bs
, bs
->total_sectors
);
637 if (bs
->is_temporary
) {
645 bdrv_delete(bs
->file
);
655 * Opens a file using a protocol (file, host_device, nbd, ...)
657 int bdrv_file_open(BlockDriverState
**pbs
, const char *filename
, int flags
)
659 BlockDriverState
*bs
;
663 drv
= bdrv_find_protocol(filename
);
669 ret
= bdrv_open_common(bs
, filename
, flags
, drv
);
680 * Opens a disk image (raw, qcow2, vmdk, ...)
682 int bdrv_open(BlockDriverState
*bs
, const char *filename
, int flags
,
686 char tmp_filename
[PATH_MAX
];
688 if (flags
& BDRV_O_SNAPSHOT
) {
689 BlockDriverState
*bs1
;
692 BlockDriver
*bdrv_qcow2
;
693 QEMUOptionParameter
*options
;
694 char backing_filename
[PATH_MAX
];
696 /* if snapshot, we create a temporary backing file and open it
697 instead of opening 'filename' directly */
699 /* if there is a backing file, use it */
701 ret
= bdrv_open(bs1
, filename
, 0, drv
);
706 total_size
= bdrv_getlength(bs1
) & BDRV_SECTOR_MASK
;
708 if (bs1
->drv
&& bs1
->drv
->protocol_name
)
713 get_tmp_filename(tmp_filename
, sizeof(tmp_filename
));
715 /* Real path is meaningless for protocols */
717 snprintf(backing_filename
, sizeof(backing_filename
),
719 else if (!realpath(filename
, backing_filename
))
722 bdrv_qcow2
= bdrv_find_format("qcow2");
723 options
= parse_option_parameters("", bdrv_qcow2
->create_options
, NULL
);
725 set_option_parameter_int(options
, BLOCK_OPT_SIZE
, total_size
);
726 set_option_parameter(options
, BLOCK_OPT_BACKING_FILE
, backing_filename
);
728 set_option_parameter(options
, BLOCK_OPT_BACKING_FMT
,
732 ret
= bdrv_create(bdrv_qcow2
, tmp_filename
, options
);
733 free_option_parameters(options
);
738 filename
= tmp_filename
;
740 bs
->is_temporary
= 1;
743 /* Find the right image format driver */
745 ret
= find_image_format(filename
, &drv
);
749 goto unlink_and_fail
;
753 ret
= bdrv_open_common(bs
, filename
, flags
, drv
);
755 goto unlink_and_fail
;
758 /* If there is a backing file, use it */
759 if ((flags
& BDRV_O_NO_BACKING
) == 0 && bs
->backing_file
[0] != '\0') {
760 char backing_filename
[PATH_MAX
];
762 BlockDriver
*back_drv
= NULL
;
764 bs
->backing_hd
= bdrv_new("");
766 if (path_has_protocol(bs
->backing_file
)) {
767 pstrcpy(backing_filename
, sizeof(backing_filename
),
770 path_combine(backing_filename
, sizeof(backing_filename
),
771 filename
, bs
->backing_file
);
774 if (bs
->backing_format
[0] != '\0') {
775 back_drv
= bdrv_find_format(bs
->backing_format
);
778 /* backing files always opened read-only */
780 flags
& ~(BDRV_O_RDWR
| BDRV_O_SNAPSHOT
| BDRV_O_NO_BACKING
);
782 ret
= bdrv_open(bs
->backing_hd
, backing_filename
, back_flags
, back_drv
);
787 if (bs
->is_temporary
) {
788 bs
->backing_hd
->keep_read_only
= !(flags
& BDRV_O_RDWR
);
790 /* base image inherits from "parent" */
791 bs
->backing_hd
->keep_read_only
= bs
->keep_read_only
;
795 if (!bdrv_key_required(bs
)) {
796 bdrv_dev_change_media_cb(bs
, true);
799 /* throttling disk I/O limits */
800 if (bs
->io_limits_enabled
) {
801 bdrv_io_limits_enable(bs
);
807 if (bs
->is_temporary
) {
813 void bdrv_close(BlockDriverState
*bs
)
816 if (bs
== bs_snapshots
) {
819 if (bs
->backing_hd
) {
820 bdrv_delete(bs
->backing_hd
);
821 bs
->backing_hd
= NULL
;
823 bs
->drv
->bdrv_close(bs
);
826 if (bs
->is_temporary
) {
827 unlink(bs
->filename
);
832 bs
->copy_on_read
= 0;
834 if (bs
->file
!= NULL
) {
835 bdrv_close(bs
->file
);
838 bdrv_dev_change_media_cb(bs
, false);
841 /*throttling disk I/O limits*/
842 if (bs
->io_limits_enabled
) {
843 bdrv_io_limits_disable(bs
);
847 void bdrv_close_all(void)
849 BlockDriverState
*bs
;
851 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
857 * Wait for pending requests to complete across all BlockDriverStates
859 * This function does not flush data to disk, use bdrv_flush_all() for that
860 * after calling this function.
862 void bdrv_drain_all(void)
864 BlockDriverState
*bs
;
868 /* If requests are still pending there is a bug somewhere */
869 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
870 assert(QLIST_EMPTY(&bs
->tracked_requests
));
871 assert(qemu_co_queue_empty(&bs
->throttled_reqs
));
875 /* make a BlockDriverState anonymous by removing from bdrv_state list.
876 Also, NULL terminate the device_name to prevent double remove */
877 void bdrv_make_anon(BlockDriverState
*bs
)
879 if (bs
->device_name
[0] != '\0') {
880 QTAILQ_REMOVE(&bdrv_states
, bs
, list
);
882 bs
->device_name
[0] = '\0';
885 void bdrv_delete(BlockDriverState
*bs
)
889 /* remove from list, if necessary */
893 if (bs
->file
!= NULL
) {
894 bdrv_delete(bs
->file
);
897 assert(bs
!= bs_snapshots
);
901 int bdrv_attach_dev(BlockDriverState
*bs
, void *dev
)
902 /* TODO change to DeviceState *dev when all users are qdevified */
908 bdrv_iostatus_reset(bs
);
912 /* TODO qdevified devices don't use this, remove when devices are qdevified */
913 void bdrv_attach_dev_nofail(BlockDriverState
*bs
, void *dev
)
915 if (bdrv_attach_dev(bs
, dev
) < 0) {
920 void bdrv_detach_dev(BlockDriverState
*bs
, void *dev
)
921 /* TODO change to DeviceState *dev when all users are qdevified */
923 assert(bs
->dev
== dev
);
926 bs
->dev_opaque
= NULL
;
927 bs
->buffer_alignment
= 512;
930 /* TODO change to return DeviceState * when all users are qdevified */
931 void *bdrv_get_attached_dev(BlockDriverState
*bs
)
936 void bdrv_set_dev_ops(BlockDriverState
*bs
, const BlockDevOps
*ops
,
940 bs
->dev_opaque
= opaque
;
941 if (bdrv_dev_has_removable_media(bs
) && bs
== bs_snapshots
) {
946 void bdrv_emit_qmp_error_event(const BlockDriverState
*bdrv
,
947 BlockQMPEventAction action
, int is_read
)
950 const char *action_str
;
953 case BDRV_ACTION_REPORT
:
954 action_str
= "report";
956 case BDRV_ACTION_IGNORE
:
957 action_str
= "ignore";
959 case BDRV_ACTION_STOP
:
966 data
= qobject_from_jsonf("{ 'device': %s, 'action': %s, 'operation': %s }",
969 is_read
? "read" : "write");
970 monitor_protocol_event(QEVENT_BLOCK_IO_ERROR
, data
);
972 qobject_decref(data
);
975 static void bdrv_emit_qmp_eject_event(BlockDriverState
*bs
, bool ejected
)
979 data
= qobject_from_jsonf("{ 'device': %s, 'tray-open': %i }",
980 bdrv_get_device_name(bs
), ejected
);
981 monitor_protocol_event(QEVENT_DEVICE_TRAY_MOVED
, data
);
983 qobject_decref(data
);
986 static void bdrv_dev_change_media_cb(BlockDriverState
*bs
, bool load
)
988 if (bs
->dev_ops
&& bs
->dev_ops
->change_media_cb
) {
989 bool tray_was_closed
= !bdrv_dev_is_tray_open(bs
);
990 bs
->dev_ops
->change_media_cb(bs
->dev_opaque
, load
);
991 if (tray_was_closed
) {
993 bdrv_emit_qmp_eject_event(bs
, true);
997 bdrv_emit_qmp_eject_event(bs
, false);
1002 bool bdrv_dev_has_removable_media(BlockDriverState
*bs
)
1004 return !bs
->dev
|| (bs
->dev_ops
&& bs
->dev_ops
->change_media_cb
);
1007 void bdrv_dev_eject_request(BlockDriverState
*bs
, bool force
)
1009 if (bs
->dev_ops
&& bs
->dev_ops
->eject_request_cb
) {
1010 bs
->dev_ops
->eject_request_cb(bs
->dev_opaque
, force
);
1014 bool bdrv_dev_is_tray_open(BlockDriverState
*bs
)
1016 if (bs
->dev_ops
&& bs
->dev_ops
->is_tray_open
) {
1017 return bs
->dev_ops
->is_tray_open(bs
->dev_opaque
);
1022 static void bdrv_dev_resize_cb(BlockDriverState
*bs
)
1024 if (bs
->dev_ops
&& bs
->dev_ops
->resize_cb
) {
1025 bs
->dev_ops
->resize_cb(bs
->dev_opaque
);
1029 bool bdrv_dev_is_medium_locked(BlockDriverState
*bs
)
1031 if (bs
->dev_ops
&& bs
->dev_ops
->is_medium_locked
) {
1032 return bs
->dev_ops
->is_medium_locked(bs
->dev_opaque
);
1038 * Run consistency checks on an image
1040 * Returns 0 if the check could be completed (it doesn't mean that the image is
1041 * free of errors) or -errno when an internal error occurred. The results of the
1042 * check are stored in res.
1044 int bdrv_check(BlockDriverState
*bs
, BdrvCheckResult
*res
)
1046 if (bs
->drv
->bdrv_check
== NULL
) {
1050 memset(res
, 0, sizeof(*res
));
1051 return bs
->drv
->bdrv_check(bs
, res
);
1054 #define COMMIT_BUF_SECTORS 2048
1056 /* commit COW file into the raw image */
1057 int bdrv_commit(BlockDriverState
*bs
)
1059 BlockDriver
*drv
= bs
->drv
;
1060 BlockDriver
*backing_drv
;
1061 int64_t sector
, total_sectors
;
1062 int n
, ro
, open_flags
;
1063 int ret
= 0, rw_ret
= 0;
1065 char filename
[1024];
1066 BlockDriverState
*bs_rw
, *bs_ro
;
1071 if (!bs
->backing_hd
) {
1075 if (bs
->backing_hd
->keep_read_only
) {
1079 if (bdrv_in_use(bs
) || bdrv_in_use(bs
->backing_hd
)) {
1083 backing_drv
= bs
->backing_hd
->drv
;
1084 ro
= bs
->backing_hd
->read_only
;
1085 strncpy(filename
, bs
->backing_hd
->filename
, sizeof(filename
));
1086 open_flags
= bs
->backing_hd
->open_flags
;
1090 bdrv_delete(bs
->backing_hd
);
1091 bs
->backing_hd
= NULL
;
1092 bs_rw
= bdrv_new("");
1093 rw_ret
= bdrv_open(bs_rw
, filename
, open_flags
| BDRV_O_RDWR
,
1097 /* try to re-open read-only */
1098 bs_ro
= bdrv_new("");
1099 ret
= bdrv_open(bs_ro
, filename
, open_flags
& ~BDRV_O_RDWR
,
1103 /* drive not functional anymore */
1107 bs
->backing_hd
= bs_ro
;
1110 bs
->backing_hd
= bs_rw
;
1113 total_sectors
= bdrv_getlength(bs
) >> BDRV_SECTOR_BITS
;
1114 buf
= g_malloc(COMMIT_BUF_SECTORS
* BDRV_SECTOR_SIZE
);
1116 for (sector
= 0; sector
< total_sectors
; sector
+= n
) {
1117 if (bdrv_is_allocated(bs
, sector
, COMMIT_BUF_SECTORS
, &n
)) {
1119 if (bdrv_read(bs
, sector
, buf
, n
) != 0) {
1124 if (bdrv_write(bs
->backing_hd
, sector
, buf
, n
) != 0) {
1131 if (drv
->bdrv_make_empty
) {
1132 ret
= drv
->bdrv_make_empty(bs
);
1137 * Make sure all data we wrote to the backing device is actually
1141 bdrv_flush(bs
->backing_hd
);
1148 bdrv_delete(bs
->backing_hd
);
1149 bs
->backing_hd
= NULL
;
1150 bs_ro
= bdrv_new("");
1151 ret
= bdrv_open(bs_ro
, filename
, open_flags
& ~BDRV_O_RDWR
,
1155 /* drive not functional anymore */
1159 bs
->backing_hd
= bs_ro
;
1160 bs
->backing_hd
->keep_read_only
= 0;
1166 void bdrv_commit_all(void)
1168 BlockDriverState
*bs
;
1170 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1175 struct BdrvTrackedRequest
{
1176 BlockDriverState
*bs
;
1180 QLIST_ENTRY(BdrvTrackedRequest
) list
;
1181 Coroutine
*co
; /* owner, used for deadlock detection */
1182 CoQueue wait_queue
; /* coroutines blocked on this request */
1186 * Remove an active request from the tracked requests list
1188 * This function should be called when a tracked request is completing.
1190 static void tracked_request_end(BdrvTrackedRequest
*req
)
1192 QLIST_REMOVE(req
, list
);
1193 qemu_co_queue_restart_all(&req
->wait_queue
);
1197 * Add an active request to the tracked requests list
1199 static void tracked_request_begin(BdrvTrackedRequest
*req
,
1200 BlockDriverState
*bs
,
1202 int nb_sectors
, bool is_write
)
1204 *req
= (BdrvTrackedRequest
){
1206 .sector_num
= sector_num
,
1207 .nb_sectors
= nb_sectors
,
1208 .is_write
= is_write
,
1209 .co
= qemu_coroutine_self(),
1212 qemu_co_queue_init(&req
->wait_queue
);
1214 QLIST_INSERT_HEAD(&bs
->tracked_requests
, req
, list
);
1218 * Round a region to cluster boundaries
1220 static void round_to_clusters(BlockDriverState
*bs
,
1221 int64_t sector_num
, int nb_sectors
,
1222 int64_t *cluster_sector_num
,
1223 int *cluster_nb_sectors
)
1225 BlockDriverInfo bdi
;
1227 if (bdrv_get_info(bs
, &bdi
) < 0 || bdi
.cluster_size
== 0) {
1228 *cluster_sector_num
= sector_num
;
1229 *cluster_nb_sectors
= nb_sectors
;
1231 int64_t c
= bdi
.cluster_size
/ BDRV_SECTOR_SIZE
;
1232 *cluster_sector_num
= QEMU_ALIGN_DOWN(sector_num
, c
);
1233 *cluster_nb_sectors
= QEMU_ALIGN_UP(sector_num
- *cluster_sector_num
+
1238 static bool tracked_request_overlaps(BdrvTrackedRequest
*req
,
1239 int64_t sector_num
, int nb_sectors
) {
1241 if (sector_num
>= req
->sector_num
+ req
->nb_sectors
) {
1245 if (req
->sector_num
>= sector_num
+ nb_sectors
) {
1251 static void coroutine_fn
wait_for_overlapping_requests(BlockDriverState
*bs
,
1252 int64_t sector_num
, int nb_sectors
)
1254 BdrvTrackedRequest
*req
;
1255 int64_t cluster_sector_num
;
1256 int cluster_nb_sectors
;
1259 /* If we touch the same cluster it counts as an overlap. This guarantees
1260 * that allocating writes will be serialized and not race with each other
1261 * for the same cluster. For example, in copy-on-read it ensures that the
1262 * CoR read and write operations are atomic and guest writes cannot
1263 * interleave between them.
1265 round_to_clusters(bs
, sector_num
, nb_sectors
,
1266 &cluster_sector_num
, &cluster_nb_sectors
);
1270 QLIST_FOREACH(req
, &bs
->tracked_requests
, list
) {
1271 if (tracked_request_overlaps(req
, cluster_sector_num
,
1272 cluster_nb_sectors
)) {
1273 /* Hitting this means there was a reentrant request, for
1274 * example, a block driver issuing nested requests. This must
1275 * never happen since it means deadlock.
1277 assert(qemu_coroutine_self() != req
->co
);
1279 qemu_co_queue_wait(&req
->wait_queue
);
1290 * -EINVAL - backing format specified, but no file
1291 * -ENOSPC - can't update the backing file because no space is left in the
1293 * -ENOTSUP - format driver doesn't support changing the backing file
1295 int bdrv_change_backing_file(BlockDriverState
*bs
,
1296 const char *backing_file
, const char *backing_fmt
)
1298 BlockDriver
*drv
= bs
->drv
;
1300 if (drv
->bdrv_change_backing_file
!= NULL
) {
1301 return drv
->bdrv_change_backing_file(bs
, backing_file
, backing_fmt
);
1307 static int bdrv_check_byte_request(BlockDriverState
*bs
, int64_t offset
,
1312 if (!bdrv_is_inserted(bs
))
1318 len
= bdrv_getlength(bs
);
1323 if ((offset
> len
) || (len
- offset
< size
))
1329 static int bdrv_check_request(BlockDriverState
*bs
, int64_t sector_num
,
1332 return bdrv_check_byte_request(bs
, sector_num
* BDRV_SECTOR_SIZE
,
1333 nb_sectors
* BDRV_SECTOR_SIZE
);
1336 typedef struct RwCo
{
1337 BlockDriverState
*bs
;
1345 static void coroutine_fn
bdrv_rw_co_entry(void *opaque
)
1347 RwCo
*rwco
= opaque
;
1349 if (!rwco
->is_write
) {
1350 rwco
->ret
= bdrv_co_do_readv(rwco
->bs
, rwco
->sector_num
,
1351 rwco
->nb_sectors
, rwco
->qiov
, 0);
1353 rwco
->ret
= bdrv_co_do_writev(rwco
->bs
, rwco
->sector_num
,
1354 rwco
->nb_sectors
, rwco
->qiov
, 0);
1359 * Process a synchronous request using coroutines
1361 static int bdrv_rw_co(BlockDriverState
*bs
, int64_t sector_num
, uint8_t *buf
,
1362 int nb_sectors
, bool is_write
)
1365 struct iovec iov
= {
1366 .iov_base
= (void *)buf
,
1367 .iov_len
= nb_sectors
* BDRV_SECTOR_SIZE
,
1372 .sector_num
= sector_num
,
1373 .nb_sectors
= nb_sectors
,
1375 .is_write
= is_write
,
1379 qemu_iovec_init_external(&qiov
, &iov
, 1);
1381 if (qemu_in_coroutine()) {
1382 /* Fast-path if already in coroutine context */
1383 bdrv_rw_co_entry(&rwco
);
1385 co
= qemu_coroutine_create(bdrv_rw_co_entry
);
1386 qemu_coroutine_enter(co
, &rwco
);
1387 while (rwco
.ret
== NOT_DONE
) {
1394 /* return < 0 if error. See bdrv_write() for the return codes */
1395 int bdrv_read(BlockDriverState
*bs
, int64_t sector_num
,
1396 uint8_t *buf
, int nb_sectors
)
1398 return bdrv_rw_co(bs
, sector_num
, buf
, nb_sectors
, false);
1401 static void set_dirty_bitmap(BlockDriverState
*bs
, int64_t sector_num
,
1402 int nb_sectors
, int dirty
)
1405 unsigned long val
, idx
, bit
;
1407 start
= sector_num
/ BDRV_SECTORS_PER_DIRTY_CHUNK
;
1408 end
= (sector_num
+ nb_sectors
- 1) / BDRV_SECTORS_PER_DIRTY_CHUNK
;
1410 for (; start
<= end
; start
++) {
1411 idx
= start
/ (sizeof(unsigned long) * 8);
1412 bit
= start
% (sizeof(unsigned long) * 8);
1413 val
= bs
->dirty_bitmap
[idx
];
1415 if (!(val
& (1UL << bit
))) {
1420 if (val
& (1UL << bit
)) {
1422 val
&= ~(1UL << bit
);
1425 bs
->dirty_bitmap
[idx
] = val
;
1429 /* Return < 0 if error. Important errors are:
1430 -EIO generic I/O error (may happen for all errors)
1431 -ENOMEDIUM No media inserted.
1432 -EINVAL Invalid sector number or nb_sectors
1433 -EACCES Trying to write a read-only device
1435 int bdrv_write(BlockDriverState
*bs
, int64_t sector_num
,
1436 const uint8_t *buf
, int nb_sectors
)
1438 return bdrv_rw_co(bs
, sector_num
, (uint8_t *)buf
, nb_sectors
, true);
1441 int bdrv_pread(BlockDriverState
*bs
, int64_t offset
,
1442 void *buf
, int count1
)
1444 uint8_t tmp_buf
[BDRV_SECTOR_SIZE
];
1445 int len
, nb_sectors
, count
;
1450 /* first read to align to sector start */
1451 len
= (BDRV_SECTOR_SIZE
- offset
) & (BDRV_SECTOR_SIZE
- 1);
1454 sector_num
= offset
>> BDRV_SECTOR_BITS
;
1456 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
1458 memcpy(buf
, tmp_buf
+ (offset
& (BDRV_SECTOR_SIZE
- 1)), len
);
1466 /* read the sectors "in place" */
1467 nb_sectors
= count
>> BDRV_SECTOR_BITS
;
1468 if (nb_sectors
> 0) {
1469 if ((ret
= bdrv_read(bs
, sector_num
, buf
, nb_sectors
)) < 0)
1471 sector_num
+= nb_sectors
;
1472 len
= nb_sectors
<< BDRV_SECTOR_BITS
;
1477 /* add data from the last sector */
1479 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
1481 memcpy(buf
, tmp_buf
, count
);
1486 int bdrv_pwrite(BlockDriverState
*bs
, int64_t offset
,
1487 const void *buf
, int count1
)
1489 uint8_t tmp_buf
[BDRV_SECTOR_SIZE
];
1490 int len
, nb_sectors
, count
;
1495 /* first write to align to sector start */
1496 len
= (BDRV_SECTOR_SIZE
- offset
) & (BDRV_SECTOR_SIZE
- 1);
1499 sector_num
= offset
>> BDRV_SECTOR_BITS
;
1501 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
1503 memcpy(tmp_buf
+ (offset
& (BDRV_SECTOR_SIZE
- 1)), buf
, len
);
1504 if ((ret
= bdrv_write(bs
, sector_num
, tmp_buf
, 1)) < 0)
1513 /* write the sectors "in place" */
1514 nb_sectors
= count
>> BDRV_SECTOR_BITS
;
1515 if (nb_sectors
> 0) {
1516 if ((ret
= bdrv_write(bs
, sector_num
, buf
, nb_sectors
)) < 0)
1518 sector_num
+= nb_sectors
;
1519 len
= nb_sectors
<< BDRV_SECTOR_BITS
;
1524 /* add data from the last sector */
1526 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
1528 memcpy(tmp_buf
, buf
, count
);
1529 if ((ret
= bdrv_write(bs
, sector_num
, tmp_buf
, 1)) < 0)
1536 * Writes to the file and ensures that no writes are reordered across this
1537 * request (acts as a barrier)
1539 * Returns 0 on success, -errno in error cases.
1541 int bdrv_pwrite_sync(BlockDriverState
*bs
, int64_t offset
,
1542 const void *buf
, int count
)
1546 ret
= bdrv_pwrite(bs
, offset
, buf
, count
);
1551 /* No flush needed for cache modes that use O_DSYNC */
1552 if ((bs
->open_flags
& BDRV_O_CACHE_WB
) != 0) {
1559 static int coroutine_fn
bdrv_co_do_copy_on_readv(BlockDriverState
*bs
,
1560 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
)
1562 /* Perform I/O through a temporary buffer so that users who scribble over
1563 * their read buffer while the operation is in progress do not end up
1564 * modifying the image file. This is critical for zero-copy guest I/O
1565 * where anything might happen inside guest memory.
1567 void *bounce_buffer
;
1569 BlockDriver
*drv
= bs
->drv
;
1571 QEMUIOVector bounce_qiov
;
1572 int64_t cluster_sector_num
;
1573 int cluster_nb_sectors
;
1577 /* Cover entire cluster so no additional backing file I/O is required when
1578 * allocating cluster in the image file.
1580 round_to_clusters(bs
, sector_num
, nb_sectors
,
1581 &cluster_sector_num
, &cluster_nb_sectors
);
1583 trace_bdrv_co_do_copy_on_readv(bs
, sector_num
, nb_sectors
,
1584 cluster_sector_num
, cluster_nb_sectors
);
1586 iov
.iov_len
= cluster_nb_sectors
* BDRV_SECTOR_SIZE
;
1587 iov
.iov_base
= bounce_buffer
= qemu_blockalign(bs
, iov
.iov_len
);
1588 qemu_iovec_init_external(&bounce_qiov
, &iov
, 1);
1590 ret
= drv
->bdrv_co_readv(bs
, cluster_sector_num
, cluster_nb_sectors
,
1596 if (drv
->bdrv_co_write_zeroes
&&
1597 buffer_is_zero(bounce_buffer
, iov
.iov_len
)) {
1598 ret
= drv
->bdrv_co_write_zeroes(bs
, cluster_sector_num
,
1599 cluster_nb_sectors
);
1601 ret
= drv
->bdrv_co_writev(bs
, cluster_sector_num
, cluster_nb_sectors
,
1606 /* It might be okay to ignore write errors for guest requests. If this
1607 * is a deliberate copy-on-read then we don't want to ignore the error.
1608 * Simply report it in all cases.
1613 skip_bytes
= (sector_num
- cluster_sector_num
) * BDRV_SECTOR_SIZE
;
1614 qemu_iovec_from_buffer(qiov
, bounce_buffer
+ skip_bytes
,
1615 nb_sectors
* BDRV_SECTOR_SIZE
);
1618 qemu_vfree(bounce_buffer
);
1623 * Handle a read request in coroutine context
1625 static int coroutine_fn
bdrv_co_do_readv(BlockDriverState
*bs
,
1626 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
,
1627 BdrvRequestFlags flags
)
1629 BlockDriver
*drv
= bs
->drv
;
1630 BdrvTrackedRequest req
;
1636 if (bdrv_check_request(bs
, sector_num
, nb_sectors
)) {
1640 /* throttling disk read I/O */
1641 if (bs
->io_limits_enabled
) {
1642 bdrv_io_limits_intercept(bs
, false, nb_sectors
);
1645 if (bs
->copy_on_read
) {
1646 flags
|= BDRV_REQ_COPY_ON_READ
;
1648 if (flags
& BDRV_REQ_COPY_ON_READ
) {
1649 bs
->copy_on_read_in_flight
++;
1652 if (bs
->copy_on_read_in_flight
) {
1653 wait_for_overlapping_requests(bs
, sector_num
, nb_sectors
);
1656 tracked_request_begin(&req
, bs
, sector_num
, nb_sectors
, false);
1658 if (flags
& BDRV_REQ_COPY_ON_READ
) {
1661 ret
= bdrv_co_is_allocated(bs
, sector_num
, nb_sectors
, &pnum
);
1666 if (!ret
|| pnum
!= nb_sectors
) {
1667 ret
= bdrv_co_do_copy_on_readv(bs
, sector_num
, nb_sectors
, qiov
);
1672 ret
= drv
->bdrv_co_readv(bs
, sector_num
, nb_sectors
, qiov
);
1675 tracked_request_end(&req
);
1677 if (flags
& BDRV_REQ_COPY_ON_READ
) {
1678 bs
->copy_on_read_in_flight
--;
1684 int coroutine_fn
bdrv_co_readv(BlockDriverState
*bs
, int64_t sector_num
,
1685 int nb_sectors
, QEMUIOVector
*qiov
)
1687 trace_bdrv_co_readv(bs
, sector_num
, nb_sectors
);
1689 return bdrv_co_do_readv(bs
, sector_num
, nb_sectors
, qiov
, 0);
1692 int coroutine_fn
bdrv_co_copy_on_readv(BlockDriverState
*bs
,
1693 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
)
1695 trace_bdrv_co_copy_on_readv(bs
, sector_num
, nb_sectors
);
1697 return bdrv_co_do_readv(bs
, sector_num
, nb_sectors
, qiov
,
1698 BDRV_REQ_COPY_ON_READ
);
1701 static int coroutine_fn
bdrv_co_do_write_zeroes(BlockDriverState
*bs
,
1702 int64_t sector_num
, int nb_sectors
)
1704 BlockDriver
*drv
= bs
->drv
;
1709 /* First try the efficient write zeroes operation */
1710 if (drv
->bdrv_co_write_zeroes
) {
1711 return drv
->bdrv_co_write_zeroes(bs
, sector_num
, nb_sectors
);
1714 /* Fall back to bounce buffer if write zeroes is unsupported */
1715 iov
.iov_len
= nb_sectors
* BDRV_SECTOR_SIZE
;
1716 iov
.iov_base
= qemu_blockalign(bs
, iov
.iov_len
);
1717 memset(iov
.iov_base
, 0, iov
.iov_len
);
1718 qemu_iovec_init_external(&qiov
, &iov
, 1);
1720 ret
= drv
->bdrv_co_writev(bs
, sector_num
, nb_sectors
, &qiov
);
1722 qemu_vfree(iov
.iov_base
);
1727 * Handle a write request in coroutine context
1729 static int coroutine_fn
bdrv_co_do_writev(BlockDriverState
*bs
,
1730 int64_t sector_num
, int nb_sectors
, QEMUIOVector
*qiov
,
1731 BdrvRequestFlags flags
)
1733 BlockDriver
*drv
= bs
->drv
;
1734 BdrvTrackedRequest req
;
1740 if (bs
->read_only
) {
1743 if (bdrv_check_request(bs
, sector_num
, nb_sectors
)) {
1747 /* throttling disk write I/O */
1748 if (bs
->io_limits_enabled
) {
1749 bdrv_io_limits_intercept(bs
, true, nb_sectors
);
1752 if (bs
->copy_on_read_in_flight
) {
1753 wait_for_overlapping_requests(bs
, sector_num
, nb_sectors
);
1756 tracked_request_begin(&req
, bs
, sector_num
, nb_sectors
, true);
1758 if (flags
& BDRV_REQ_ZERO_WRITE
) {
1759 ret
= bdrv_co_do_write_zeroes(bs
, sector_num
, nb_sectors
);
1761 ret
= drv
->bdrv_co_writev(bs
, sector_num
, nb_sectors
, qiov
);
1764 if (bs
->dirty_bitmap
) {
1765 set_dirty_bitmap(bs
, sector_num
, nb_sectors
, 1);
1768 if (bs
->wr_highest_sector
< sector_num
+ nb_sectors
- 1) {
1769 bs
->wr_highest_sector
= sector_num
+ nb_sectors
- 1;
1772 tracked_request_end(&req
);
1777 int coroutine_fn
bdrv_co_writev(BlockDriverState
*bs
, int64_t sector_num
,
1778 int nb_sectors
, QEMUIOVector
*qiov
)
1780 trace_bdrv_co_writev(bs
, sector_num
, nb_sectors
);
1782 return bdrv_co_do_writev(bs
, sector_num
, nb_sectors
, qiov
, 0);
1785 int coroutine_fn
bdrv_co_write_zeroes(BlockDriverState
*bs
,
1786 int64_t sector_num
, int nb_sectors
)
1788 trace_bdrv_co_write_zeroes(bs
, sector_num
, nb_sectors
);
1790 return bdrv_co_do_writev(bs
, sector_num
, nb_sectors
, NULL
,
1791 BDRV_REQ_ZERO_WRITE
);
1795 * Truncate file to 'offset' bytes (needed only for file protocols)
1797 int bdrv_truncate(BlockDriverState
*bs
, int64_t offset
)
1799 BlockDriver
*drv
= bs
->drv
;
1803 if (!drv
->bdrv_truncate
)
1807 if (bdrv_in_use(bs
))
1809 ret
= drv
->bdrv_truncate(bs
, offset
);
1811 ret
= refresh_total_sectors(bs
, offset
>> BDRV_SECTOR_BITS
);
1812 bdrv_dev_resize_cb(bs
);
1818 * Length of a allocated file in bytes. Sparse files are counted by actual
1819 * allocated space. Return < 0 if error or unknown.
1821 int64_t bdrv_get_allocated_file_size(BlockDriverState
*bs
)
1823 BlockDriver
*drv
= bs
->drv
;
1827 if (drv
->bdrv_get_allocated_file_size
) {
1828 return drv
->bdrv_get_allocated_file_size(bs
);
1831 return bdrv_get_allocated_file_size(bs
->file
);
1837 * Length of a file in bytes. Return < 0 if error or unknown.
1839 int64_t bdrv_getlength(BlockDriverState
*bs
)
1841 BlockDriver
*drv
= bs
->drv
;
1845 if (bs
->growable
|| bdrv_dev_has_removable_media(bs
)) {
1846 if (drv
->bdrv_getlength
) {
1847 return drv
->bdrv_getlength(bs
);
1850 return bs
->total_sectors
* BDRV_SECTOR_SIZE
;
1853 /* return 0 as number of sectors if no device present or error */
1854 void bdrv_get_geometry(BlockDriverState
*bs
, uint64_t *nb_sectors_ptr
)
1857 length
= bdrv_getlength(bs
);
1861 length
= length
>> BDRV_SECTOR_BITS
;
1862 *nb_sectors_ptr
= length
;
1866 uint8_t boot_ind
; /* 0x80 - active */
1867 uint8_t head
; /* starting head */
1868 uint8_t sector
; /* starting sector */
1869 uint8_t cyl
; /* starting cylinder */
1870 uint8_t sys_ind
; /* What partition type */
1871 uint8_t end_head
; /* end head */
1872 uint8_t end_sector
; /* end sector */
1873 uint8_t end_cyl
; /* end cylinder */
1874 uint32_t start_sect
; /* starting sector counting from 0 */
1875 uint32_t nr_sects
; /* nr of sectors in partition */
1878 /* try to guess the disk logical geometry from the MSDOS partition table. Return 0 if OK, -1 if could not guess */
1879 static int guess_disk_lchs(BlockDriverState
*bs
,
1880 int *pcylinders
, int *pheads
, int *psectors
)
1882 uint8_t buf
[BDRV_SECTOR_SIZE
];
1883 int ret
, i
, heads
, sectors
, cylinders
;
1884 struct partition
*p
;
1886 uint64_t nb_sectors
;
1888 bdrv_get_geometry(bs
, &nb_sectors
);
1890 ret
= bdrv_read(bs
, 0, buf
, 1);
1893 /* test msdos magic */
1894 if (buf
[510] != 0x55 || buf
[511] != 0xaa)
1896 for(i
= 0; i
< 4; i
++) {
1897 p
= ((struct partition
*)(buf
+ 0x1be)) + i
;
1898 nr_sects
= le32_to_cpu(p
->nr_sects
);
1899 if (nr_sects
&& p
->end_head
) {
1900 /* We make the assumption that the partition terminates on
1901 a cylinder boundary */
1902 heads
= p
->end_head
+ 1;
1903 sectors
= p
->end_sector
& 63;
1906 cylinders
= nb_sectors
/ (heads
* sectors
);
1907 if (cylinders
< 1 || cylinders
> 16383)
1910 *psectors
= sectors
;
1911 *pcylinders
= cylinders
;
1913 printf("guessed geometry: LCHS=%d %d %d\n",
1914 cylinders
, heads
, sectors
);
1922 void bdrv_guess_geometry(BlockDriverState
*bs
, int *pcyls
, int *pheads
, int *psecs
)
1924 int translation
, lba_detected
= 0;
1925 int cylinders
, heads
, secs
;
1926 uint64_t nb_sectors
;
1928 /* if a geometry hint is available, use it */
1929 bdrv_get_geometry(bs
, &nb_sectors
);
1930 bdrv_get_geometry_hint(bs
, &cylinders
, &heads
, &secs
);
1931 translation
= bdrv_get_translation_hint(bs
);
1932 if (cylinders
!= 0) {
1937 if (guess_disk_lchs(bs
, &cylinders
, &heads
, &secs
) == 0) {
1939 /* if heads > 16, it means that a BIOS LBA
1940 translation was active, so the default
1941 hardware geometry is OK */
1943 goto default_geometry
;
1948 /* disable any translation to be in sync with
1949 the logical geometry */
1950 if (translation
== BIOS_ATA_TRANSLATION_AUTO
) {
1951 bdrv_set_translation_hint(bs
,
1952 BIOS_ATA_TRANSLATION_NONE
);
1957 /* if no geometry, use a standard physical disk geometry */
1958 cylinders
= nb_sectors
/ (16 * 63);
1960 if (cylinders
> 16383)
1962 else if (cylinders
< 2)
1967 if ((lba_detected
== 1) && (translation
== BIOS_ATA_TRANSLATION_AUTO
)) {
1968 if ((*pcyls
* *pheads
) <= 131072) {
1969 bdrv_set_translation_hint(bs
,
1970 BIOS_ATA_TRANSLATION_LARGE
);
1972 bdrv_set_translation_hint(bs
,
1973 BIOS_ATA_TRANSLATION_LBA
);
1977 bdrv_set_geometry_hint(bs
, *pcyls
, *pheads
, *psecs
);
1981 void bdrv_set_geometry_hint(BlockDriverState
*bs
,
1982 int cyls
, int heads
, int secs
)
1989 void bdrv_set_translation_hint(BlockDriverState
*bs
, int translation
)
1991 bs
->translation
= translation
;
1994 void bdrv_get_geometry_hint(BlockDriverState
*bs
,
1995 int *pcyls
, int *pheads
, int *psecs
)
1998 *pheads
= bs
->heads
;
2002 /* throttling disk io limits */
2003 void bdrv_set_io_limits(BlockDriverState
*bs
,
2004 BlockIOLimit
*io_limits
)
2006 bs
->io_limits
= *io_limits
;
2007 bs
->io_limits_enabled
= bdrv_io_limits_enabled(bs
);
2010 /* Recognize floppy formats */
2011 typedef struct FDFormat
{
2018 static const FDFormat fd_formats
[] = {
2019 /* First entry is default format */
2020 /* 1.44 MB 3"1/2 floppy disks */
2021 { FDRIVE_DRV_144
, 18, 80, 1, },
2022 { FDRIVE_DRV_144
, 20, 80, 1, },
2023 { FDRIVE_DRV_144
, 21, 80, 1, },
2024 { FDRIVE_DRV_144
, 21, 82, 1, },
2025 { FDRIVE_DRV_144
, 21, 83, 1, },
2026 { FDRIVE_DRV_144
, 22, 80, 1, },
2027 { FDRIVE_DRV_144
, 23, 80, 1, },
2028 { FDRIVE_DRV_144
, 24, 80, 1, },
2029 /* 2.88 MB 3"1/2 floppy disks */
2030 { FDRIVE_DRV_288
, 36, 80, 1, },
2031 { FDRIVE_DRV_288
, 39, 80, 1, },
2032 { FDRIVE_DRV_288
, 40, 80, 1, },
2033 { FDRIVE_DRV_288
, 44, 80, 1, },
2034 { FDRIVE_DRV_288
, 48, 80, 1, },
2035 /* 720 kB 3"1/2 floppy disks */
2036 { FDRIVE_DRV_144
, 9, 80, 1, },
2037 { FDRIVE_DRV_144
, 10, 80, 1, },
2038 { FDRIVE_DRV_144
, 10, 82, 1, },
2039 { FDRIVE_DRV_144
, 10, 83, 1, },
2040 { FDRIVE_DRV_144
, 13, 80, 1, },
2041 { FDRIVE_DRV_144
, 14, 80, 1, },
2042 /* 1.2 MB 5"1/4 floppy disks */
2043 { FDRIVE_DRV_120
, 15, 80, 1, },
2044 { FDRIVE_DRV_120
, 18, 80, 1, },
2045 { FDRIVE_DRV_120
, 18, 82, 1, },
2046 { FDRIVE_DRV_120
, 18, 83, 1, },
2047 { FDRIVE_DRV_120
, 20, 80, 1, },
2048 /* 720 kB 5"1/4 floppy disks */
2049 { FDRIVE_DRV_120
, 9, 80, 1, },
2050 { FDRIVE_DRV_120
, 11, 80, 1, },
2051 /* 360 kB 5"1/4 floppy disks */
2052 { FDRIVE_DRV_120
, 9, 40, 1, },
2053 { FDRIVE_DRV_120
, 9, 40, 0, },
2054 { FDRIVE_DRV_120
, 10, 41, 1, },
2055 { FDRIVE_DRV_120
, 10, 42, 1, },
2056 /* 320 kB 5"1/4 floppy disks */
2057 { FDRIVE_DRV_120
, 8, 40, 1, },
2058 { FDRIVE_DRV_120
, 8, 40, 0, },
2059 /* 360 kB must match 5"1/4 better than 3"1/2... */
2060 { FDRIVE_DRV_144
, 9, 80, 0, },
2062 { FDRIVE_DRV_NONE
, -1, -1, 0, },
2065 void bdrv_get_floppy_geometry_hint(BlockDriverState
*bs
, int *nb_heads
,
2066 int *max_track
, int *last_sect
,
2067 FDriveType drive_in
, FDriveType
*drive
)
2069 const FDFormat
*parse
;
2070 uint64_t nb_sectors
, size
;
2071 int i
, first_match
, match
;
2073 bdrv_get_geometry_hint(bs
, nb_heads
, max_track
, last_sect
);
2074 if (*nb_heads
!= 0 && *max_track
!= 0 && *last_sect
!= 0) {
2075 /* User defined disk */
2077 bdrv_get_geometry(bs
, &nb_sectors
);
2080 for (i
= 0; ; i
++) {
2081 parse
= &fd_formats
[i
];
2082 if (parse
->drive
== FDRIVE_DRV_NONE
) {
2085 if (drive_in
== parse
->drive
||
2086 drive_in
== FDRIVE_DRV_NONE
) {
2087 size
= (parse
->max_head
+ 1) * parse
->max_track
*
2089 if (nb_sectors
== size
) {
2093 if (first_match
== -1) {
2099 if (first_match
== -1) {
2102 match
= first_match
;
2104 parse
= &fd_formats
[match
];
2106 *nb_heads
= parse
->max_head
+ 1;
2107 *max_track
= parse
->max_track
;
2108 *last_sect
= parse
->last_sect
;
2109 *drive
= parse
->drive
;
2113 int bdrv_get_translation_hint(BlockDriverState
*bs
)
2115 return bs
->translation
;
2118 void bdrv_set_on_error(BlockDriverState
*bs
, BlockErrorAction on_read_error
,
2119 BlockErrorAction on_write_error
)
2121 bs
->on_read_error
= on_read_error
;
2122 bs
->on_write_error
= on_write_error
;
2125 BlockErrorAction
bdrv_get_on_error(BlockDriverState
*bs
, int is_read
)
2127 return is_read
? bs
->on_read_error
: bs
->on_write_error
;
2130 int bdrv_is_read_only(BlockDriverState
*bs
)
2132 return bs
->read_only
;
2135 int bdrv_is_sg(BlockDriverState
*bs
)
2140 int bdrv_enable_write_cache(BlockDriverState
*bs
)
2142 return bs
->enable_write_cache
;
2145 int bdrv_is_encrypted(BlockDriverState
*bs
)
2147 if (bs
->backing_hd
&& bs
->backing_hd
->encrypted
)
2149 return bs
->encrypted
;
2152 int bdrv_key_required(BlockDriverState
*bs
)
2154 BlockDriverState
*backing_hd
= bs
->backing_hd
;
2156 if (backing_hd
&& backing_hd
->encrypted
&& !backing_hd
->valid_key
)
2158 return (bs
->encrypted
&& !bs
->valid_key
);
2161 int bdrv_set_key(BlockDriverState
*bs
, const char *key
)
2164 if (bs
->backing_hd
&& bs
->backing_hd
->encrypted
) {
2165 ret
= bdrv_set_key(bs
->backing_hd
, key
);
2171 if (!bs
->encrypted
) {
2173 } else if (!bs
->drv
|| !bs
->drv
->bdrv_set_key
) {
2176 ret
= bs
->drv
->bdrv_set_key(bs
, key
);
2179 } else if (!bs
->valid_key
) {
2181 /* call the change callback now, we skipped it on open */
2182 bdrv_dev_change_media_cb(bs
, true);
2187 void bdrv_get_format(BlockDriverState
*bs
, char *buf
, int buf_size
)
2192 pstrcpy(buf
, buf_size
, bs
->drv
->format_name
);
2196 void bdrv_iterate_format(void (*it
)(void *opaque
, const char *name
),
2201 QLIST_FOREACH(drv
, &bdrv_drivers
, list
) {
2202 it(opaque
, drv
->format_name
);
2206 BlockDriverState
*bdrv_find(const char *name
)
2208 BlockDriverState
*bs
;
2210 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2211 if (!strcmp(name
, bs
->device_name
)) {
2218 BlockDriverState
*bdrv_next(BlockDriverState
*bs
)
2221 return QTAILQ_FIRST(&bdrv_states
);
2223 return QTAILQ_NEXT(bs
, list
);
2226 void bdrv_iterate(void (*it
)(void *opaque
, BlockDriverState
*bs
), void *opaque
)
2228 BlockDriverState
*bs
;
2230 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2235 const char *bdrv_get_device_name(BlockDriverState
*bs
)
2237 return bs
->device_name
;
2240 void bdrv_flush_all(void)
2242 BlockDriverState
*bs
;
2244 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2245 if (!bdrv_is_read_only(bs
) && bdrv_is_inserted(bs
)) {
2251 int bdrv_has_zero_init(BlockDriverState
*bs
)
2255 if (bs
->drv
->bdrv_has_zero_init
) {
2256 return bs
->drv
->bdrv_has_zero_init(bs
);
2262 typedef struct BdrvCoIsAllocatedData
{
2263 BlockDriverState
*bs
;
2269 } BdrvCoIsAllocatedData
;
2272 * Returns true iff the specified sector is present in the disk image. Drivers
2273 * not implementing the functionality are assumed to not support backing files,
2274 * hence all their sectors are reported as allocated.
2276 * If 'sector_num' is beyond the end of the disk image the return value is 0
2277 * and 'pnum' is set to 0.
2279 * 'pnum' is set to the number of sectors (including and immediately following
2280 * the specified sector) that are known to be in the same
2281 * allocated/unallocated state.
2283 * 'nb_sectors' is the max value 'pnum' should be set to. If nb_sectors goes
2284 * beyond the end of the disk image it will be clamped.
2286 int coroutine_fn
bdrv_co_is_allocated(BlockDriverState
*bs
, int64_t sector_num
,
2287 int nb_sectors
, int *pnum
)
2291 if (sector_num
>= bs
->total_sectors
) {
2296 n
= bs
->total_sectors
- sector_num
;
2297 if (n
< nb_sectors
) {
2301 if (!bs
->drv
->bdrv_co_is_allocated
) {
2306 return bs
->drv
->bdrv_co_is_allocated(bs
, sector_num
, nb_sectors
, pnum
);
2309 /* Coroutine wrapper for bdrv_is_allocated() */
2310 static void coroutine_fn
bdrv_is_allocated_co_entry(void *opaque
)
2312 BdrvCoIsAllocatedData
*data
= opaque
;
2313 BlockDriverState
*bs
= data
->bs
;
2315 data
->ret
= bdrv_co_is_allocated(bs
, data
->sector_num
, data
->nb_sectors
,
2321 * Synchronous wrapper around bdrv_co_is_allocated().
2323 * See bdrv_co_is_allocated() for details.
2325 int bdrv_is_allocated(BlockDriverState
*bs
, int64_t sector_num
, int nb_sectors
,
2329 BdrvCoIsAllocatedData data
= {
2331 .sector_num
= sector_num
,
2332 .nb_sectors
= nb_sectors
,
2337 co
= qemu_coroutine_create(bdrv_is_allocated_co_entry
);
2338 qemu_coroutine_enter(co
, &data
);
2339 while (!data
.done
) {
2345 BlockInfoList
*qmp_query_block(Error
**errp
)
2347 BlockInfoList
*head
= NULL
, *cur_item
= NULL
;
2348 BlockDriverState
*bs
;
2350 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2351 BlockInfoList
*info
= g_malloc0(sizeof(*info
));
2353 info
->value
= g_malloc0(sizeof(*info
->value
));
2354 info
->value
->device
= g_strdup(bs
->device_name
);
2355 info
->value
->type
= g_strdup("unknown");
2356 info
->value
->locked
= bdrv_dev_is_medium_locked(bs
);
2357 info
->value
->removable
= bdrv_dev_has_removable_media(bs
);
2359 if (bdrv_dev_has_removable_media(bs
)) {
2360 info
->value
->has_tray_open
= true;
2361 info
->value
->tray_open
= bdrv_dev_is_tray_open(bs
);
2364 if (bdrv_iostatus_is_enabled(bs
)) {
2365 info
->value
->has_io_status
= true;
2366 info
->value
->io_status
= bs
->iostatus
;
2370 info
->value
->has_inserted
= true;
2371 info
->value
->inserted
= g_malloc0(sizeof(*info
->value
->inserted
));
2372 info
->value
->inserted
->file
= g_strdup(bs
->filename
);
2373 info
->value
->inserted
->ro
= bs
->read_only
;
2374 info
->value
->inserted
->drv
= g_strdup(bs
->drv
->format_name
);
2375 info
->value
->inserted
->encrypted
= bs
->encrypted
;
2376 if (bs
->backing_file
[0]) {
2377 info
->value
->inserted
->has_backing_file
= true;
2378 info
->value
->inserted
->backing_file
= g_strdup(bs
->backing_file
);
2381 if (bs
->io_limits_enabled
) {
2382 info
->value
->inserted
->bps
=
2383 bs
->io_limits
.bps
[BLOCK_IO_LIMIT_TOTAL
];
2384 info
->value
->inserted
->bps_rd
=
2385 bs
->io_limits
.bps
[BLOCK_IO_LIMIT_READ
];
2386 info
->value
->inserted
->bps_wr
=
2387 bs
->io_limits
.bps
[BLOCK_IO_LIMIT_WRITE
];
2388 info
->value
->inserted
->iops
=
2389 bs
->io_limits
.iops
[BLOCK_IO_LIMIT_TOTAL
];
2390 info
->value
->inserted
->iops_rd
=
2391 bs
->io_limits
.iops
[BLOCK_IO_LIMIT_READ
];
2392 info
->value
->inserted
->iops_wr
=
2393 bs
->io_limits
.iops
[BLOCK_IO_LIMIT_WRITE
];
2397 /* XXX: waiting for the qapi to support GSList */
2399 head
= cur_item
= info
;
2401 cur_item
->next
= info
;
2409 /* Consider exposing this as a full fledged QMP command */
2410 static BlockStats
*qmp_query_blockstat(const BlockDriverState
*bs
, Error
**errp
)
2414 s
= g_malloc0(sizeof(*s
));
2416 if (bs
->device_name
[0]) {
2417 s
->has_device
= true;
2418 s
->device
= g_strdup(bs
->device_name
);
2421 s
->stats
= g_malloc0(sizeof(*s
->stats
));
2422 s
->stats
->rd_bytes
= bs
->nr_bytes
[BDRV_ACCT_READ
];
2423 s
->stats
->wr_bytes
= bs
->nr_bytes
[BDRV_ACCT_WRITE
];
2424 s
->stats
->rd_operations
= bs
->nr_ops
[BDRV_ACCT_READ
];
2425 s
->stats
->wr_operations
= bs
->nr_ops
[BDRV_ACCT_WRITE
];
2426 s
->stats
->wr_highest_offset
= bs
->wr_highest_sector
* BDRV_SECTOR_SIZE
;
2427 s
->stats
->flush_operations
= bs
->nr_ops
[BDRV_ACCT_FLUSH
];
2428 s
->stats
->wr_total_time_ns
= bs
->total_time_ns
[BDRV_ACCT_WRITE
];
2429 s
->stats
->rd_total_time_ns
= bs
->total_time_ns
[BDRV_ACCT_READ
];
2430 s
->stats
->flush_total_time_ns
= bs
->total_time_ns
[BDRV_ACCT_FLUSH
];
2433 s
->has_parent
= true;
2434 s
->parent
= qmp_query_blockstat(bs
->file
, NULL
);
2440 BlockStatsList
*qmp_query_blockstats(Error
**errp
)
2442 BlockStatsList
*head
= NULL
, *cur_item
= NULL
;
2443 BlockDriverState
*bs
;
2445 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
2446 BlockStatsList
*info
= g_malloc0(sizeof(*info
));
2447 info
->value
= qmp_query_blockstat(bs
, NULL
);
2449 /* XXX: waiting for the qapi to support GSList */
2451 head
= cur_item
= info
;
2453 cur_item
->next
= info
;
2461 const char *bdrv_get_encrypted_filename(BlockDriverState
*bs
)
2463 if (bs
->backing_hd
&& bs
->backing_hd
->encrypted
)
2464 return bs
->backing_file
;
2465 else if (bs
->encrypted
)
2466 return bs
->filename
;
2471 void bdrv_get_backing_filename(BlockDriverState
*bs
,
2472 char *filename
, int filename_size
)
2474 pstrcpy(filename
, filename_size
, bs
->backing_file
);
2477 int bdrv_write_compressed(BlockDriverState
*bs
, int64_t sector_num
,
2478 const uint8_t *buf
, int nb_sectors
)
2480 BlockDriver
*drv
= bs
->drv
;
2483 if (!drv
->bdrv_write_compressed
)
2485 if (bdrv_check_request(bs
, sector_num
, nb_sectors
))
2488 if (bs
->dirty_bitmap
) {
2489 set_dirty_bitmap(bs
, sector_num
, nb_sectors
, 1);
2492 return drv
->bdrv_write_compressed(bs
, sector_num
, buf
, nb_sectors
);
2495 int bdrv_get_info(BlockDriverState
*bs
, BlockDriverInfo
*bdi
)
2497 BlockDriver
*drv
= bs
->drv
;
2500 if (!drv
->bdrv_get_info
)
2502 memset(bdi
, 0, sizeof(*bdi
));
2503 return drv
->bdrv_get_info(bs
, bdi
);
2506 int bdrv_save_vmstate(BlockDriverState
*bs
, const uint8_t *buf
,
2507 int64_t pos
, int size
)
2509 BlockDriver
*drv
= bs
->drv
;
2512 if (drv
->bdrv_save_vmstate
)
2513 return drv
->bdrv_save_vmstate(bs
, buf
, pos
, size
);
2515 return bdrv_save_vmstate(bs
->file
, buf
, pos
, size
);
2519 int bdrv_load_vmstate(BlockDriverState
*bs
, uint8_t *buf
,
2520 int64_t pos
, int size
)
2522 BlockDriver
*drv
= bs
->drv
;
2525 if (drv
->bdrv_load_vmstate
)
2526 return drv
->bdrv_load_vmstate(bs
, buf
, pos
, size
);
2528 return bdrv_load_vmstate(bs
->file
, buf
, pos
, size
);
2532 void bdrv_debug_event(BlockDriverState
*bs
, BlkDebugEvent event
)
2534 BlockDriver
*drv
= bs
->drv
;
2536 if (!drv
|| !drv
->bdrv_debug_event
) {
2540 return drv
->bdrv_debug_event(bs
, event
);
2544 /**************************************************************/
2545 /* handling of snapshots */
2547 int bdrv_can_snapshot(BlockDriverState
*bs
)
2549 BlockDriver
*drv
= bs
->drv
;
2550 if (!drv
|| !bdrv_is_inserted(bs
) || bdrv_is_read_only(bs
)) {
2554 if (!drv
->bdrv_snapshot_create
) {
2555 if (bs
->file
!= NULL
) {
2556 return bdrv_can_snapshot(bs
->file
);
2564 int bdrv_is_snapshot(BlockDriverState
*bs
)
2566 return !!(bs
->open_flags
& BDRV_O_SNAPSHOT
);
2569 BlockDriverState
*bdrv_snapshots(void)
2571 BlockDriverState
*bs
;
2574 return bs_snapshots
;
2578 while ((bs
= bdrv_next(bs
))) {
2579 if (bdrv_can_snapshot(bs
)) {
2587 int bdrv_snapshot_create(BlockDriverState
*bs
,
2588 QEMUSnapshotInfo
*sn_info
)
2590 BlockDriver
*drv
= bs
->drv
;
2593 if (drv
->bdrv_snapshot_create
)
2594 return drv
->bdrv_snapshot_create(bs
, sn_info
);
2596 return bdrv_snapshot_create(bs
->file
, sn_info
);
2600 int bdrv_snapshot_goto(BlockDriverState
*bs
,
2601 const char *snapshot_id
)
2603 BlockDriver
*drv
= bs
->drv
;
2608 if (drv
->bdrv_snapshot_goto
)
2609 return drv
->bdrv_snapshot_goto(bs
, snapshot_id
);
2612 drv
->bdrv_close(bs
);
2613 ret
= bdrv_snapshot_goto(bs
->file
, snapshot_id
);
2614 open_ret
= drv
->bdrv_open(bs
, bs
->open_flags
);
2616 bdrv_delete(bs
->file
);
2626 int bdrv_snapshot_delete(BlockDriverState
*bs
, const char *snapshot_id
)
2628 BlockDriver
*drv
= bs
->drv
;
2631 if (drv
->bdrv_snapshot_delete
)
2632 return drv
->bdrv_snapshot_delete(bs
, snapshot_id
);
2634 return bdrv_snapshot_delete(bs
->file
, snapshot_id
);
2638 int bdrv_snapshot_list(BlockDriverState
*bs
,
2639 QEMUSnapshotInfo
**psn_info
)
2641 BlockDriver
*drv
= bs
->drv
;
2644 if (drv
->bdrv_snapshot_list
)
2645 return drv
->bdrv_snapshot_list(bs
, psn_info
);
2647 return bdrv_snapshot_list(bs
->file
, psn_info
);
2651 int bdrv_snapshot_load_tmp(BlockDriverState
*bs
,
2652 const char *snapshot_name
)
2654 BlockDriver
*drv
= bs
->drv
;
2658 if (!bs
->read_only
) {
2661 if (drv
->bdrv_snapshot_load_tmp
) {
2662 return drv
->bdrv_snapshot_load_tmp(bs
, snapshot_name
);
2667 BlockDriverState
*bdrv_find_backing_image(BlockDriverState
*bs
,
2668 const char *backing_file
)
2674 if (bs
->backing_hd
) {
2675 if (strcmp(bs
->backing_file
, backing_file
) == 0) {
2676 return bs
->backing_hd
;
2678 return bdrv_find_backing_image(bs
->backing_hd
, backing_file
);
2685 #define NB_SUFFIXES 4
2687 char *get_human_readable_size(char *buf
, int buf_size
, int64_t size
)
2689 static const char suffixes
[NB_SUFFIXES
] = "KMGT";
2694 snprintf(buf
, buf_size
, "%" PRId64
, size
);
2697 for(i
= 0; i
< NB_SUFFIXES
; i
++) {
2698 if (size
< (10 * base
)) {
2699 snprintf(buf
, buf_size
, "%0.1f%c",
2700 (double)size
/ base
,
2703 } else if (size
< (1000 * base
) || i
== (NB_SUFFIXES
- 1)) {
2704 snprintf(buf
, buf_size
, "%" PRId64
"%c",
2705 ((size
+ (base
>> 1)) / base
),
2715 char *bdrv_snapshot_dump(char *buf
, int buf_size
, QEMUSnapshotInfo
*sn
)
2717 char buf1
[128], date_buf
[128], clock_buf
[128];
2727 snprintf(buf
, buf_size
,
2728 "%-10s%-20s%7s%20s%15s",
2729 "ID", "TAG", "VM SIZE", "DATE", "VM CLOCK");
2733 ptm
= localtime(&ti
);
2734 strftime(date_buf
, sizeof(date_buf
),
2735 "%Y-%m-%d %H:%M:%S", ptm
);
2737 localtime_r(&ti
, &tm
);
2738 strftime(date_buf
, sizeof(date_buf
),
2739 "%Y-%m-%d %H:%M:%S", &tm
);
2741 secs
= sn
->vm_clock_nsec
/ 1000000000;
2742 snprintf(clock_buf
, sizeof(clock_buf
),
2743 "%02d:%02d:%02d.%03d",
2745 (int)((secs
/ 60) % 60),
2747 (int)((sn
->vm_clock_nsec
/ 1000000) % 1000));
2748 snprintf(buf
, buf_size
,
2749 "%-10s%-20s%7s%20s%15s",
2750 sn
->id_str
, sn
->name
,
2751 get_human_readable_size(buf1
, sizeof(buf1
), sn
->vm_state_size
),
2758 /**************************************************************/
2761 BlockDriverAIOCB
*bdrv_aio_readv(BlockDriverState
*bs
, int64_t sector_num
,
2762 QEMUIOVector
*qiov
, int nb_sectors
,
2763 BlockDriverCompletionFunc
*cb
, void *opaque
)
2765 trace_bdrv_aio_readv(bs
, sector_num
, nb_sectors
, opaque
);
2767 return bdrv_co_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
,
2771 BlockDriverAIOCB
*bdrv_aio_writev(BlockDriverState
*bs
, int64_t sector_num
,
2772 QEMUIOVector
*qiov
, int nb_sectors
,
2773 BlockDriverCompletionFunc
*cb
, void *opaque
)
2775 trace_bdrv_aio_writev(bs
, sector_num
, nb_sectors
, opaque
);
2777 return bdrv_co_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
,
2782 typedef struct MultiwriteCB
{
2787 BlockDriverCompletionFunc
*cb
;
2789 QEMUIOVector
*free_qiov
;
2794 static void multiwrite_user_cb(MultiwriteCB
*mcb
)
2798 for (i
= 0; i
< mcb
->num_callbacks
; i
++) {
2799 mcb
->callbacks
[i
].cb(mcb
->callbacks
[i
].opaque
, mcb
->error
);
2800 if (mcb
->callbacks
[i
].free_qiov
) {
2801 qemu_iovec_destroy(mcb
->callbacks
[i
].free_qiov
);
2803 g_free(mcb
->callbacks
[i
].free_qiov
);
2804 qemu_vfree(mcb
->callbacks
[i
].free_buf
);
2808 static void multiwrite_cb(void *opaque
, int ret
)
2810 MultiwriteCB
*mcb
= opaque
;
2812 trace_multiwrite_cb(mcb
, ret
);
2814 if (ret
< 0 && !mcb
->error
) {
2818 mcb
->num_requests
--;
2819 if (mcb
->num_requests
== 0) {
2820 multiwrite_user_cb(mcb
);
2825 static int multiwrite_req_compare(const void *a
, const void *b
)
2827 const BlockRequest
*req1
= a
, *req2
= b
;
2830 * Note that we can't simply subtract req2->sector from req1->sector
2831 * here as that could overflow the return value.
2833 if (req1
->sector
> req2
->sector
) {
2835 } else if (req1
->sector
< req2
->sector
) {
2843 * Takes a bunch of requests and tries to merge them. Returns the number of
2844 * requests that remain after merging.
2846 static int multiwrite_merge(BlockDriverState
*bs
, BlockRequest
*reqs
,
2847 int num_reqs
, MultiwriteCB
*mcb
)
2851 // Sort requests by start sector
2852 qsort(reqs
, num_reqs
, sizeof(*reqs
), &multiwrite_req_compare
);
2854 // Check if adjacent requests touch the same clusters. If so, combine them,
2855 // filling up gaps with zero sectors.
2857 for (i
= 1; i
< num_reqs
; i
++) {
2859 int64_t oldreq_last
= reqs
[outidx
].sector
+ reqs
[outidx
].nb_sectors
;
2861 // This handles the cases that are valid for all block drivers, namely
2862 // exactly sequential writes and overlapping writes.
2863 if (reqs
[i
].sector
<= oldreq_last
) {
2867 // The block driver may decide that it makes sense to combine requests
2868 // even if there is a gap of some sectors between them. In this case,
2869 // the gap is filled with zeros (therefore only applicable for yet
2870 // unused space in format like qcow2).
2871 if (!merge
&& bs
->drv
->bdrv_merge_requests
) {
2872 merge
= bs
->drv
->bdrv_merge_requests(bs
, &reqs
[outidx
], &reqs
[i
]);
2875 if (reqs
[outidx
].qiov
->niov
+ reqs
[i
].qiov
->niov
+ 1 > IOV_MAX
) {
2881 QEMUIOVector
*qiov
= g_malloc0(sizeof(*qiov
));
2882 qemu_iovec_init(qiov
,
2883 reqs
[outidx
].qiov
->niov
+ reqs
[i
].qiov
->niov
+ 1);
2885 // Add the first request to the merged one. If the requests are
2886 // overlapping, drop the last sectors of the first request.
2887 size
= (reqs
[i
].sector
- reqs
[outidx
].sector
) << 9;
2888 qemu_iovec_concat(qiov
, reqs
[outidx
].qiov
, size
);
2890 // We might need to add some zeros between the two requests
2891 if (reqs
[i
].sector
> oldreq_last
) {
2892 size_t zero_bytes
= (reqs
[i
].sector
- oldreq_last
) << 9;
2893 uint8_t *buf
= qemu_blockalign(bs
, zero_bytes
);
2894 memset(buf
, 0, zero_bytes
);
2895 qemu_iovec_add(qiov
, buf
, zero_bytes
);
2896 mcb
->callbacks
[i
].free_buf
= buf
;
2899 // Add the second request
2900 qemu_iovec_concat(qiov
, reqs
[i
].qiov
, reqs
[i
].qiov
->size
);
2902 reqs
[outidx
].nb_sectors
= qiov
->size
>> 9;
2903 reqs
[outidx
].qiov
= qiov
;
2905 mcb
->callbacks
[i
].free_qiov
= reqs
[outidx
].qiov
;
2908 reqs
[outidx
].sector
= reqs
[i
].sector
;
2909 reqs
[outidx
].nb_sectors
= reqs
[i
].nb_sectors
;
2910 reqs
[outidx
].qiov
= reqs
[i
].qiov
;
2918 * Submit multiple AIO write requests at once.
2920 * On success, the function returns 0 and all requests in the reqs array have
2921 * been submitted. In error case this function returns -1, and any of the
2922 * requests may or may not be submitted yet. In particular, this means that the
2923 * callback will be called for some of the requests, for others it won't. The
2924 * caller must check the error field of the BlockRequest to wait for the right
2925 * callbacks (if error != 0, no callback will be called).
2927 * The implementation may modify the contents of the reqs array, e.g. to merge
2928 * requests. However, the fields opaque and error are left unmodified as they
2929 * are used to signal failure for a single request to the caller.
2931 int bdrv_aio_multiwrite(BlockDriverState
*bs
, BlockRequest
*reqs
, int num_reqs
)
2936 /* don't submit writes if we don't have a medium */
2937 if (bs
->drv
== NULL
) {
2938 for (i
= 0; i
< num_reqs
; i
++) {
2939 reqs
[i
].error
= -ENOMEDIUM
;
2944 if (num_reqs
== 0) {
2948 // Create MultiwriteCB structure
2949 mcb
= g_malloc0(sizeof(*mcb
) + num_reqs
* sizeof(*mcb
->callbacks
));
2950 mcb
->num_requests
= 0;
2951 mcb
->num_callbacks
= num_reqs
;
2953 for (i
= 0; i
< num_reqs
; i
++) {
2954 mcb
->callbacks
[i
].cb
= reqs
[i
].cb
;
2955 mcb
->callbacks
[i
].opaque
= reqs
[i
].opaque
;
2958 // Check for mergable requests
2959 num_reqs
= multiwrite_merge(bs
, reqs
, num_reqs
, mcb
);
2961 trace_bdrv_aio_multiwrite(mcb
, mcb
->num_callbacks
, num_reqs
);
2963 /* Run the aio requests. */
2964 mcb
->num_requests
= num_reqs
;
2965 for (i
= 0; i
< num_reqs
; i
++) {
2966 bdrv_aio_writev(bs
, reqs
[i
].sector
, reqs
[i
].qiov
,
2967 reqs
[i
].nb_sectors
, multiwrite_cb
, mcb
);
2973 void bdrv_aio_cancel(BlockDriverAIOCB
*acb
)
2975 acb
->pool
->cancel(acb
);
2978 /* block I/O throttling */
2979 static bool bdrv_exceed_bps_limits(BlockDriverState
*bs
, int nb_sectors
,
2980 bool is_write
, double elapsed_time
, uint64_t *wait
)
2982 uint64_t bps_limit
= 0;
2983 double bytes_limit
, bytes_base
, bytes_res
;
2984 double slice_time
, wait_time
;
2986 if (bs
->io_limits
.bps
[BLOCK_IO_LIMIT_TOTAL
]) {
2987 bps_limit
= bs
->io_limits
.bps
[BLOCK_IO_LIMIT_TOTAL
];
2988 } else if (bs
->io_limits
.bps
[is_write
]) {
2989 bps_limit
= bs
->io_limits
.bps
[is_write
];
2998 slice_time
= bs
->slice_end
- bs
->slice_start
;
2999 slice_time
/= (NANOSECONDS_PER_SECOND
);
3000 bytes_limit
= bps_limit
* slice_time
;
3001 bytes_base
= bs
->nr_bytes
[is_write
] - bs
->io_base
.bytes
[is_write
];
3002 if (bs
->io_limits
.bps
[BLOCK_IO_LIMIT_TOTAL
]) {
3003 bytes_base
+= bs
->nr_bytes
[!is_write
] - bs
->io_base
.bytes
[!is_write
];
3006 /* bytes_base: the bytes of data which have been read/written; and
3007 * it is obtained from the history statistic info.
3008 * bytes_res: the remaining bytes of data which need to be read/written.
3009 * (bytes_base + bytes_res) / bps_limit: used to calcuate
3010 * the total time for completing reading/writting all data.
3012 bytes_res
= (unsigned) nb_sectors
* BDRV_SECTOR_SIZE
;
3014 if (bytes_base
+ bytes_res
<= bytes_limit
) {
3022 /* Calc approx time to dispatch */
3023 wait_time
= (bytes_base
+ bytes_res
) / bps_limit
- elapsed_time
;
3025 /* When the I/O rate at runtime exceeds the limits,
3026 * bs->slice_end need to be extended in order that the current statistic
3027 * info can be kept until the timer fire, so it is increased and tuned
3028 * based on the result of experiment.
3030 bs
->slice_time
= wait_time
* BLOCK_IO_SLICE_TIME
* 10;
3031 bs
->slice_end
+= bs
->slice_time
- 3 * BLOCK_IO_SLICE_TIME
;
3033 *wait
= wait_time
* BLOCK_IO_SLICE_TIME
* 10;
3039 static bool bdrv_exceed_iops_limits(BlockDriverState
*bs
, bool is_write
,
3040 double elapsed_time
, uint64_t *wait
)
3042 uint64_t iops_limit
= 0;
3043 double ios_limit
, ios_base
;
3044 double slice_time
, wait_time
;
3046 if (bs
->io_limits
.iops
[BLOCK_IO_LIMIT_TOTAL
]) {
3047 iops_limit
= bs
->io_limits
.iops
[BLOCK_IO_LIMIT_TOTAL
];
3048 } else if (bs
->io_limits
.iops
[is_write
]) {
3049 iops_limit
= bs
->io_limits
.iops
[is_write
];
3058 slice_time
= bs
->slice_end
- bs
->slice_start
;
3059 slice_time
/= (NANOSECONDS_PER_SECOND
);
3060 ios_limit
= iops_limit
* slice_time
;
3061 ios_base
= bs
->nr_ops
[is_write
] - bs
->io_base
.ios
[is_write
];
3062 if (bs
->io_limits
.iops
[BLOCK_IO_LIMIT_TOTAL
]) {
3063 ios_base
+= bs
->nr_ops
[!is_write
] - bs
->io_base
.ios
[!is_write
];
3066 if (ios_base
+ 1 <= ios_limit
) {
3074 /* Calc approx time to dispatch */
3075 wait_time
= (ios_base
+ 1) / iops_limit
;
3076 if (wait_time
> elapsed_time
) {
3077 wait_time
= wait_time
- elapsed_time
;
3082 bs
->slice_time
= wait_time
* BLOCK_IO_SLICE_TIME
* 10;
3083 bs
->slice_end
+= bs
->slice_time
- 3 * BLOCK_IO_SLICE_TIME
;
3085 *wait
= wait_time
* BLOCK_IO_SLICE_TIME
* 10;
3091 static bool bdrv_exceed_io_limits(BlockDriverState
*bs
, int nb_sectors
,
3092 bool is_write
, int64_t *wait
)
3094 int64_t now
, max_wait
;
3095 uint64_t bps_wait
= 0, iops_wait
= 0;
3096 double elapsed_time
;
3097 int bps_ret
, iops_ret
;
3099 now
= qemu_get_clock_ns(vm_clock
);
3100 if ((bs
->slice_start
< now
)
3101 && (bs
->slice_end
> now
)) {
3102 bs
->slice_end
= now
+ bs
->slice_time
;
3104 bs
->slice_time
= 5 * BLOCK_IO_SLICE_TIME
;
3105 bs
->slice_start
= now
;
3106 bs
->slice_end
= now
+ bs
->slice_time
;
3108 bs
->io_base
.bytes
[is_write
] = bs
->nr_bytes
[is_write
];
3109 bs
->io_base
.bytes
[!is_write
] = bs
->nr_bytes
[!is_write
];
3111 bs
->io_base
.ios
[is_write
] = bs
->nr_ops
[is_write
];
3112 bs
->io_base
.ios
[!is_write
] = bs
->nr_ops
[!is_write
];
3115 elapsed_time
= now
- bs
->slice_start
;
3116 elapsed_time
/= (NANOSECONDS_PER_SECOND
);
3118 bps_ret
= bdrv_exceed_bps_limits(bs
, nb_sectors
,
3119 is_write
, elapsed_time
, &bps_wait
);
3120 iops_ret
= bdrv_exceed_iops_limits(bs
, is_write
,
3121 elapsed_time
, &iops_wait
);
3122 if (bps_ret
|| iops_ret
) {
3123 max_wait
= bps_wait
> iops_wait
? bps_wait
: iops_wait
;
3128 now
= qemu_get_clock_ns(vm_clock
);
3129 if (bs
->slice_end
< now
+ max_wait
) {
3130 bs
->slice_end
= now
+ max_wait
;
3143 /**************************************************************/
3144 /* async block device emulation */
3146 typedef struct BlockDriverAIOCBSync
{
3147 BlockDriverAIOCB common
;
3150 /* vector translation state */
3154 } BlockDriverAIOCBSync
;
3156 static void bdrv_aio_cancel_em(BlockDriverAIOCB
*blockacb
)
3158 BlockDriverAIOCBSync
*acb
=
3159 container_of(blockacb
, BlockDriverAIOCBSync
, common
);
3160 qemu_bh_delete(acb
->bh
);
3162 qemu_aio_release(acb
);
3165 static AIOPool bdrv_em_aio_pool
= {
3166 .aiocb_size
= sizeof(BlockDriverAIOCBSync
),
3167 .cancel
= bdrv_aio_cancel_em
,
3170 static void bdrv_aio_bh_cb(void *opaque
)
3172 BlockDriverAIOCBSync
*acb
= opaque
;
3175 qemu_iovec_from_buffer(acb
->qiov
, acb
->bounce
, acb
->qiov
->size
);
3176 qemu_vfree(acb
->bounce
);
3177 acb
->common
.cb(acb
->common
.opaque
, acb
->ret
);
3178 qemu_bh_delete(acb
->bh
);
3180 qemu_aio_release(acb
);
3183 static BlockDriverAIOCB
*bdrv_aio_rw_vector(BlockDriverState
*bs
,
3187 BlockDriverCompletionFunc
*cb
,
3192 BlockDriverAIOCBSync
*acb
;
3194 acb
= qemu_aio_get(&bdrv_em_aio_pool
, bs
, cb
, opaque
);
3195 acb
->is_write
= is_write
;
3197 acb
->bounce
= qemu_blockalign(bs
, qiov
->size
);
3198 acb
->bh
= qemu_bh_new(bdrv_aio_bh_cb
, acb
);
3201 qemu_iovec_to_buffer(acb
->qiov
, acb
->bounce
);
3202 acb
->ret
= bs
->drv
->bdrv_write(bs
, sector_num
, acb
->bounce
, nb_sectors
);
3204 acb
->ret
= bs
->drv
->bdrv_read(bs
, sector_num
, acb
->bounce
, nb_sectors
);
3207 qemu_bh_schedule(acb
->bh
);
3209 return &acb
->common
;
3212 static BlockDriverAIOCB
*bdrv_aio_readv_em(BlockDriverState
*bs
,
3213 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
3214 BlockDriverCompletionFunc
*cb
, void *opaque
)
3216 return bdrv_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
, cb
, opaque
, 0);
3219 static BlockDriverAIOCB
*bdrv_aio_writev_em(BlockDriverState
*bs
,
3220 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
3221 BlockDriverCompletionFunc
*cb
, void *opaque
)
3223 return bdrv_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
, cb
, opaque
, 1);
3227 typedef struct BlockDriverAIOCBCoroutine
{
3228 BlockDriverAIOCB common
;
3232 } BlockDriverAIOCBCoroutine
;
3234 static void bdrv_aio_co_cancel_em(BlockDriverAIOCB
*blockacb
)
3239 static AIOPool bdrv_em_co_aio_pool
= {
3240 .aiocb_size
= sizeof(BlockDriverAIOCBCoroutine
),
3241 .cancel
= bdrv_aio_co_cancel_em
,
3244 static void bdrv_co_em_bh(void *opaque
)
3246 BlockDriverAIOCBCoroutine
*acb
= opaque
;
3248 acb
->common
.cb(acb
->common
.opaque
, acb
->req
.error
);
3249 qemu_bh_delete(acb
->bh
);
3250 qemu_aio_release(acb
);
3253 /* Invoke bdrv_co_do_readv/bdrv_co_do_writev */
3254 static void coroutine_fn
bdrv_co_do_rw(void *opaque
)
3256 BlockDriverAIOCBCoroutine
*acb
= opaque
;
3257 BlockDriverState
*bs
= acb
->common
.bs
;
3259 if (!acb
->is_write
) {
3260 acb
->req
.error
= bdrv_co_do_readv(bs
, acb
->req
.sector
,
3261 acb
->req
.nb_sectors
, acb
->req
.qiov
, 0);
3263 acb
->req
.error
= bdrv_co_do_writev(bs
, acb
->req
.sector
,
3264 acb
->req
.nb_sectors
, acb
->req
.qiov
, 0);
3267 acb
->bh
= qemu_bh_new(bdrv_co_em_bh
, acb
);
3268 qemu_bh_schedule(acb
->bh
);
3271 static BlockDriverAIOCB
*bdrv_co_aio_rw_vector(BlockDriverState
*bs
,
3275 BlockDriverCompletionFunc
*cb
,
3280 BlockDriverAIOCBCoroutine
*acb
;
3282 acb
= qemu_aio_get(&bdrv_em_co_aio_pool
, bs
, cb
, opaque
);
3283 acb
->req
.sector
= sector_num
;
3284 acb
->req
.nb_sectors
= nb_sectors
;
3285 acb
->req
.qiov
= qiov
;
3286 acb
->is_write
= is_write
;
3288 co
= qemu_coroutine_create(bdrv_co_do_rw
);
3289 qemu_coroutine_enter(co
, acb
);
3291 return &acb
->common
;
3294 static void coroutine_fn
bdrv_aio_flush_co_entry(void *opaque
)
3296 BlockDriverAIOCBCoroutine
*acb
= opaque
;
3297 BlockDriverState
*bs
= acb
->common
.bs
;
3299 acb
->req
.error
= bdrv_co_flush(bs
);
3300 acb
->bh
= qemu_bh_new(bdrv_co_em_bh
, acb
);
3301 qemu_bh_schedule(acb
->bh
);
3304 BlockDriverAIOCB
*bdrv_aio_flush(BlockDriverState
*bs
,
3305 BlockDriverCompletionFunc
*cb
, void *opaque
)
3307 trace_bdrv_aio_flush(bs
, opaque
);
3310 BlockDriverAIOCBCoroutine
*acb
;
3312 acb
= qemu_aio_get(&bdrv_em_co_aio_pool
, bs
, cb
, opaque
);
3313 co
= qemu_coroutine_create(bdrv_aio_flush_co_entry
);
3314 qemu_coroutine_enter(co
, acb
);
3316 return &acb
->common
;
3319 static void coroutine_fn
bdrv_aio_discard_co_entry(void *opaque
)
3321 BlockDriverAIOCBCoroutine
*acb
= opaque
;
3322 BlockDriverState
*bs
= acb
->common
.bs
;
3324 acb
->req
.error
= bdrv_co_discard(bs
, acb
->req
.sector
, acb
->req
.nb_sectors
);
3325 acb
->bh
= qemu_bh_new(bdrv_co_em_bh
, acb
);
3326 qemu_bh_schedule(acb
->bh
);
3329 BlockDriverAIOCB
*bdrv_aio_discard(BlockDriverState
*bs
,
3330 int64_t sector_num
, int nb_sectors
,
3331 BlockDriverCompletionFunc
*cb
, void *opaque
)
3334 BlockDriverAIOCBCoroutine
*acb
;
3336 trace_bdrv_aio_discard(bs
, sector_num
, nb_sectors
, opaque
);
3338 acb
= qemu_aio_get(&bdrv_em_co_aio_pool
, bs
, cb
, opaque
);
3339 acb
->req
.sector
= sector_num
;
3340 acb
->req
.nb_sectors
= nb_sectors
;
3341 co
= qemu_coroutine_create(bdrv_aio_discard_co_entry
);
3342 qemu_coroutine_enter(co
, acb
);
3344 return &acb
->common
;
3347 void bdrv_init(void)
3349 module_call_init(MODULE_INIT_BLOCK
);
3352 void bdrv_init_with_whitelist(void)
3354 use_bdrv_whitelist
= 1;
3358 void *qemu_aio_get(AIOPool
*pool
, BlockDriverState
*bs
,
3359 BlockDriverCompletionFunc
*cb
, void *opaque
)
3361 BlockDriverAIOCB
*acb
;
3363 if (pool
->free_aiocb
) {
3364 acb
= pool
->free_aiocb
;
3365 pool
->free_aiocb
= acb
->next
;
3367 acb
= g_malloc0(pool
->aiocb_size
);
3372 acb
->opaque
= opaque
;
3376 void qemu_aio_release(void *p
)
3378 BlockDriverAIOCB
*acb
= (BlockDriverAIOCB
*)p
;
3379 AIOPool
*pool
= acb
->pool
;
3380 acb
->next
= pool
->free_aiocb
;
3381 pool
->free_aiocb
= acb
;
3384 /**************************************************************/
3385 /* Coroutine block device emulation */
3387 typedef struct CoroutineIOCompletion
{
3388 Coroutine
*coroutine
;
3390 } CoroutineIOCompletion
;
3392 static void bdrv_co_io_em_complete(void *opaque
, int ret
)
3394 CoroutineIOCompletion
*co
= opaque
;
3397 qemu_coroutine_enter(co
->coroutine
, NULL
);
3400 static int coroutine_fn
bdrv_co_io_em(BlockDriverState
*bs
, int64_t sector_num
,
3401 int nb_sectors
, QEMUIOVector
*iov
,
3404 CoroutineIOCompletion co
= {
3405 .coroutine
= qemu_coroutine_self(),
3407 BlockDriverAIOCB
*acb
;
3410 acb
= bs
->drv
->bdrv_aio_writev(bs
, sector_num
, iov
, nb_sectors
,
3411 bdrv_co_io_em_complete
, &co
);
3413 acb
= bs
->drv
->bdrv_aio_readv(bs
, sector_num
, iov
, nb_sectors
,
3414 bdrv_co_io_em_complete
, &co
);
3417 trace_bdrv_co_io_em(bs
, sector_num
, nb_sectors
, is_write
, acb
);
3421 qemu_coroutine_yield();
3426 static int coroutine_fn
bdrv_co_readv_em(BlockDriverState
*bs
,
3427 int64_t sector_num
, int nb_sectors
,
3430 return bdrv_co_io_em(bs
, sector_num
, nb_sectors
, iov
, false);
3433 static int coroutine_fn
bdrv_co_writev_em(BlockDriverState
*bs
,
3434 int64_t sector_num
, int nb_sectors
,
3437 return bdrv_co_io_em(bs
, sector_num
, nb_sectors
, iov
, true);
3440 static void coroutine_fn
bdrv_flush_co_entry(void *opaque
)
3442 RwCo
*rwco
= opaque
;
3444 rwco
->ret
= bdrv_co_flush(rwco
->bs
);
3447 int coroutine_fn
bdrv_co_flush(BlockDriverState
*bs
)
3455 /* Write back cached data to the OS even with cache=unsafe */
3456 if (bs
->drv
->bdrv_co_flush_to_os
) {
3457 ret
= bs
->drv
->bdrv_co_flush_to_os(bs
);
3463 /* But don't actually force it to the disk with cache=unsafe */
3464 if (bs
->open_flags
& BDRV_O_NO_FLUSH
) {
3468 if (bs
->drv
->bdrv_co_flush_to_disk
) {
3469 return bs
->drv
->bdrv_co_flush_to_disk(bs
);
3470 } else if (bs
->drv
->bdrv_aio_flush
) {
3471 BlockDriverAIOCB
*acb
;
3472 CoroutineIOCompletion co
= {
3473 .coroutine
= qemu_coroutine_self(),
3476 acb
= bs
->drv
->bdrv_aio_flush(bs
, bdrv_co_io_em_complete
, &co
);
3480 qemu_coroutine_yield();
3485 * Some block drivers always operate in either writethrough or unsafe
3486 * mode and don't support bdrv_flush therefore. Usually qemu doesn't
3487 * know how the server works (because the behaviour is hardcoded or
3488 * depends on server-side configuration), so we can't ensure that
3489 * everything is safe on disk. Returning an error doesn't work because
3490 * that would break guests even if the server operates in writethrough
3493 * Let's hope the user knows what he's doing.
3499 void bdrv_invalidate_cache(BlockDriverState
*bs
)
3501 if (bs
->drv
&& bs
->drv
->bdrv_invalidate_cache
) {
3502 bs
->drv
->bdrv_invalidate_cache(bs
);
3506 void bdrv_invalidate_cache_all(void)
3508 BlockDriverState
*bs
;
3510 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
3511 bdrv_invalidate_cache(bs
);
3515 int bdrv_flush(BlockDriverState
*bs
)
3523 if (qemu_in_coroutine()) {
3524 /* Fast-path if already in coroutine context */
3525 bdrv_flush_co_entry(&rwco
);
3527 co
= qemu_coroutine_create(bdrv_flush_co_entry
);
3528 qemu_coroutine_enter(co
, &rwco
);
3529 while (rwco
.ret
== NOT_DONE
) {
3537 static void coroutine_fn
bdrv_discard_co_entry(void *opaque
)
3539 RwCo
*rwco
= opaque
;
3541 rwco
->ret
= bdrv_co_discard(rwco
->bs
, rwco
->sector_num
, rwco
->nb_sectors
);
3544 int coroutine_fn
bdrv_co_discard(BlockDriverState
*bs
, int64_t sector_num
,
3549 } else if (bdrv_check_request(bs
, sector_num
, nb_sectors
)) {
3551 } else if (bs
->read_only
) {
3553 } else if (bs
->drv
->bdrv_co_discard
) {
3554 return bs
->drv
->bdrv_co_discard(bs
, sector_num
, nb_sectors
);
3555 } else if (bs
->drv
->bdrv_aio_discard
) {
3556 BlockDriverAIOCB
*acb
;
3557 CoroutineIOCompletion co
= {
3558 .coroutine
= qemu_coroutine_self(),
3561 acb
= bs
->drv
->bdrv_aio_discard(bs
, sector_num
, nb_sectors
,
3562 bdrv_co_io_em_complete
, &co
);
3566 qemu_coroutine_yield();
3574 int bdrv_discard(BlockDriverState
*bs
, int64_t sector_num
, int nb_sectors
)
3579 .sector_num
= sector_num
,
3580 .nb_sectors
= nb_sectors
,
3584 if (qemu_in_coroutine()) {
3585 /* Fast-path if already in coroutine context */
3586 bdrv_discard_co_entry(&rwco
);
3588 co
= qemu_coroutine_create(bdrv_discard_co_entry
);
3589 qemu_coroutine_enter(co
, &rwco
);
3590 while (rwco
.ret
== NOT_DONE
) {
3598 /**************************************************************/
3599 /* removable device support */
3602 * Return TRUE if the media is present
3604 int bdrv_is_inserted(BlockDriverState
*bs
)
3606 BlockDriver
*drv
= bs
->drv
;
3610 if (!drv
->bdrv_is_inserted
)
3612 return drv
->bdrv_is_inserted(bs
);
3616 * Return whether the media changed since the last call to this
3617 * function, or -ENOTSUP if we don't know. Most drivers don't know.
3619 int bdrv_media_changed(BlockDriverState
*bs
)
3621 BlockDriver
*drv
= bs
->drv
;
3623 if (drv
&& drv
->bdrv_media_changed
) {
3624 return drv
->bdrv_media_changed(bs
);
3630 * If eject_flag is TRUE, eject the media. Otherwise, close the tray
3632 void bdrv_eject(BlockDriverState
*bs
, bool eject_flag
)
3634 BlockDriver
*drv
= bs
->drv
;
3636 if (drv
&& drv
->bdrv_eject
) {
3637 drv
->bdrv_eject(bs
, eject_flag
);
3640 if (bs
->device_name
[0] != '\0') {
3641 bdrv_emit_qmp_eject_event(bs
, eject_flag
);
3646 * Lock or unlock the media (if it is locked, the user won't be able
3647 * to eject it manually).
3649 void bdrv_lock_medium(BlockDriverState
*bs
, bool locked
)
3651 BlockDriver
*drv
= bs
->drv
;
3653 trace_bdrv_lock_medium(bs
, locked
);
3655 if (drv
&& drv
->bdrv_lock_medium
) {
3656 drv
->bdrv_lock_medium(bs
, locked
);
3660 /* needed for generic scsi interface */
3662 int bdrv_ioctl(BlockDriverState
*bs
, unsigned long int req
, void *buf
)
3664 BlockDriver
*drv
= bs
->drv
;
3666 if (drv
&& drv
->bdrv_ioctl
)
3667 return drv
->bdrv_ioctl(bs
, req
, buf
);
3671 BlockDriverAIOCB
*bdrv_aio_ioctl(BlockDriverState
*bs
,
3672 unsigned long int req
, void *buf
,
3673 BlockDriverCompletionFunc
*cb
, void *opaque
)
3675 BlockDriver
*drv
= bs
->drv
;
3677 if (drv
&& drv
->bdrv_aio_ioctl
)
3678 return drv
->bdrv_aio_ioctl(bs
, req
, buf
, cb
, opaque
);
3682 void bdrv_set_buffer_alignment(BlockDriverState
*bs
, int align
)
3684 bs
->buffer_alignment
= align
;
3687 void *qemu_blockalign(BlockDriverState
*bs
, size_t size
)
3689 return qemu_memalign((bs
&& bs
->buffer_alignment
) ? bs
->buffer_alignment
: 512, size
);
3692 void bdrv_set_dirty_tracking(BlockDriverState
*bs
, int enable
)
3694 int64_t bitmap_size
;
3696 bs
->dirty_count
= 0;
3698 if (!bs
->dirty_bitmap
) {
3699 bitmap_size
= (bdrv_getlength(bs
) >> BDRV_SECTOR_BITS
) +
3700 BDRV_SECTORS_PER_DIRTY_CHUNK
* 8 - 1;
3701 bitmap_size
/= BDRV_SECTORS_PER_DIRTY_CHUNK
* 8;
3703 bs
->dirty_bitmap
= g_malloc0(bitmap_size
);
3706 if (bs
->dirty_bitmap
) {
3707 g_free(bs
->dirty_bitmap
);
3708 bs
->dirty_bitmap
= NULL
;
3713 int bdrv_get_dirty(BlockDriverState
*bs
, int64_t sector
)
3715 int64_t chunk
= sector
/ (int64_t)BDRV_SECTORS_PER_DIRTY_CHUNK
;
3717 if (bs
->dirty_bitmap
&&
3718 (sector
<< BDRV_SECTOR_BITS
) < bdrv_getlength(bs
)) {
3719 return !!(bs
->dirty_bitmap
[chunk
/ (sizeof(unsigned long) * 8)] &
3720 (1UL << (chunk
% (sizeof(unsigned long) * 8))));
3726 void bdrv_reset_dirty(BlockDriverState
*bs
, int64_t cur_sector
,
3729 set_dirty_bitmap(bs
, cur_sector
, nr_sectors
, 0);
3732 int64_t bdrv_get_dirty_count(BlockDriverState
*bs
)
3734 return bs
->dirty_count
;
3737 void bdrv_set_in_use(BlockDriverState
*bs
, int in_use
)
3739 assert(bs
->in_use
!= in_use
);
3740 bs
->in_use
= in_use
;
3743 int bdrv_in_use(BlockDriverState
*bs
)
3748 void bdrv_iostatus_enable(BlockDriverState
*bs
)
3750 bs
->iostatus_enabled
= true;
3751 bs
->iostatus
= BLOCK_DEVICE_IO_STATUS_OK
;
3754 /* The I/O status is only enabled if the drive explicitly
3755 * enables it _and_ the VM is configured to stop on errors */
3756 bool bdrv_iostatus_is_enabled(const BlockDriverState
*bs
)
3758 return (bs
->iostatus_enabled
&&
3759 (bs
->on_write_error
== BLOCK_ERR_STOP_ENOSPC
||
3760 bs
->on_write_error
== BLOCK_ERR_STOP_ANY
||
3761 bs
->on_read_error
== BLOCK_ERR_STOP_ANY
));
3764 void bdrv_iostatus_disable(BlockDriverState
*bs
)
3766 bs
->iostatus_enabled
= false;
3769 void bdrv_iostatus_reset(BlockDriverState
*bs
)
3771 if (bdrv_iostatus_is_enabled(bs
)) {
3772 bs
->iostatus
= BLOCK_DEVICE_IO_STATUS_OK
;
3776 /* XXX: Today this is set by device models because it makes the implementation
3777 quite simple. However, the block layer knows about the error, so it's
3778 possible to implement this without device models being involved */
3779 void bdrv_iostatus_set_err(BlockDriverState
*bs
, int error
)
3781 if (bdrv_iostatus_is_enabled(bs
) &&
3782 bs
->iostatus
== BLOCK_DEVICE_IO_STATUS_OK
) {
3784 bs
->iostatus
= error
== ENOSPC
? BLOCK_DEVICE_IO_STATUS_NOSPACE
:
3785 BLOCK_DEVICE_IO_STATUS_FAILED
;
3790 bdrv_acct_start(BlockDriverState
*bs
, BlockAcctCookie
*cookie
, int64_t bytes
,
3791 enum BlockAcctType type
)
3793 assert(type
< BDRV_MAX_IOTYPE
);
3795 cookie
->bytes
= bytes
;
3796 cookie
->start_time_ns
= get_clock();
3797 cookie
->type
= type
;
3801 bdrv_acct_done(BlockDriverState
*bs
, BlockAcctCookie
*cookie
)
3803 assert(cookie
->type
< BDRV_MAX_IOTYPE
);
3805 bs
->nr_bytes
[cookie
->type
] += cookie
->bytes
;
3806 bs
->nr_ops
[cookie
->type
]++;
3807 bs
->total_time_ns
[cookie
->type
] += get_clock() - cookie
->start_time_ns
;
3810 int bdrv_img_create(const char *filename
, const char *fmt
,
3811 const char *base_filename
, const char *base_fmt
,
3812 char *options
, uint64_t img_size
, int flags
)
3814 QEMUOptionParameter
*param
= NULL
, *create_options
= NULL
;
3815 QEMUOptionParameter
*backing_fmt
, *backing_file
, *size
;
3816 BlockDriverState
*bs
= NULL
;
3817 BlockDriver
*drv
, *proto_drv
;
3818 BlockDriver
*backing_drv
= NULL
;
3821 /* Find driver and parse its options */
3822 drv
= bdrv_find_format(fmt
);
3824 error_report("Unknown file format '%s'", fmt
);
3829 proto_drv
= bdrv_find_protocol(filename
);
3831 error_report("Unknown protocol '%s'", filename
);
3836 create_options
= append_option_parameters(create_options
,
3837 drv
->create_options
);
3838 create_options
= append_option_parameters(create_options
,
3839 proto_drv
->create_options
);
3841 /* Create parameter list with default values */
3842 param
= parse_option_parameters("", create_options
, param
);
3844 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, img_size
);
3846 /* Parse -o options */
3848 param
= parse_option_parameters(options
, create_options
, param
);
3849 if (param
== NULL
) {
3850 error_report("Invalid options for file format '%s'.", fmt
);
3856 if (base_filename
) {
3857 if (set_option_parameter(param
, BLOCK_OPT_BACKING_FILE
,
3859 error_report("Backing file not supported for file format '%s'",
3867 if (set_option_parameter(param
, BLOCK_OPT_BACKING_FMT
, base_fmt
)) {
3868 error_report("Backing file format not supported for file "
3869 "format '%s'", fmt
);
3875 backing_file
= get_option_parameter(param
, BLOCK_OPT_BACKING_FILE
);
3876 if (backing_file
&& backing_file
->value
.s
) {
3877 if (!strcmp(filename
, backing_file
->value
.s
)) {
3878 error_report("Error: Trying to create an image with the "
3879 "same filename as the backing file");
3885 backing_fmt
= get_option_parameter(param
, BLOCK_OPT_BACKING_FMT
);
3886 if (backing_fmt
&& backing_fmt
->value
.s
) {
3887 backing_drv
= bdrv_find_format(backing_fmt
->value
.s
);
3889 error_report("Unknown backing file format '%s'",
3890 backing_fmt
->value
.s
);
3896 // The size for the image must always be specified, with one exception:
3897 // If we are using a backing file, we can obtain the size from there
3898 size
= get_option_parameter(param
, BLOCK_OPT_SIZE
);
3899 if (size
&& size
->value
.n
== -1) {
3900 if (backing_file
&& backing_file
->value
.s
) {
3906 ret
= bdrv_open(bs
, backing_file
->value
.s
, flags
, backing_drv
);
3908 error_report("Could not open '%s'", backing_file
->value
.s
);
3911 bdrv_get_geometry(bs
, &size
);
3914 snprintf(buf
, sizeof(buf
), "%" PRId64
, size
);
3915 set_option_parameter(param
, BLOCK_OPT_SIZE
, buf
);
3917 error_report("Image creation needs a size parameter");
3923 printf("Formatting '%s', fmt=%s ", filename
, fmt
);
3924 print_option_parameters(param
);
3927 ret
= bdrv_create(drv
, filename
, param
);
3930 if (ret
== -ENOTSUP
) {
3931 error_report("Formatting or formatting option not supported for "
3932 "file format '%s'", fmt
);
3933 } else if (ret
== -EFBIG
) {
3934 error_report("The image size is too large for file format '%s'",
3937 error_report("%s: error while creating %s: %s", filename
, fmt
,
3943 free_option_parameters(create_options
);
3944 free_option_parameters(param
);
3953 void *block_job_create(const BlockJobType
*job_type
, BlockDriverState
*bs
,
3954 BlockDriverCompletionFunc
*cb
, void *opaque
)
3958 if (bs
->job
|| bdrv_in_use(bs
)) {
3961 bdrv_set_in_use(bs
, 1);
3963 job
= g_malloc0(job_type
->instance_size
);
3964 job
->job_type
= job_type
;
3967 job
->opaque
= opaque
;
3972 void block_job_complete(BlockJob
*job
, int ret
)
3974 BlockDriverState
*bs
= job
->bs
;
3976 assert(bs
->job
== job
);
3977 job
->cb(job
->opaque
, ret
);
3980 bdrv_set_in_use(bs
, 0);
3983 int block_job_set_speed(BlockJob
*job
, int64_t value
)
3985 if (!job
->job_type
->set_speed
) {
3988 return job
->job_type
->set_speed(job
, value
);
3991 void block_job_cancel(BlockJob
*job
)
3993 job
->cancelled
= true;
3996 bool block_job_is_cancelled(BlockJob
*job
)
3998 return job
->cancelled
;