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"
27 #include "block_int.h"
29 #include "qemu-objects.h"
32 #include <sys/types.h>
34 #include <sys/ioctl.h>
35 #include <sys/queue.h>
45 static BlockDriverAIOCB
*bdrv_aio_readv_em(BlockDriverState
*bs
,
46 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
47 BlockDriverCompletionFunc
*cb
, void *opaque
);
48 static BlockDriverAIOCB
*bdrv_aio_writev_em(BlockDriverState
*bs
,
49 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
50 BlockDriverCompletionFunc
*cb
, void *opaque
);
51 static BlockDriverAIOCB
*bdrv_aio_flush_em(BlockDriverState
*bs
,
52 BlockDriverCompletionFunc
*cb
, void *opaque
);
53 static int bdrv_read_em(BlockDriverState
*bs
, int64_t sector_num
,
54 uint8_t *buf
, int nb_sectors
);
55 static int bdrv_write_em(BlockDriverState
*bs
, int64_t sector_num
,
56 const uint8_t *buf
, int nb_sectors
);
57 static BlockDriver
*find_protocol(const char *filename
);
59 static QTAILQ_HEAD(, BlockDriverState
) bdrv_states
=
60 QTAILQ_HEAD_INITIALIZER(bdrv_states
);
62 static QLIST_HEAD(, BlockDriver
) bdrv_drivers
=
63 QLIST_HEAD_INITIALIZER(bdrv_drivers
);
65 /* If non-zero, use only whitelisted block drivers */
66 static int use_bdrv_whitelist
;
68 int path_is_absolute(const char *path
)
72 /* specific case for names like: "\\.\d:" */
73 if (*path
== '/' || *path
== '\\')
76 p
= strchr(path
, ':');
82 return (*p
== '/' || *p
== '\\');
88 /* if filename is absolute, just copy it to dest. Otherwise, build a
89 path to it by considering it is relative to base_path. URL are
91 void path_combine(char *dest
, int dest_size
,
92 const char *base_path
,
100 if (path_is_absolute(filename
)) {
101 pstrcpy(dest
, dest_size
, filename
);
103 p
= strchr(base_path
, ':');
108 p1
= strrchr(base_path
, '/');
112 p2
= strrchr(base_path
, '\\');
124 if (len
> dest_size
- 1)
126 memcpy(dest
, base_path
, len
);
128 pstrcat(dest
, dest_size
, filename
);
132 void bdrv_register(BlockDriver
*bdrv
)
134 if (!bdrv
->bdrv_aio_readv
) {
135 /* add AIO emulation layer */
136 bdrv
->bdrv_aio_readv
= bdrv_aio_readv_em
;
137 bdrv
->bdrv_aio_writev
= bdrv_aio_writev_em
;
138 } else if (!bdrv
->bdrv_read
) {
139 /* add synchronous IO emulation layer */
140 bdrv
->bdrv_read
= bdrv_read_em
;
141 bdrv
->bdrv_write
= bdrv_write_em
;
144 if (!bdrv
->bdrv_aio_flush
)
145 bdrv
->bdrv_aio_flush
= bdrv_aio_flush_em
;
147 QLIST_INSERT_HEAD(&bdrv_drivers
, bdrv
, list
);
150 /* create a new block device (by default it is empty) */
151 BlockDriverState
*bdrv_new(const char *device_name
)
153 BlockDriverState
*bs
;
155 bs
= qemu_mallocz(sizeof(BlockDriverState
));
156 pstrcpy(bs
->device_name
, sizeof(bs
->device_name
), device_name
);
157 if (device_name
[0] != '\0') {
158 QTAILQ_INSERT_TAIL(&bdrv_states
, bs
, list
);
163 BlockDriver
*bdrv_find_format(const char *format_name
)
166 QLIST_FOREACH(drv1
, &bdrv_drivers
, list
) {
167 if (!strcmp(drv1
->format_name
, format_name
)) {
174 static int bdrv_is_whitelisted(BlockDriver
*drv
)
176 static const char *whitelist
[] = {
177 CONFIG_BDRV_WHITELIST
182 return 1; /* no whitelist, anything goes */
184 for (p
= whitelist
; *p
; p
++) {
185 if (!strcmp(drv
->format_name
, *p
)) {
192 BlockDriver
*bdrv_find_whitelisted_format(const char *format_name
)
194 BlockDriver
*drv
= bdrv_find_format(format_name
);
195 return drv
&& bdrv_is_whitelisted(drv
) ? drv
: NULL
;
198 int bdrv_create(BlockDriver
*drv
, const char* filename
,
199 QEMUOptionParameter
*options
)
201 if (!drv
->bdrv_create
)
204 return drv
->bdrv_create(filename
, options
);
207 int bdrv_create_file(const char* filename
, QEMUOptionParameter
*options
)
211 drv
= find_protocol(filename
);
213 drv
= bdrv_find_format("file");
216 return bdrv_create(drv
, filename
, options
);
220 void get_tmp_filename(char *filename
, int size
)
222 char temp_dir
[MAX_PATH
];
224 GetTempPath(MAX_PATH
, temp_dir
);
225 GetTempFileName(temp_dir
, "qem", 0, filename
);
228 void get_tmp_filename(char *filename
, int size
)
232 /* XXX: race condition possible */
233 tmpdir
= getenv("TMPDIR");
236 snprintf(filename
, size
, "%s/vl.XXXXXX", tmpdir
);
237 fd
= mkstemp(filename
);
243 static int is_windows_drive_prefix(const char *filename
)
245 return (((filename
[0] >= 'a' && filename
[0] <= 'z') ||
246 (filename
[0] >= 'A' && filename
[0] <= 'Z')) &&
250 int is_windows_drive(const char *filename
)
252 if (is_windows_drive_prefix(filename
) &&
255 if (strstart(filename
, "\\\\.\\", NULL
) ||
256 strstart(filename
, "//./", NULL
))
263 * Detect host devices. By convention, /dev/cdrom[N] is always
264 * recognized as a host CDROM.
266 static BlockDriver
*find_hdev_driver(const char *filename
)
268 int score_max
= 0, score
;
269 BlockDriver
*drv
= NULL
, *d
;
271 QLIST_FOREACH(d
, &bdrv_drivers
, list
) {
272 if (d
->bdrv_probe_device
) {
273 score
= d
->bdrv_probe_device(filename
);
274 if (score
> score_max
) {
284 static BlockDriver
*find_protocol(const char *filename
)
292 /* TODO Drivers without bdrv_file_open must be specified explicitly */
295 is_drive
= is_windows_drive(filename
) ||
296 is_windows_drive_prefix(filename
);
300 p
= strchr(filename
, ':');
301 if (!p
|| is_drive
) {
302 drv1
= find_hdev_driver(filename
);
304 drv1
= bdrv_find_format("file");
309 if (len
> sizeof(protocol
) - 1)
310 len
= sizeof(protocol
) - 1;
311 memcpy(protocol
, filename
, len
);
312 protocol
[len
] = '\0';
313 QLIST_FOREACH(drv1
, &bdrv_drivers
, list
) {
314 if (drv1
->protocol_name
&&
315 !strcmp(drv1
->protocol_name
, protocol
)) {
322 static BlockDriver
*find_image_format(const char *filename
)
324 int ret
, score
, score_max
;
325 BlockDriver
*drv1
, *drv
;
327 BlockDriverState
*bs
;
329 ret
= bdrv_file_open(&bs
, filename
, 0);
332 ret
= bdrv_pread(bs
, 0, buf
, sizeof(buf
));
340 QLIST_FOREACH(drv1
, &bdrv_drivers
, list
) {
341 if (drv1
->bdrv_probe
) {
342 score
= drv1
->bdrv_probe(buf
, ret
, filename
);
343 if (score
> score_max
) {
353 * Set the current 'total_sectors' value
355 static int refresh_total_sectors(BlockDriverState
*bs
, int64_t hint
)
357 BlockDriver
*drv
= bs
->drv
;
359 /* query actual device if possible, otherwise just trust the hint */
360 if (drv
->bdrv_getlength
) {
361 int64_t length
= drv
->bdrv_getlength(bs
);
365 hint
= length
>> BDRV_SECTOR_BITS
;
368 bs
->total_sectors
= hint
;
373 * Common part for opening disk images and files
375 static int bdrv_open_common(BlockDriverState
*bs
, const char *filename
,
376 int flags
, BlockDriver
*drv
)
383 bs
->total_sectors
= 0;
384 bs
->is_temporary
= 0;
387 bs
->open_flags
= flags
;
388 /* buffer_alignment defaulted to 512, drivers can change this value */
389 bs
->buffer_alignment
= 512;
391 pstrcpy(bs
->filename
, sizeof(bs
->filename
), filename
);
393 if (use_bdrv_whitelist
&& !bdrv_is_whitelisted(drv
)) {
398 bs
->opaque
= qemu_mallocz(drv
->instance_size
);
401 * Yes, BDRV_O_NOCACHE aka O_DIRECT means we have to present a
402 * write cache to the guest. We do need the fdatasync to flush
403 * out transactions for block allocations, and we maybe have a
404 * volatile write cache in our backing device to deal with.
406 if (flags
& (BDRV_O_CACHE_WB
|BDRV_O_NOCACHE
))
407 bs
->enable_write_cache
= 1;
410 * Clear flags that are internal to the block layer before opening the
413 open_flags
= flags
& ~(BDRV_O_SNAPSHOT
| BDRV_O_NO_BACKING
);
416 * Snapshots should be writeable.
418 if (bs
->is_temporary
) {
419 open_flags
|= BDRV_O_RDWR
;
422 /* Open the image, either directly or using a protocol */
423 if (drv
->bdrv_file_open
) {
424 ret
= drv
->bdrv_file_open(bs
, filename
, open_flags
);
426 ret
= bdrv_file_open(&bs
->file
, filename
, open_flags
);
428 ret
= drv
->bdrv_open(bs
, open_flags
);
436 bs
->keep_read_only
= bs
->read_only
= !(open_flags
& BDRV_O_RDWR
);
438 ret
= refresh_total_sectors(bs
, bs
->total_sectors
);
444 if (bs
->is_temporary
) {
452 bdrv_delete(bs
->file
);
455 qemu_free(bs
->opaque
);
462 * Opens a file using a protocol (file, host_device, nbd, ...)
464 int bdrv_file_open(BlockDriverState
**pbs
, const char *filename
, int flags
)
466 BlockDriverState
*bs
;
470 drv
= find_protocol(filename
);
476 ret
= bdrv_open_common(bs
, filename
, flags
, drv
);
487 * Opens a disk image (raw, qcow2, vmdk, ...)
489 int bdrv_open(BlockDriverState
*bs
, const char *filename
, int flags
,
494 if (flags
& BDRV_O_SNAPSHOT
) {
495 BlockDriverState
*bs1
;
498 BlockDriver
*bdrv_qcow2
;
499 QEMUOptionParameter
*options
;
500 char tmp_filename
[PATH_MAX
];
501 char backing_filename
[PATH_MAX
];
503 /* if snapshot, we create a temporary backing file and open it
504 instead of opening 'filename' directly */
506 /* if there is a backing file, use it */
508 ret
= bdrv_open(bs1
, filename
, 0, drv
);
513 total_size
= bdrv_getlength(bs1
) >> BDRV_SECTOR_BITS
;
515 if (bs1
->drv
&& bs1
->drv
->protocol_name
)
520 get_tmp_filename(tmp_filename
, sizeof(tmp_filename
));
522 /* Real path is meaningless for protocols */
524 snprintf(backing_filename
, sizeof(backing_filename
),
526 else if (!realpath(filename
, backing_filename
))
529 bdrv_qcow2
= bdrv_find_format("qcow2");
530 options
= parse_option_parameters("", bdrv_qcow2
->create_options
, NULL
);
532 set_option_parameter_int(options
, BLOCK_OPT_SIZE
, total_size
* 512);
533 set_option_parameter(options
, BLOCK_OPT_BACKING_FILE
, backing_filename
);
535 set_option_parameter(options
, BLOCK_OPT_BACKING_FMT
,
539 ret
= bdrv_create(bdrv_qcow2
, tmp_filename
, options
);
540 free_option_parameters(options
);
545 filename
= tmp_filename
;
547 bs
->is_temporary
= 1;
550 /* Find the right image format driver */
552 drv
= find_image_format(filename
);
557 goto unlink_and_fail
;
561 ret
= bdrv_open_common(bs
, filename
, flags
, drv
);
563 goto unlink_and_fail
;
566 /* If there is a backing file, use it */
567 if ((flags
& BDRV_O_NO_BACKING
) == 0 && bs
->backing_file
[0] != '\0') {
568 char backing_filename
[PATH_MAX
];
570 BlockDriver
*back_drv
= NULL
;
572 bs
->backing_hd
= bdrv_new("");
573 path_combine(backing_filename
, sizeof(backing_filename
),
574 filename
, bs
->backing_file
);
575 if (bs
->backing_format
[0] != '\0')
576 back_drv
= bdrv_find_format(bs
->backing_format
);
578 /* backing files always opened read-only */
580 flags
& ~(BDRV_O_RDWR
| BDRV_O_SNAPSHOT
| BDRV_O_NO_BACKING
);
582 ret
= bdrv_open(bs
->backing_hd
, backing_filename
, back_flags
, back_drv
);
587 if (bs
->is_temporary
) {
588 bs
->backing_hd
->keep_read_only
= !(flags
& BDRV_O_RDWR
);
590 /* base image inherits from "parent" */
591 bs
->backing_hd
->keep_read_only
= bs
->keep_read_only
;
595 if (!bdrv_key_required(bs
)) {
596 /* call the change callback */
597 bs
->media_changed
= 1;
599 bs
->change_cb(bs
->change_opaque
);
605 if (bs
->is_temporary
) {
611 void bdrv_close(BlockDriverState
*bs
)
614 if (bs
->backing_hd
) {
615 bdrv_delete(bs
->backing_hd
);
616 bs
->backing_hd
= NULL
;
618 bs
->drv
->bdrv_close(bs
);
619 qemu_free(bs
->opaque
);
621 if (bs
->is_temporary
) {
622 unlink(bs
->filename
);
628 if (bs
->file
!= NULL
) {
629 bdrv_close(bs
->file
);
632 /* call the change callback */
633 bs
->media_changed
= 1;
635 bs
->change_cb(bs
->change_opaque
);
639 void bdrv_delete(BlockDriverState
*bs
)
641 /* remove from list, if necessary */
642 if (bs
->device_name
[0] != '\0') {
643 QTAILQ_REMOVE(&bdrv_states
, bs
, list
);
647 if (bs
->file
!= NULL
) {
648 bdrv_delete(bs
->file
);
655 * Run consistency checks on an image
657 * Returns the number of errors or -errno when an internal error occurs
659 int bdrv_check(BlockDriverState
*bs
)
661 if (bs
->drv
->bdrv_check
== NULL
) {
665 return bs
->drv
->bdrv_check(bs
);
668 /* commit COW file into the raw image */
669 int bdrv_commit(BlockDriverState
*bs
)
671 BlockDriver
*drv
= bs
->drv
;
672 int64_t i
, total_sectors
;
673 int n
, j
, ro
, open_flags
;
674 int ret
= 0, rw_ret
= 0;
675 unsigned char sector
[512];
677 BlockDriverState
*bs_rw
, *bs_ro
;
682 if (!bs
->backing_hd
) {
686 if (bs
->backing_hd
->keep_read_only
) {
690 ro
= bs
->backing_hd
->read_only
;
691 strncpy(filename
, bs
->backing_hd
->filename
, sizeof(filename
));
692 open_flags
= bs
->backing_hd
->open_flags
;
696 bdrv_delete(bs
->backing_hd
);
697 bs
->backing_hd
= NULL
;
698 bs_rw
= bdrv_new("");
699 rw_ret
= bdrv_open(bs_rw
, filename
, open_flags
| BDRV_O_RDWR
, drv
);
702 /* try to re-open read-only */
703 bs_ro
= bdrv_new("");
704 ret
= bdrv_open(bs_ro
, filename
, open_flags
& ~BDRV_O_RDWR
, drv
);
707 /* drive not functional anymore */
711 bs
->backing_hd
= bs_ro
;
714 bs
->backing_hd
= bs_rw
;
717 total_sectors
= bdrv_getlength(bs
) >> BDRV_SECTOR_BITS
;
718 for (i
= 0; i
< total_sectors
;) {
719 if (drv
->bdrv_is_allocated(bs
, i
, 65536, &n
)) {
720 for(j
= 0; j
< n
; j
++) {
721 if (bdrv_read(bs
, i
, sector
, 1) != 0) {
726 if (bdrv_write(bs
->backing_hd
, i
, sector
, 1) != 0) {
737 if (drv
->bdrv_make_empty
) {
738 ret
= drv
->bdrv_make_empty(bs
);
743 * Make sure all data we wrote to the backing device is actually
747 bdrv_flush(bs
->backing_hd
);
753 bdrv_delete(bs
->backing_hd
);
754 bs
->backing_hd
= NULL
;
755 bs_ro
= bdrv_new("");
756 ret
= bdrv_open(bs_ro
, filename
, open_flags
& ~BDRV_O_RDWR
, drv
);
759 /* drive not functional anymore */
763 bs
->backing_hd
= bs_ro
;
764 bs
->backing_hd
->keep_read_only
= 0;
773 * -EINVAL - backing format specified, but no file
774 * -ENOSPC - can't update the backing file because no space is left in the
776 * -ENOTSUP - format driver doesn't support changing the backing file
778 int bdrv_change_backing_file(BlockDriverState
*bs
,
779 const char *backing_file
, const char *backing_fmt
)
781 BlockDriver
*drv
= bs
->drv
;
783 if (drv
->bdrv_change_backing_file
!= NULL
) {
784 return drv
->bdrv_change_backing_file(bs
, backing_file
, backing_fmt
);
790 static int bdrv_check_byte_request(BlockDriverState
*bs
, int64_t offset
,
795 if (!bdrv_is_inserted(bs
))
801 len
= bdrv_getlength(bs
);
806 if ((offset
> len
) || (len
- offset
< size
))
812 static int bdrv_check_request(BlockDriverState
*bs
, int64_t sector_num
,
815 return bdrv_check_byte_request(bs
, sector_num
* 512, nb_sectors
* 512);
818 /* return < 0 if error. See bdrv_write() for the return codes */
819 int bdrv_read(BlockDriverState
*bs
, int64_t sector_num
,
820 uint8_t *buf
, int nb_sectors
)
822 BlockDriver
*drv
= bs
->drv
;
826 if (bdrv_check_request(bs
, sector_num
, nb_sectors
))
829 return drv
->bdrv_read(bs
, sector_num
, buf
, nb_sectors
);
832 static void set_dirty_bitmap(BlockDriverState
*bs
, int64_t sector_num
,
833 int nb_sectors
, int dirty
)
836 unsigned long val
, idx
, bit
;
838 start
= sector_num
/ BDRV_SECTORS_PER_DIRTY_CHUNK
;
839 end
= (sector_num
+ nb_sectors
- 1) / BDRV_SECTORS_PER_DIRTY_CHUNK
;
841 for (; start
<= end
; start
++) {
842 idx
= start
/ (sizeof(unsigned long) * 8);
843 bit
= start
% (sizeof(unsigned long) * 8);
844 val
= bs
->dirty_bitmap
[idx
];
846 if (!(val
& (1 << bit
))) {
851 if (val
& (1 << bit
)) {
856 bs
->dirty_bitmap
[idx
] = val
;
860 /* Return < 0 if error. Important errors are:
861 -EIO generic I/O error (may happen for all errors)
862 -ENOMEDIUM No media inserted.
863 -EINVAL Invalid sector number or nb_sectors
864 -EACCES Trying to write a read-only device
866 int bdrv_write(BlockDriverState
*bs
, int64_t sector_num
,
867 const uint8_t *buf
, int nb_sectors
)
869 BlockDriver
*drv
= bs
->drv
;
874 if (bdrv_check_request(bs
, sector_num
, nb_sectors
))
877 if (bs
->dirty_bitmap
) {
878 set_dirty_bitmap(bs
, sector_num
, nb_sectors
, 1);
881 if (bs
->wr_highest_sector
< sector_num
+ nb_sectors
- 1) {
882 bs
->wr_highest_sector
= sector_num
+ nb_sectors
- 1;
885 return drv
->bdrv_write(bs
, sector_num
, buf
, nb_sectors
);
888 int bdrv_pread(BlockDriverState
*bs
, int64_t offset
,
889 void *buf
, int count1
)
891 uint8_t tmp_buf
[BDRV_SECTOR_SIZE
];
892 int len
, nb_sectors
, count
;
897 /* first read to align to sector start */
898 len
= (BDRV_SECTOR_SIZE
- offset
) & (BDRV_SECTOR_SIZE
- 1);
901 sector_num
= offset
>> BDRV_SECTOR_BITS
;
903 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
905 memcpy(buf
, tmp_buf
+ (offset
& (BDRV_SECTOR_SIZE
- 1)), len
);
913 /* read the sectors "in place" */
914 nb_sectors
= count
>> BDRV_SECTOR_BITS
;
915 if (nb_sectors
> 0) {
916 if ((ret
= bdrv_read(bs
, sector_num
, buf
, nb_sectors
)) < 0)
918 sector_num
+= nb_sectors
;
919 len
= nb_sectors
<< BDRV_SECTOR_BITS
;
924 /* add data from the last sector */
926 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
928 memcpy(buf
, tmp_buf
, count
);
933 int bdrv_pwrite(BlockDriverState
*bs
, int64_t offset
,
934 const void *buf
, int count1
)
936 uint8_t tmp_buf
[BDRV_SECTOR_SIZE
];
937 int len
, nb_sectors
, count
;
942 /* first write to align to sector start */
943 len
= (BDRV_SECTOR_SIZE
- offset
) & (BDRV_SECTOR_SIZE
- 1);
946 sector_num
= offset
>> BDRV_SECTOR_BITS
;
948 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
950 memcpy(tmp_buf
+ (offset
& (BDRV_SECTOR_SIZE
- 1)), buf
, len
);
951 if ((ret
= bdrv_write(bs
, sector_num
, tmp_buf
, 1)) < 0)
960 /* write the sectors "in place" */
961 nb_sectors
= count
>> BDRV_SECTOR_BITS
;
962 if (nb_sectors
> 0) {
963 if ((ret
= bdrv_write(bs
, sector_num
, buf
, nb_sectors
)) < 0)
965 sector_num
+= nb_sectors
;
966 len
= nb_sectors
<< BDRV_SECTOR_BITS
;
971 /* add data from the last sector */
973 if ((ret
= bdrv_read(bs
, sector_num
, tmp_buf
, 1)) < 0)
975 memcpy(tmp_buf
, buf
, count
);
976 if ((ret
= bdrv_write(bs
, sector_num
, tmp_buf
, 1)) < 0)
983 * Truncate file to 'offset' bytes (needed only for file protocols)
985 int bdrv_truncate(BlockDriverState
*bs
, int64_t offset
)
987 BlockDriver
*drv
= bs
->drv
;
991 if (!drv
->bdrv_truncate
)
995 ret
= drv
->bdrv_truncate(bs
, offset
);
997 ret
= refresh_total_sectors(bs
, offset
>> BDRV_SECTOR_BITS
);
1003 * Length of a file in bytes. Return < 0 if error or unknown.
1005 int64_t bdrv_getlength(BlockDriverState
*bs
)
1007 BlockDriver
*drv
= bs
->drv
;
1011 /* Fixed size devices use the total_sectors value for speed instead of
1012 issuing a length query (like lseek) on each call. Also, legacy block
1013 drivers don't provide a bdrv_getlength function and must use
1015 if (!bs
->growable
|| !drv
->bdrv_getlength
) {
1016 return bs
->total_sectors
* BDRV_SECTOR_SIZE
;
1018 return drv
->bdrv_getlength(bs
);
1021 /* return 0 as number of sectors if no device present or error */
1022 void bdrv_get_geometry(BlockDriverState
*bs
, uint64_t *nb_sectors_ptr
)
1025 length
= bdrv_getlength(bs
);
1029 length
= length
>> BDRV_SECTOR_BITS
;
1030 *nb_sectors_ptr
= length
;
1034 uint8_t boot_ind
; /* 0x80 - active */
1035 uint8_t head
; /* starting head */
1036 uint8_t sector
; /* starting sector */
1037 uint8_t cyl
; /* starting cylinder */
1038 uint8_t sys_ind
; /* What partition type */
1039 uint8_t end_head
; /* end head */
1040 uint8_t end_sector
; /* end sector */
1041 uint8_t end_cyl
; /* end cylinder */
1042 uint32_t start_sect
; /* starting sector counting from 0 */
1043 uint32_t nr_sects
; /* nr of sectors in partition */
1044 } __attribute__((packed
));
1046 /* try to guess the disk logical geometry from the MSDOS partition table. Return 0 if OK, -1 if could not guess */
1047 static int guess_disk_lchs(BlockDriverState
*bs
,
1048 int *pcylinders
, int *pheads
, int *psectors
)
1051 int ret
, i
, heads
, sectors
, cylinders
;
1052 struct partition
*p
;
1054 uint64_t nb_sectors
;
1056 bdrv_get_geometry(bs
, &nb_sectors
);
1058 ret
= bdrv_read(bs
, 0, buf
, 1);
1061 /* test msdos magic */
1062 if (buf
[510] != 0x55 || buf
[511] != 0xaa)
1064 for(i
= 0; i
< 4; i
++) {
1065 p
= ((struct partition
*)(buf
+ 0x1be)) + i
;
1066 nr_sects
= le32_to_cpu(p
->nr_sects
);
1067 if (nr_sects
&& p
->end_head
) {
1068 /* We make the assumption that the partition terminates on
1069 a cylinder boundary */
1070 heads
= p
->end_head
+ 1;
1071 sectors
= p
->end_sector
& 63;
1074 cylinders
= nb_sectors
/ (heads
* sectors
);
1075 if (cylinders
< 1 || cylinders
> 16383)
1078 *psectors
= sectors
;
1079 *pcylinders
= cylinders
;
1081 printf("guessed geometry: LCHS=%d %d %d\n",
1082 cylinders
, heads
, sectors
);
1090 void bdrv_guess_geometry(BlockDriverState
*bs
, int *pcyls
, int *pheads
, int *psecs
)
1092 int translation
, lba_detected
= 0;
1093 int cylinders
, heads
, secs
;
1094 uint64_t nb_sectors
;
1096 /* if a geometry hint is available, use it */
1097 bdrv_get_geometry(bs
, &nb_sectors
);
1098 bdrv_get_geometry_hint(bs
, &cylinders
, &heads
, &secs
);
1099 translation
= bdrv_get_translation_hint(bs
);
1100 if (cylinders
!= 0) {
1105 if (guess_disk_lchs(bs
, &cylinders
, &heads
, &secs
) == 0) {
1107 /* if heads > 16, it means that a BIOS LBA
1108 translation was active, so the default
1109 hardware geometry is OK */
1111 goto default_geometry
;
1116 /* disable any translation to be in sync with
1117 the logical geometry */
1118 if (translation
== BIOS_ATA_TRANSLATION_AUTO
) {
1119 bdrv_set_translation_hint(bs
,
1120 BIOS_ATA_TRANSLATION_NONE
);
1125 /* if no geometry, use a standard physical disk geometry */
1126 cylinders
= nb_sectors
/ (16 * 63);
1128 if (cylinders
> 16383)
1130 else if (cylinders
< 2)
1135 if ((lba_detected
== 1) && (translation
== BIOS_ATA_TRANSLATION_AUTO
)) {
1136 if ((*pcyls
* *pheads
) <= 131072) {
1137 bdrv_set_translation_hint(bs
,
1138 BIOS_ATA_TRANSLATION_LARGE
);
1140 bdrv_set_translation_hint(bs
,
1141 BIOS_ATA_TRANSLATION_LBA
);
1145 bdrv_set_geometry_hint(bs
, *pcyls
, *pheads
, *psecs
);
1149 void bdrv_set_geometry_hint(BlockDriverState
*bs
,
1150 int cyls
, int heads
, int secs
)
1157 void bdrv_set_type_hint(BlockDriverState
*bs
, int type
)
1160 bs
->removable
= ((type
== BDRV_TYPE_CDROM
||
1161 type
== BDRV_TYPE_FLOPPY
));
1164 void bdrv_set_translation_hint(BlockDriverState
*bs
, int translation
)
1166 bs
->translation
= translation
;
1169 void bdrv_get_geometry_hint(BlockDriverState
*bs
,
1170 int *pcyls
, int *pheads
, int *psecs
)
1173 *pheads
= bs
->heads
;
1177 int bdrv_get_type_hint(BlockDriverState
*bs
)
1182 int bdrv_get_translation_hint(BlockDriverState
*bs
)
1184 return bs
->translation
;
1187 int bdrv_is_removable(BlockDriverState
*bs
)
1189 return bs
->removable
;
1192 int bdrv_is_read_only(BlockDriverState
*bs
)
1194 return bs
->read_only
;
1197 int bdrv_is_sg(BlockDriverState
*bs
)
1202 int bdrv_enable_write_cache(BlockDriverState
*bs
)
1204 return bs
->enable_write_cache
;
1207 /* XXX: no longer used */
1208 void bdrv_set_change_cb(BlockDriverState
*bs
,
1209 void (*change_cb
)(void *opaque
), void *opaque
)
1211 bs
->change_cb
= change_cb
;
1212 bs
->change_opaque
= opaque
;
1215 int bdrv_is_encrypted(BlockDriverState
*bs
)
1217 if (bs
->backing_hd
&& bs
->backing_hd
->encrypted
)
1219 return bs
->encrypted
;
1222 int bdrv_key_required(BlockDriverState
*bs
)
1224 BlockDriverState
*backing_hd
= bs
->backing_hd
;
1226 if (backing_hd
&& backing_hd
->encrypted
&& !backing_hd
->valid_key
)
1228 return (bs
->encrypted
&& !bs
->valid_key
);
1231 int bdrv_set_key(BlockDriverState
*bs
, const char *key
)
1234 if (bs
->backing_hd
&& bs
->backing_hd
->encrypted
) {
1235 ret
= bdrv_set_key(bs
->backing_hd
, key
);
1241 if (!bs
->encrypted
) {
1243 } else if (!bs
->drv
|| !bs
->drv
->bdrv_set_key
) {
1246 ret
= bs
->drv
->bdrv_set_key(bs
, key
);
1249 } else if (!bs
->valid_key
) {
1251 /* call the change callback now, we skipped it on open */
1252 bs
->media_changed
= 1;
1254 bs
->change_cb(bs
->change_opaque
);
1259 void bdrv_get_format(BlockDriverState
*bs
, char *buf
, int buf_size
)
1264 pstrcpy(buf
, buf_size
, bs
->drv
->format_name
);
1268 void bdrv_iterate_format(void (*it
)(void *opaque
, const char *name
),
1273 QLIST_FOREACH(drv
, &bdrv_drivers
, list
) {
1274 it(opaque
, drv
->format_name
);
1278 BlockDriverState
*bdrv_find(const char *name
)
1280 BlockDriverState
*bs
;
1282 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1283 if (!strcmp(name
, bs
->device_name
)) {
1290 void bdrv_iterate(void (*it
)(void *opaque
, BlockDriverState
*bs
), void *opaque
)
1292 BlockDriverState
*bs
;
1294 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1299 const char *bdrv_get_device_name(BlockDriverState
*bs
)
1301 return bs
->device_name
;
1304 void bdrv_flush(BlockDriverState
*bs
)
1306 if (bs
->drv
&& bs
->drv
->bdrv_flush
)
1307 bs
->drv
->bdrv_flush(bs
);
1310 void bdrv_flush_all(void)
1312 BlockDriverState
*bs
;
1314 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1315 if (bs
->drv
&& !bdrv_is_read_only(bs
) &&
1316 (!bdrv_is_removable(bs
) || bdrv_is_inserted(bs
))) {
1322 int bdrv_has_zero_init(BlockDriverState
*bs
)
1326 if (bs
->drv
->no_zero_init
) {
1328 } else if (bs
->file
) {
1329 return bdrv_has_zero_init(bs
->file
);
1336 * Returns true iff the specified sector is present in the disk image. Drivers
1337 * not implementing the functionality are assumed to not support backing files,
1338 * hence all their sectors are reported as allocated.
1340 * 'pnum' is set to the number of sectors (including and immediately following
1341 * the specified sector) that are known to be in the same
1342 * allocated/unallocated state.
1344 * 'nb_sectors' is the max value 'pnum' should be set to.
1346 int bdrv_is_allocated(BlockDriverState
*bs
, int64_t sector_num
, int nb_sectors
,
1350 if (!bs
->drv
->bdrv_is_allocated
) {
1351 if (sector_num
>= bs
->total_sectors
) {
1355 n
= bs
->total_sectors
- sector_num
;
1356 *pnum
= (n
< nb_sectors
) ? (n
) : (nb_sectors
);
1359 return bs
->drv
->bdrv_is_allocated(bs
, sector_num
, nb_sectors
, pnum
);
1362 void bdrv_mon_event(const BlockDriverState
*bdrv
,
1363 BlockMonEventAction action
, int is_read
)
1366 const char *action_str
;
1369 case BDRV_ACTION_REPORT
:
1370 action_str
= "report";
1372 case BDRV_ACTION_IGNORE
:
1373 action_str
= "ignore";
1375 case BDRV_ACTION_STOP
:
1376 action_str
= "stop";
1382 data
= qobject_from_jsonf("{ 'device': %s, 'action': %s, 'operation': %s }",
1385 is_read
? "read" : "write");
1386 monitor_protocol_event(QEVENT_BLOCK_IO_ERROR
, data
);
1388 qobject_decref(data
);
1391 static void bdrv_print_dict(QObject
*obj
, void *opaque
)
1394 Monitor
*mon
= opaque
;
1396 bs_dict
= qobject_to_qdict(obj
);
1398 monitor_printf(mon
, "%s: type=%s removable=%d",
1399 qdict_get_str(bs_dict
, "device"),
1400 qdict_get_str(bs_dict
, "type"),
1401 qdict_get_bool(bs_dict
, "removable"));
1403 if (qdict_get_bool(bs_dict
, "removable")) {
1404 monitor_printf(mon
, " locked=%d", qdict_get_bool(bs_dict
, "locked"));
1407 if (qdict_haskey(bs_dict
, "inserted")) {
1408 QDict
*qdict
= qobject_to_qdict(qdict_get(bs_dict
, "inserted"));
1410 monitor_printf(mon
, " file=");
1411 monitor_print_filename(mon
, qdict_get_str(qdict
, "file"));
1412 if (qdict_haskey(qdict
, "backing_file")) {
1413 monitor_printf(mon
, " backing_file=");
1414 monitor_print_filename(mon
, qdict_get_str(qdict
, "backing_file"));
1416 monitor_printf(mon
, " ro=%d drv=%s encrypted=%d",
1417 qdict_get_bool(qdict
, "ro"),
1418 qdict_get_str(qdict
, "drv"),
1419 qdict_get_bool(qdict
, "encrypted"));
1421 monitor_printf(mon
, " [not inserted]");
1424 monitor_printf(mon
, "\n");
1427 void bdrv_info_print(Monitor
*mon
, const QObject
*data
)
1429 qlist_iter(qobject_to_qlist(data
), bdrv_print_dict
, mon
);
1433 * bdrv_info(): Block devices information
1435 * Each block device information is stored in a QDict and the
1436 * returned QObject is a QList of all devices.
1438 * The QDict contains the following:
1440 * - "device": device name
1441 * - "type": device type
1442 * - "removable": true if the device is removable, false otherwise
1443 * - "locked": true if the device is locked, false otherwise
1444 * - "inserted": only present if the device is inserted, it is a QDict
1445 * containing the following:
1446 * - "file": device file name
1447 * - "ro": true if read-only, false otherwise
1448 * - "drv": driver format name
1449 * - "backing_file": backing file name if one is used
1450 * - "encrypted": true if encrypted, false otherwise
1454 * [ { "device": "ide0-hd0", "type": "hd", "removable": false, "locked": false,
1455 * "inserted": { "file": "/tmp/foobar", "ro": false, "drv": "qcow2" } },
1456 * { "device": "floppy0", "type": "floppy", "removable": true,
1457 * "locked": false } ]
1459 void bdrv_info(Monitor
*mon
, QObject
**ret_data
)
1462 BlockDriverState
*bs
;
1464 bs_list
= qlist_new();
1466 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1468 const char *type
= "unknown";
1474 case BDRV_TYPE_CDROM
:
1477 case BDRV_TYPE_FLOPPY
:
1482 bs_obj
= qobject_from_jsonf("{ 'device': %s, 'type': %s, "
1483 "'removable': %i, 'locked': %i }",
1484 bs
->device_name
, type
, bs
->removable
,
1489 QDict
*bs_dict
= qobject_to_qdict(bs_obj
);
1491 obj
= qobject_from_jsonf("{ 'file': %s, 'ro': %i, 'drv': %s, "
1492 "'encrypted': %i }",
1493 bs
->filename
, bs
->read_only
,
1494 bs
->drv
->format_name
,
1495 bdrv_is_encrypted(bs
));
1496 if (bs
->backing_file
[0] != '\0') {
1497 QDict
*qdict
= qobject_to_qdict(obj
);
1498 qdict_put(qdict
, "backing_file",
1499 qstring_from_str(bs
->backing_file
));
1502 qdict_put_obj(bs_dict
, "inserted", obj
);
1504 qlist_append_obj(bs_list
, bs_obj
);
1507 *ret_data
= QOBJECT(bs_list
);
1510 static void bdrv_stats_iter(QObject
*data
, void *opaque
)
1513 Monitor
*mon
= opaque
;
1515 qdict
= qobject_to_qdict(data
);
1516 monitor_printf(mon
, "%s:", qdict_get_str(qdict
, "device"));
1518 qdict
= qobject_to_qdict(qdict_get(qdict
, "stats"));
1519 monitor_printf(mon
, " rd_bytes=%" PRId64
1520 " wr_bytes=%" PRId64
1521 " rd_operations=%" PRId64
1522 " wr_operations=%" PRId64
1524 qdict_get_int(qdict
, "rd_bytes"),
1525 qdict_get_int(qdict
, "wr_bytes"),
1526 qdict_get_int(qdict
, "rd_operations"),
1527 qdict_get_int(qdict
, "wr_operations"));
1530 void bdrv_stats_print(Monitor
*mon
, const QObject
*data
)
1532 qlist_iter(qobject_to_qlist(data
), bdrv_stats_iter
, mon
);
1535 static QObject
* bdrv_info_stats_bs(BlockDriverState
*bs
)
1540 res
= qobject_from_jsonf("{ 'stats': {"
1541 "'rd_bytes': %" PRId64
","
1542 "'wr_bytes': %" PRId64
","
1543 "'rd_operations': %" PRId64
","
1544 "'wr_operations': %" PRId64
","
1545 "'wr_highest_offset': %" PRId64
1547 bs
->rd_bytes
, bs
->wr_bytes
,
1548 bs
->rd_ops
, bs
->wr_ops
,
1549 bs
->wr_highest_sector
* 512);
1550 dict
= qobject_to_qdict(res
);
1552 if (*bs
->device_name
) {
1553 qdict_put(dict
, "device", qstring_from_str(bs
->device_name
));
1557 QObject
*parent
= bdrv_info_stats_bs(bs
->file
);
1558 qdict_put_obj(dict
, "parent", parent
);
1565 * bdrv_info_stats(): show block device statistics
1567 * Each device statistic information is stored in a QDict and
1568 * the returned QObject is a QList of all devices.
1570 * The QDict contains the following:
1572 * - "device": device name
1573 * - "stats": A QDict with the statistics information, it contains:
1574 * - "rd_bytes": bytes read
1575 * - "wr_bytes": bytes written
1576 * - "rd_operations": read operations
1577 * - "wr_operations": write operations
1578 * - "wr_highest_offset": Highest offset of a sector written since the
1579 * BlockDriverState has been opened
1580 * - "parent": A QDict recursively holding the statistics of the underlying
1581 * protocol (e.g. the host file for a qcow2 image). If there is no
1582 * underlying protocol, this field is omitted.
1586 * [ { "device": "ide0-hd0",
1587 * "stats": { "rd_bytes": 512,
1589 * "rd_operations": 1,
1590 * "wr_operations": 0,
1591 * "wr_highest_offset": 0 },
1593 * "stats": { "rd_bytes": 1024,
1595 * "rd_operations": 2,
1596 * "wr_operations": 0,
1597 * "wr_highest_offset": 0,
1599 * { "device": "ide1-cd0",
1600 * "stats": { "rd_bytes": 0,
1602 * "rd_operations": 0,
1603 * "wr_operations": 0,
1604 * "wr_highest_offset": 0 } },
1606 void bdrv_info_stats(Monitor
*mon
, QObject
**ret_data
)
1610 BlockDriverState
*bs
;
1612 devices
= qlist_new();
1614 QTAILQ_FOREACH(bs
, &bdrv_states
, list
) {
1615 obj
= bdrv_info_stats_bs(bs
);
1616 qlist_append_obj(devices
, obj
);
1619 *ret_data
= QOBJECT(devices
);
1622 const char *bdrv_get_encrypted_filename(BlockDriverState
*bs
)
1624 if (bs
->backing_hd
&& bs
->backing_hd
->encrypted
)
1625 return bs
->backing_file
;
1626 else if (bs
->encrypted
)
1627 return bs
->filename
;
1632 void bdrv_get_backing_filename(BlockDriverState
*bs
,
1633 char *filename
, int filename_size
)
1635 if (!bs
->backing_file
) {
1636 pstrcpy(filename
, filename_size
, "");
1638 pstrcpy(filename
, filename_size
, bs
->backing_file
);
1642 int bdrv_write_compressed(BlockDriverState
*bs
, int64_t sector_num
,
1643 const uint8_t *buf
, int nb_sectors
)
1645 BlockDriver
*drv
= bs
->drv
;
1648 if (!drv
->bdrv_write_compressed
)
1650 if (bdrv_check_request(bs
, sector_num
, nb_sectors
))
1653 if (bs
->dirty_bitmap
) {
1654 set_dirty_bitmap(bs
, sector_num
, nb_sectors
, 1);
1657 return drv
->bdrv_write_compressed(bs
, sector_num
, buf
, nb_sectors
);
1660 int bdrv_get_info(BlockDriverState
*bs
, BlockDriverInfo
*bdi
)
1662 BlockDriver
*drv
= bs
->drv
;
1665 if (!drv
->bdrv_get_info
)
1667 memset(bdi
, 0, sizeof(*bdi
));
1668 return drv
->bdrv_get_info(bs
, bdi
);
1671 int bdrv_save_vmstate(BlockDriverState
*bs
, const uint8_t *buf
,
1672 int64_t pos
, int size
)
1674 BlockDriver
*drv
= bs
->drv
;
1677 if (!drv
->bdrv_save_vmstate
)
1679 return drv
->bdrv_save_vmstate(bs
, buf
, pos
, size
);
1682 int bdrv_load_vmstate(BlockDriverState
*bs
, uint8_t *buf
,
1683 int64_t pos
, int size
)
1685 BlockDriver
*drv
= bs
->drv
;
1688 if (!drv
->bdrv_load_vmstate
)
1690 return drv
->bdrv_load_vmstate(bs
, buf
, pos
, size
);
1693 void bdrv_debug_event(BlockDriverState
*bs
, BlkDebugEvent event
)
1695 BlockDriver
*drv
= bs
->drv
;
1697 if (!drv
|| !drv
->bdrv_debug_event
) {
1701 return drv
->bdrv_debug_event(bs
, event
);
1705 /**************************************************************/
1706 /* handling of snapshots */
1708 int bdrv_snapshot_create(BlockDriverState
*bs
,
1709 QEMUSnapshotInfo
*sn_info
)
1711 BlockDriver
*drv
= bs
->drv
;
1714 if (!drv
->bdrv_snapshot_create
)
1716 return drv
->bdrv_snapshot_create(bs
, sn_info
);
1719 int bdrv_snapshot_goto(BlockDriverState
*bs
,
1720 const char *snapshot_id
)
1722 BlockDriver
*drv
= bs
->drv
;
1725 if (!drv
->bdrv_snapshot_goto
)
1727 return drv
->bdrv_snapshot_goto(bs
, snapshot_id
);
1730 int bdrv_snapshot_delete(BlockDriverState
*bs
, const char *snapshot_id
)
1732 BlockDriver
*drv
= bs
->drv
;
1735 if (!drv
->bdrv_snapshot_delete
)
1737 return drv
->bdrv_snapshot_delete(bs
, snapshot_id
);
1740 int bdrv_snapshot_list(BlockDriverState
*bs
,
1741 QEMUSnapshotInfo
**psn_info
)
1743 BlockDriver
*drv
= bs
->drv
;
1746 if (!drv
->bdrv_snapshot_list
)
1748 return drv
->bdrv_snapshot_list(bs
, psn_info
);
1751 #define NB_SUFFIXES 4
1753 char *get_human_readable_size(char *buf
, int buf_size
, int64_t size
)
1755 static const char suffixes
[NB_SUFFIXES
] = "KMGT";
1760 snprintf(buf
, buf_size
, "%" PRId64
, size
);
1763 for(i
= 0; i
< NB_SUFFIXES
; i
++) {
1764 if (size
< (10 * base
)) {
1765 snprintf(buf
, buf_size
, "%0.1f%c",
1766 (double)size
/ base
,
1769 } else if (size
< (1000 * base
) || i
== (NB_SUFFIXES
- 1)) {
1770 snprintf(buf
, buf_size
, "%" PRId64
"%c",
1771 ((size
+ (base
>> 1)) / base
),
1781 char *bdrv_snapshot_dump(char *buf
, int buf_size
, QEMUSnapshotInfo
*sn
)
1783 char buf1
[128], date_buf
[128], clock_buf
[128];
1793 snprintf(buf
, buf_size
,
1794 "%-10s%-20s%7s%20s%15s",
1795 "ID", "TAG", "VM SIZE", "DATE", "VM CLOCK");
1799 ptm
= localtime(&ti
);
1800 strftime(date_buf
, sizeof(date_buf
),
1801 "%Y-%m-%d %H:%M:%S", ptm
);
1803 localtime_r(&ti
, &tm
);
1804 strftime(date_buf
, sizeof(date_buf
),
1805 "%Y-%m-%d %H:%M:%S", &tm
);
1807 secs
= sn
->vm_clock_nsec
/ 1000000000;
1808 snprintf(clock_buf
, sizeof(clock_buf
),
1809 "%02d:%02d:%02d.%03d",
1811 (int)((secs
/ 60) % 60),
1813 (int)((sn
->vm_clock_nsec
/ 1000000) % 1000));
1814 snprintf(buf
, buf_size
,
1815 "%-10s%-20s%7s%20s%15s",
1816 sn
->id_str
, sn
->name
,
1817 get_human_readable_size(buf1
, sizeof(buf1
), sn
->vm_state_size
),
1825 /**************************************************************/
1828 BlockDriverAIOCB
*bdrv_aio_readv(BlockDriverState
*bs
, int64_t sector_num
,
1829 QEMUIOVector
*qiov
, int nb_sectors
,
1830 BlockDriverCompletionFunc
*cb
, void *opaque
)
1832 BlockDriver
*drv
= bs
->drv
;
1833 BlockDriverAIOCB
*ret
;
1837 if (bdrv_check_request(bs
, sector_num
, nb_sectors
))
1840 ret
= drv
->bdrv_aio_readv(bs
, sector_num
, qiov
, nb_sectors
,
1844 /* Update stats even though technically transfer has not happened. */
1845 bs
->rd_bytes
+= (unsigned) nb_sectors
* BDRV_SECTOR_SIZE
;
1852 BlockDriverAIOCB
*bdrv_aio_writev(BlockDriverState
*bs
, int64_t sector_num
,
1853 QEMUIOVector
*qiov
, int nb_sectors
,
1854 BlockDriverCompletionFunc
*cb
, void *opaque
)
1856 BlockDriver
*drv
= bs
->drv
;
1857 BlockDriverAIOCB
*ret
;
1863 if (bdrv_check_request(bs
, sector_num
, nb_sectors
))
1866 if (bs
->dirty_bitmap
) {
1867 set_dirty_bitmap(bs
, sector_num
, nb_sectors
, 1);
1870 ret
= drv
->bdrv_aio_writev(bs
, sector_num
, qiov
, nb_sectors
,
1874 /* Update stats even though technically transfer has not happened. */
1875 bs
->wr_bytes
+= (unsigned) nb_sectors
* BDRV_SECTOR_SIZE
;
1877 if (bs
->wr_highest_sector
< sector_num
+ nb_sectors
- 1) {
1878 bs
->wr_highest_sector
= sector_num
+ nb_sectors
- 1;
1886 typedef struct MultiwriteCB
{
1891 BlockDriverCompletionFunc
*cb
;
1893 QEMUIOVector
*free_qiov
;
1898 static void multiwrite_user_cb(MultiwriteCB
*mcb
)
1902 for (i
= 0; i
< mcb
->num_callbacks
; i
++) {
1903 mcb
->callbacks
[i
].cb(mcb
->callbacks
[i
].opaque
, mcb
->error
);
1904 if (mcb
->callbacks
[i
].free_qiov
) {
1905 qemu_iovec_destroy(mcb
->callbacks
[i
].free_qiov
);
1907 qemu_free(mcb
->callbacks
[i
].free_qiov
);
1908 qemu_vfree(mcb
->callbacks
[i
].free_buf
);
1912 static void multiwrite_cb(void *opaque
, int ret
)
1914 MultiwriteCB
*mcb
= opaque
;
1916 if (ret
< 0 && !mcb
->error
) {
1918 multiwrite_user_cb(mcb
);
1921 mcb
->num_requests
--;
1922 if (mcb
->num_requests
== 0) {
1923 if (mcb
->error
== 0) {
1924 multiwrite_user_cb(mcb
);
1930 static int multiwrite_req_compare(const void *a
, const void *b
)
1932 return (((BlockRequest
*) a
)->sector
- ((BlockRequest
*) b
)->sector
);
1936 * Takes a bunch of requests and tries to merge them. Returns the number of
1937 * requests that remain after merging.
1939 static int multiwrite_merge(BlockDriverState
*bs
, BlockRequest
*reqs
,
1940 int num_reqs
, MultiwriteCB
*mcb
)
1944 // Sort requests by start sector
1945 qsort(reqs
, num_reqs
, sizeof(*reqs
), &multiwrite_req_compare
);
1947 // Check if adjacent requests touch the same clusters. If so, combine them,
1948 // filling up gaps with zero sectors.
1950 for (i
= 1; i
< num_reqs
; i
++) {
1952 int64_t oldreq_last
= reqs
[outidx
].sector
+ reqs
[outidx
].nb_sectors
;
1954 // This handles the cases that are valid for all block drivers, namely
1955 // exactly sequential writes and overlapping writes.
1956 if (reqs
[i
].sector
<= oldreq_last
) {
1960 // The block driver may decide that it makes sense to combine requests
1961 // even if there is a gap of some sectors between them. In this case,
1962 // the gap is filled with zeros (therefore only applicable for yet
1963 // unused space in format like qcow2).
1964 if (!merge
&& bs
->drv
->bdrv_merge_requests
) {
1965 merge
= bs
->drv
->bdrv_merge_requests(bs
, &reqs
[outidx
], &reqs
[i
]);
1968 if (reqs
[outidx
].qiov
->niov
+ reqs
[i
].qiov
->niov
+ 1 > IOV_MAX
) {
1974 QEMUIOVector
*qiov
= qemu_mallocz(sizeof(*qiov
));
1975 qemu_iovec_init(qiov
,
1976 reqs
[outidx
].qiov
->niov
+ reqs
[i
].qiov
->niov
+ 1);
1978 // Add the first request to the merged one. If the requests are
1979 // overlapping, drop the last sectors of the first request.
1980 size
= (reqs
[i
].sector
- reqs
[outidx
].sector
) << 9;
1981 qemu_iovec_concat(qiov
, reqs
[outidx
].qiov
, size
);
1983 // We might need to add some zeros between the two requests
1984 if (reqs
[i
].sector
> oldreq_last
) {
1985 size_t zero_bytes
= (reqs
[i
].sector
- oldreq_last
) << 9;
1986 uint8_t *buf
= qemu_blockalign(bs
, zero_bytes
);
1987 memset(buf
, 0, zero_bytes
);
1988 qemu_iovec_add(qiov
, buf
, zero_bytes
);
1989 mcb
->callbacks
[i
].free_buf
= buf
;
1992 // Add the second request
1993 qemu_iovec_concat(qiov
, reqs
[i
].qiov
, reqs
[i
].qiov
->size
);
1995 reqs
[outidx
].nb_sectors
+= reqs
[i
].nb_sectors
;
1996 reqs
[outidx
].qiov
= qiov
;
1998 mcb
->callbacks
[i
].free_qiov
= reqs
[outidx
].qiov
;
2001 reqs
[outidx
].sector
= reqs
[i
].sector
;
2002 reqs
[outidx
].nb_sectors
= reqs
[i
].nb_sectors
;
2003 reqs
[outidx
].qiov
= reqs
[i
].qiov
;
2011 * Submit multiple AIO write requests at once.
2013 * On success, the function returns 0 and all requests in the reqs array have
2014 * been submitted. In error case this function returns -1, and any of the
2015 * requests may or may not be submitted yet. In particular, this means that the
2016 * callback will be called for some of the requests, for others it won't. The
2017 * caller must check the error field of the BlockRequest to wait for the right
2018 * callbacks (if error != 0, no callback will be called).
2020 * The implementation may modify the contents of the reqs array, e.g. to merge
2021 * requests. However, the fields opaque and error are left unmodified as they
2022 * are used to signal failure for a single request to the caller.
2024 int bdrv_aio_multiwrite(BlockDriverState
*bs
, BlockRequest
*reqs
, int num_reqs
)
2026 BlockDriverAIOCB
*acb
;
2030 if (num_reqs
== 0) {
2034 // Create MultiwriteCB structure
2035 mcb
= qemu_mallocz(sizeof(*mcb
) + num_reqs
* sizeof(*mcb
->callbacks
));
2036 mcb
->num_requests
= 0;
2037 mcb
->num_callbacks
= num_reqs
;
2039 for (i
= 0; i
< num_reqs
; i
++) {
2040 mcb
->callbacks
[i
].cb
= reqs
[i
].cb
;
2041 mcb
->callbacks
[i
].opaque
= reqs
[i
].opaque
;
2044 // Check for mergable requests
2045 num_reqs
= multiwrite_merge(bs
, reqs
, num_reqs
, mcb
);
2047 // Run the aio requests
2048 for (i
= 0; i
< num_reqs
; i
++) {
2049 acb
= bdrv_aio_writev(bs
, reqs
[i
].sector
, reqs
[i
].qiov
,
2050 reqs
[i
].nb_sectors
, multiwrite_cb
, mcb
);
2053 // We can only fail the whole thing if no request has been
2054 // submitted yet. Otherwise we'll wait for the submitted AIOs to
2055 // complete and report the error in the callback.
2056 if (mcb
->num_requests
== 0) {
2057 reqs
[i
].error
= -EIO
;
2060 mcb
->num_requests
++;
2061 multiwrite_cb(mcb
, -EIO
);
2065 mcb
->num_requests
++;
2076 BlockDriverAIOCB
*bdrv_aio_flush(BlockDriverState
*bs
,
2077 BlockDriverCompletionFunc
*cb
, void *opaque
)
2079 BlockDriver
*drv
= bs
->drv
;
2083 return drv
->bdrv_aio_flush(bs
, cb
, opaque
);
2086 void bdrv_aio_cancel(BlockDriverAIOCB
*acb
)
2088 acb
->pool
->cancel(acb
);
2092 /**************************************************************/
2093 /* async block device emulation */
2095 typedef struct BlockDriverAIOCBSync
{
2096 BlockDriverAIOCB common
;
2099 /* vector translation state */
2103 } BlockDriverAIOCBSync
;
2105 static void bdrv_aio_cancel_em(BlockDriverAIOCB
*blockacb
)
2107 BlockDriverAIOCBSync
*acb
=
2108 container_of(blockacb
, BlockDriverAIOCBSync
, common
);
2109 qemu_bh_delete(acb
->bh
);
2111 qemu_aio_release(acb
);
2114 static AIOPool bdrv_em_aio_pool
= {
2115 .aiocb_size
= sizeof(BlockDriverAIOCBSync
),
2116 .cancel
= bdrv_aio_cancel_em
,
2119 static void bdrv_aio_bh_cb(void *opaque
)
2121 BlockDriverAIOCBSync
*acb
= opaque
;
2124 qemu_iovec_from_buffer(acb
->qiov
, acb
->bounce
, acb
->qiov
->size
);
2125 qemu_vfree(acb
->bounce
);
2126 acb
->common
.cb(acb
->common
.opaque
, acb
->ret
);
2127 qemu_bh_delete(acb
->bh
);
2129 qemu_aio_release(acb
);
2132 static BlockDriverAIOCB
*bdrv_aio_rw_vector(BlockDriverState
*bs
,
2136 BlockDriverCompletionFunc
*cb
,
2141 BlockDriverAIOCBSync
*acb
;
2143 acb
= qemu_aio_get(&bdrv_em_aio_pool
, bs
, cb
, opaque
);
2144 acb
->is_write
= is_write
;
2146 acb
->bounce
= qemu_blockalign(bs
, qiov
->size
);
2149 acb
->bh
= qemu_bh_new(bdrv_aio_bh_cb
, acb
);
2152 qemu_iovec_to_buffer(acb
->qiov
, acb
->bounce
);
2153 acb
->ret
= bdrv_write(bs
, sector_num
, acb
->bounce
, nb_sectors
);
2155 acb
->ret
= bdrv_read(bs
, sector_num
, acb
->bounce
, nb_sectors
);
2158 qemu_bh_schedule(acb
->bh
);
2160 return &acb
->common
;
2163 static BlockDriverAIOCB
*bdrv_aio_readv_em(BlockDriverState
*bs
,
2164 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
2165 BlockDriverCompletionFunc
*cb
, void *opaque
)
2167 return bdrv_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
, cb
, opaque
, 0);
2170 static BlockDriverAIOCB
*bdrv_aio_writev_em(BlockDriverState
*bs
,
2171 int64_t sector_num
, QEMUIOVector
*qiov
, int nb_sectors
,
2172 BlockDriverCompletionFunc
*cb
, void *opaque
)
2174 return bdrv_aio_rw_vector(bs
, sector_num
, qiov
, nb_sectors
, cb
, opaque
, 1);
2177 static BlockDriverAIOCB
*bdrv_aio_flush_em(BlockDriverState
*bs
,
2178 BlockDriverCompletionFunc
*cb
, void *opaque
)
2180 BlockDriverAIOCBSync
*acb
;
2182 acb
= qemu_aio_get(&bdrv_em_aio_pool
, bs
, cb
, opaque
);
2183 acb
->is_write
= 1; /* don't bounce in the completion hadler */
2189 acb
->bh
= qemu_bh_new(bdrv_aio_bh_cb
, acb
);
2192 qemu_bh_schedule(acb
->bh
);
2193 return &acb
->common
;
2196 /**************************************************************/
2197 /* sync block device emulation */
2199 static void bdrv_rw_em_cb(void *opaque
, int ret
)
2201 *(int *)opaque
= ret
;
2204 #define NOT_DONE 0x7fffffff
2206 static int bdrv_read_em(BlockDriverState
*bs
, int64_t sector_num
,
2207 uint8_t *buf
, int nb_sectors
)
2210 BlockDriverAIOCB
*acb
;
2214 async_context_push();
2216 async_ret
= NOT_DONE
;
2217 iov
.iov_base
= (void *)buf
;
2218 iov
.iov_len
= nb_sectors
* 512;
2219 qemu_iovec_init_external(&qiov
, &iov
, 1);
2220 acb
= bdrv_aio_readv(bs
, sector_num
, &qiov
, nb_sectors
,
2221 bdrv_rw_em_cb
, &async_ret
);
2227 while (async_ret
== NOT_DONE
) {
2233 async_context_pop();
2237 static int bdrv_write_em(BlockDriverState
*bs
, int64_t sector_num
,
2238 const uint8_t *buf
, int nb_sectors
)
2241 BlockDriverAIOCB
*acb
;
2245 async_context_push();
2247 async_ret
= NOT_DONE
;
2248 iov
.iov_base
= (void *)buf
;
2249 iov
.iov_len
= nb_sectors
* 512;
2250 qemu_iovec_init_external(&qiov
, &iov
, 1);
2251 acb
= bdrv_aio_writev(bs
, sector_num
, &qiov
, nb_sectors
,
2252 bdrv_rw_em_cb
, &async_ret
);
2257 while (async_ret
== NOT_DONE
) {
2262 async_context_pop();
2266 void bdrv_init(void)
2268 module_call_init(MODULE_INIT_BLOCK
);
2271 void bdrv_init_with_whitelist(void)
2273 use_bdrv_whitelist
= 1;
2277 void *qemu_aio_get(AIOPool
*pool
, BlockDriverState
*bs
,
2278 BlockDriverCompletionFunc
*cb
, void *opaque
)
2280 BlockDriverAIOCB
*acb
;
2282 if (pool
->free_aiocb
) {
2283 acb
= pool
->free_aiocb
;
2284 pool
->free_aiocb
= acb
->next
;
2286 acb
= qemu_mallocz(pool
->aiocb_size
);
2291 acb
->opaque
= opaque
;
2295 void qemu_aio_release(void *p
)
2297 BlockDriverAIOCB
*acb
= (BlockDriverAIOCB
*)p
;
2298 AIOPool
*pool
= acb
->pool
;
2299 acb
->next
= pool
->free_aiocb
;
2300 pool
->free_aiocb
= acb
;
2303 /**************************************************************/
2304 /* removable device support */
2307 * Return TRUE if the media is present
2309 int bdrv_is_inserted(BlockDriverState
*bs
)
2311 BlockDriver
*drv
= bs
->drv
;
2315 if (!drv
->bdrv_is_inserted
)
2317 ret
= drv
->bdrv_is_inserted(bs
);
2322 * Return TRUE if the media changed since the last call to this
2323 * function. It is currently only used for floppy disks
2325 int bdrv_media_changed(BlockDriverState
*bs
)
2327 BlockDriver
*drv
= bs
->drv
;
2330 if (!drv
|| !drv
->bdrv_media_changed
)
2333 ret
= drv
->bdrv_media_changed(bs
);
2334 if (ret
== -ENOTSUP
)
2335 ret
= bs
->media_changed
;
2336 bs
->media_changed
= 0;
2341 * If eject_flag is TRUE, eject the media. Otherwise, close the tray
2343 int bdrv_eject(BlockDriverState
*bs
, int eject_flag
)
2345 BlockDriver
*drv
= bs
->drv
;
2352 if (!drv
|| !drv
->bdrv_eject
) {
2355 ret
= drv
->bdrv_eject(bs
, eject_flag
);
2357 if (ret
== -ENOTSUP
) {
2366 int bdrv_is_locked(BlockDriverState
*bs
)
2372 * Lock or unlock the media (if it is locked, the user won't be able
2373 * to eject it manually).
2375 void bdrv_set_locked(BlockDriverState
*bs
, int locked
)
2377 BlockDriver
*drv
= bs
->drv
;
2379 bs
->locked
= locked
;
2380 if (drv
&& drv
->bdrv_set_locked
) {
2381 drv
->bdrv_set_locked(bs
, locked
);
2385 /* needed for generic scsi interface */
2387 int bdrv_ioctl(BlockDriverState
*bs
, unsigned long int req
, void *buf
)
2389 BlockDriver
*drv
= bs
->drv
;
2391 if (drv
&& drv
->bdrv_ioctl
)
2392 return drv
->bdrv_ioctl(bs
, req
, buf
);
2396 BlockDriverAIOCB
*bdrv_aio_ioctl(BlockDriverState
*bs
,
2397 unsigned long int req
, void *buf
,
2398 BlockDriverCompletionFunc
*cb
, void *opaque
)
2400 BlockDriver
*drv
= bs
->drv
;
2402 if (drv
&& drv
->bdrv_aio_ioctl
)
2403 return drv
->bdrv_aio_ioctl(bs
, req
, buf
, cb
, opaque
);
2409 void *qemu_blockalign(BlockDriverState
*bs
, size_t size
)
2411 return qemu_memalign((bs
&& bs
->buffer_alignment
) ? bs
->buffer_alignment
: 512, size
);
2414 void bdrv_set_dirty_tracking(BlockDriverState
*bs
, int enable
)
2416 int64_t bitmap_size
;
2418 bs
->dirty_count
= 0;
2420 if (!bs
->dirty_bitmap
) {
2421 bitmap_size
= (bdrv_getlength(bs
) >> BDRV_SECTOR_BITS
) +
2422 BDRV_SECTORS_PER_DIRTY_CHUNK
* 8 - 1;
2423 bitmap_size
/= BDRV_SECTORS_PER_DIRTY_CHUNK
* 8;
2425 bs
->dirty_bitmap
= qemu_mallocz(bitmap_size
);
2428 if (bs
->dirty_bitmap
) {
2429 qemu_free(bs
->dirty_bitmap
);
2430 bs
->dirty_bitmap
= NULL
;
2435 int bdrv_get_dirty(BlockDriverState
*bs
, int64_t sector
)
2437 int64_t chunk
= sector
/ (int64_t)BDRV_SECTORS_PER_DIRTY_CHUNK
;
2439 if (bs
->dirty_bitmap
&&
2440 (sector
<< BDRV_SECTOR_BITS
) < bdrv_getlength(bs
)) {
2441 return bs
->dirty_bitmap
[chunk
/ (sizeof(unsigned long) * 8)] &
2442 (1 << (chunk
% (sizeof(unsigned long) * 8)));
2448 void bdrv_reset_dirty(BlockDriverState
*bs
, int64_t cur_sector
,
2451 set_dirty_bitmap(bs
, cur_sector
, nr_sectors
, 0);
2454 int64_t bdrv_get_dirty_count(BlockDriverState
*bs
)
2456 return bs
->dirty_count
;