1ebc2752bSEmanuele Giuseppe Esposito /* 2ebc2752bSEmanuele Giuseppe Esposito * QEMU System Emulator block driver 3ebc2752bSEmanuele Giuseppe Esposito * 4ebc2752bSEmanuele Giuseppe Esposito * Copyright (c) 2003 Fabrice Bellard 5ebc2752bSEmanuele Giuseppe Esposito * 6ebc2752bSEmanuele Giuseppe Esposito * Permission is hereby granted, free of charge, to any person obtaining a copy 7ebc2752bSEmanuele Giuseppe Esposito * of this software and associated documentation files (the "Software"), to deal 8ebc2752bSEmanuele Giuseppe Esposito * in the Software without restriction, including without limitation the rights 9ebc2752bSEmanuele Giuseppe Esposito * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 10ebc2752bSEmanuele Giuseppe Esposito * copies of the Software, and to permit persons to whom the Software is 11ebc2752bSEmanuele Giuseppe Esposito * furnished to do so, subject to the following conditions: 12ebc2752bSEmanuele Giuseppe Esposito * 13ebc2752bSEmanuele Giuseppe Esposito * The above copyright notice and this permission notice shall be included in 14ebc2752bSEmanuele Giuseppe Esposito * all copies or substantial portions of the Software. 15ebc2752bSEmanuele Giuseppe Esposito * 16ebc2752bSEmanuele Giuseppe Esposito * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17ebc2752bSEmanuele Giuseppe Esposito * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18ebc2752bSEmanuele Giuseppe Esposito * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 19ebc2752bSEmanuele Giuseppe Esposito * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20ebc2752bSEmanuele Giuseppe Esposito * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 21ebc2752bSEmanuele Giuseppe Esposito * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 22ebc2752bSEmanuele Giuseppe Esposito * THE SOFTWARE. 23ebc2752bSEmanuele Giuseppe Esposito */ 24ebc2752bSEmanuele Giuseppe Esposito #ifndef BLOCK_INT_COMMON_H 25ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_INT_COMMON_H 26ebc2752bSEmanuele Giuseppe Esposito 27e2c1c34fSMarkus Armbruster #include "block/aio.h" 28e2c1c34fSMarkus Armbruster #include "block/block-common.h" 29e2c1c34fSMarkus Armbruster #include "block/block-global-state.h" 30ebc2752bSEmanuele Giuseppe Esposito #include "block/snapshot.h" 31e2c1c34fSMarkus Armbruster #include "qemu/iov.h" 32ebc2752bSEmanuele Giuseppe Esposito #include "qemu/rcu.h" 33e2c1c34fSMarkus Armbruster #include "qemu/stats64.h" 34ebc2752bSEmanuele Giuseppe Esposito 35ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_FLAG_LAZY_REFCOUNTS 8 36ebc2752bSEmanuele Giuseppe Esposito 37ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_SIZE "size" 38ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_ENCRYPT "encryption" 39ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_ENCRYPT_FORMAT "encrypt.format" 40ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_COMPAT6 "compat6" 41ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_HWVERSION "hwversion" 42ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_BACKING_FILE "backing_file" 43ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_BACKING_FMT "backing_fmt" 44ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_CLUSTER_SIZE "cluster_size" 45ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_TABLE_SIZE "table_size" 46ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_PREALLOC "preallocation" 47ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_SUBFMT "subformat" 48ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_COMPAT_LEVEL "compat" 49ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_LAZY_REFCOUNTS "lazy_refcounts" 50ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_ADAPTER_TYPE "adapter_type" 51ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_REDUNDANCY "redundancy" 52ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_NOCOW "nocow" 53ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_EXTENT_SIZE_HINT "extent_size_hint" 54ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_OBJECT_SIZE "object_size" 55ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_REFCOUNT_BITS "refcount_bits" 56ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_DATA_FILE "data_file" 57ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_DATA_FILE_RAW "data_file_raw" 58ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_COMPRESSION_TYPE "compression_type" 59ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_OPT_EXTL2 "extended_l2" 60ebc2752bSEmanuele Giuseppe Esposito 61ebc2752bSEmanuele Giuseppe Esposito #define BLOCK_PROBE_BUF_SIZE 512 62ebc2752bSEmanuele Giuseppe Esposito 63ebc2752bSEmanuele Giuseppe Esposito enum BdrvTrackedRequestType { 64ebc2752bSEmanuele Giuseppe Esposito BDRV_TRACKED_READ, 65ebc2752bSEmanuele Giuseppe Esposito BDRV_TRACKED_WRITE, 66ebc2752bSEmanuele Giuseppe Esposito BDRV_TRACKED_DISCARD, 67ebc2752bSEmanuele Giuseppe Esposito BDRV_TRACKED_TRUNCATE, 68ebc2752bSEmanuele Giuseppe Esposito }; 69ebc2752bSEmanuele Giuseppe Esposito 70ebc2752bSEmanuele Giuseppe Esposito /* 71ebc2752bSEmanuele Giuseppe Esposito * That is not quite good that BdrvTrackedRequest structure is public, 72ebc2752bSEmanuele Giuseppe Esposito * as block/io.c is very careful about incoming offset/bytes being 73ebc2752bSEmanuele Giuseppe Esposito * correct. Be sure to assert bdrv_check_request() succeeded after any 74ebc2752bSEmanuele Giuseppe Esposito * modification of BdrvTrackedRequest object out of block/io.c 75ebc2752bSEmanuele Giuseppe Esposito */ 76ebc2752bSEmanuele Giuseppe Esposito typedef struct BdrvTrackedRequest { 77ebc2752bSEmanuele Giuseppe Esposito BlockDriverState *bs; 78ebc2752bSEmanuele Giuseppe Esposito int64_t offset; 79ebc2752bSEmanuele Giuseppe Esposito int64_t bytes; 80ebc2752bSEmanuele Giuseppe Esposito enum BdrvTrackedRequestType type; 81ebc2752bSEmanuele Giuseppe Esposito 82ebc2752bSEmanuele Giuseppe Esposito bool serialising; 83ebc2752bSEmanuele Giuseppe Esposito int64_t overlap_offset; 84ebc2752bSEmanuele Giuseppe Esposito int64_t overlap_bytes; 85ebc2752bSEmanuele Giuseppe Esposito 86ebc2752bSEmanuele Giuseppe Esposito QLIST_ENTRY(BdrvTrackedRequest) list; 87ebc2752bSEmanuele Giuseppe Esposito Coroutine *co; /* owner, used for deadlock detection */ 88ebc2752bSEmanuele Giuseppe Esposito CoQueue wait_queue; /* coroutines blocked on this request */ 89ebc2752bSEmanuele Giuseppe Esposito 90ebc2752bSEmanuele Giuseppe Esposito struct BdrvTrackedRequest *waiting_for; 91ebc2752bSEmanuele Giuseppe Esposito } BdrvTrackedRequest; 92ebc2752bSEmanuele Giuseppe Esposito 93ebc2752bSEmanuele Giuseppe Esposito 94ebc2752bSEmanuele Giuseppe Esposito struct BlockDriver { 9569c0bf11SEmanuele Giuseppe Esposito /* 9669c0bf11SEmanuele Giuseppe Esposito * These fields are initialized when this object is created, 9769c0bf11SEmanuele Giuseppe Esposito * and are never changed afterwards. 9869c0bf11SEmanuele Giuseppe Esposito */ 9969c0bf11SEmanuele Giuseppe Esposito 100ebc2752bSEmanuele Giuseppe Esposito const char *format_name; 101ebc2752bSEmanuele Giuseppe Esposito int instance_size; 102ebc2752bSEmanuele Giuseppe Esposito 103ebc2752bSEmanuele Giuseppe Esposito /* 104ebc2752bSEmanuele Giuseppe Esposito * Set to true if the BlockDriver is a block filter. Block filters pass 105ebc2752bSEmanuele Giuseppe Esposito * certain callbacks that refer to data (see block.c) to their bs->file 106ebc2752bSEmanuele Giuseppe Esposito * or bs->backing (whichever one exists) if the driver doesn't implement 107ebc2752bSEmanuele Giuseppe Esposito * them. Drivers that do not wish to forward must implement them and return 108ebc2752bSEmanuele Giuseppe Esposito * -ENOTSUP. 109ebc2752bSEmanuele Giuseppe Esposito * Note that filters are not allowed to modify data. 110ebc2752bSEmanuele Giuseppe Esposito * 111ebc2752bSEmanuele Giuseppe Esposito * Filters generally cannot have more than a single filtered child, 112ebc2752bSEmanuele Giuseppe Esposito * because the data they present must at all times be the same as 113ebc2752bSEmanuele Giuseppe Esposito * that on their filtered child. That would be impossible to 114ebc2752bSEmanuele Giuseppe Esposito * achieve for multiple filtered children. 115ebc2752bSEmanuele Giuseppe Esposito * (And this filtered child must then be bs->file or bs->backing.) 116ebc2752bSEmanuele Giuseppe Esposito */ 117ebc2752bSEmanuele Giuseppe Esposito bool is_filter; 118ebc2752bSEmanuele Giuseppe Esposito /* 119046fd84fSVladimir Sementsov-Ogievskiy * Only make sense for filter drivers, for others must be false. 120046fd84fSVladimir Sementsov-Ogievskiy * If true, filtered child is bs->backing. Otherwise it's bs->file. 1211921b4f7SVladimir Sementsov-Ogievskiy * Two internal filters use bs->backing as filtered child and has this 1221921b4f7SVladimir Sementsov-Ogievskiy * field set to true: mirror_top and commit_top. There also two such test 1231921b4f7SVladimir Sementsov-Ogievskiy * filters in tests/unit/test-bdrv-graph-mod.c. 124046fd84fSVladimir Sementsov-Ogievskiy * 125046fd84fSVladimir Sementsov-Ogievskiy * Never create any more such filters! 126046fd84fSVladimir Sementsov-Ogievskiy * 127046fd84fSVladimir Sementsov-Ogievskiy * TODO: imagine how to deprecate this behavior and make all filters work 128046fd84fSVladimir Sementsov-Ogievskiy * similarly using bs->file as filtered child. 129046fd84fSVladimir Sementsov-Ogievskiy */ 130046fd84fSVladimir Sementsov-Ogievskiy bool filtered_child_is_backing; 131046fd84fSVladimir Sementsov-Ogievskiy 132046fd84fSVladimir Sementsov-Ogievskiy /* 133ebc2752bSEmanuele Giuseppe Esposito * Set to true if the BlockDriver is a format driver. Format nodes 134ebc2752bSEmanuele Giuseppe Esposito * generally do not expect their children to be other format nodes 135ebc2752bSEmanuele Giuseppe Esposito * (except for backing files), and so format probing is disabled 136ebc2752bSEmanuele Giuseppe Esposito * on those children. 137ebc2752bSEmanuele Giuseppe Esposito */ 138ebc2752bSEmanuele Giuseppe Esposito bool is_format; 139ebc2752bSEmanuele Giuseppe Esposito 140ebc2752bSEmanuele Giuseppe Esposito /* 141774c726cSSam Li * Set to true if the BlockDriver supports zoned children. 142774c726cSSam Li */ 143774c726cSSam Li bool supports_zoned_children; 144774c726cSSam Li 145774c726cSSam Li /* 146ebc2752bSEmanuele Giuseppe Esposito * Drivers not implementing bdrv_parse_filename nor bdrv_open should have 147ebc2752bSEmanuele Giuseppe Esposito * this field set to true, except ones that are defined only by their 148ebc2752bSEmanuele Giuseppe Esposito * child's bs. 149ebc2752bSEmanuele Giuseppe Esposito * An example of the last type will be the quorum block driver. 150ebc2752bSEmanuele Giuseppe Esposito */ 151ebc2752bSEmanuele Giuseppe Esposito bool bdrv_needs_filename; 152ebc2752bSEmanuele Giuseppe Esposito 153ebc2752bSEmanuele Giuseppe Esposito /* 154ebc2752bSEmanuele Giuseppe Esposito * Set if a driver can support backing files. This also implies the 155ebc2752bSEmanuele Giuseppe Esposito * following semantics: 156ebc2752bSEmanuele Giuseppe Esposito * 157ebc2752bSEmanuele Giuseppe Esposito * - Return status 0 of .bdrv_co_block_status means that corresponding 158ebc2752bSEmanuele Giuseppe Esposito * blocks are not allocated in this layer of backing-chain 159ebc2752bSEmanuele Giuseppe Esposito * - For such (unallocated) blocks, read will: 160ebc2752bSEmanuele Giuseppe Esposito * - fill buffer with zeros if there is no backing file 161ebc2752bSEmanuele Giuseppe Esposito * - read from the backing file otherwise, where the block layer 162ebc2752bSEmanuele Giuseppe Esposito * takes care of reading zeros beyond EOF if backing file is short 163ebc2752bSEmanuele Giuseppe Esposito */ 164ebc2752bSEmanuele Giuseppe Esposito bool supports_backing; 165ebc2752bSEmanuele Giuseppe Esposito 16669c0bf11SEmanuele Giuseppe Esposito /* 16769c0bf11SEmanuele Giuseppe Esposito * Drivers setting this field must be able to work with just a plain 16869c0bf11SEmanuele Giuseppe Esposito * filename with '<protocol_name>:' as a prefix, and no other options. 16969c0bf11SEmanuele Giuseppe Esposito * Options may be extracted from the filename by implementing 17069c0bf11SEmanuele Giuseppe Esposito * bdrv_parse_filename. 17169c0bf11SEmanuele Giuseppe Esposito */ 17269c0bf11SEmanuele Giuseppe Esposito const char *protocol_name; 17369c0bf11SEmanuele Giuseppe Esposito 17469c0bf11SEmanuele Giuseppe Esposito /* List of options for creating images, terminated by name == NULL */ 17569c0bf11SEmanuele Giuseppe Esposito QemuOptsList *create_opts; 17669c0bf11SEmanuele Giuseppe Esposito 17769c0bf11SEmanuele Giuseppe Esposito /* List of options for image amend */ 17869c0bf11SEmanuele Giuseppe Esposito QemuOptsList *amend_opts; 17969c0bf11SEmanuele Giuseppe Esposito 18069c0bf11SEmanuele Giuseppe Esposito /* 18169c0bf11SEmanuele Giuseppe Esposito * If this driver supports reopening images this contains a 18269c0bf11SEmanuele Giuseppe Esposito * NULL-terminated list of the runtime options that can be 18369c0bf11SEmanuele Giuseppe Esposito * modified. If an option in this list is unspecified during 18469c0bf11SEmanuele Giuseppe Esposito * reopen then it _must_ be reset to its default value or return 18569c0bf11SEmanuele Giuseppe Esposito * an error. 18669c0bf11SEmanuele Giuseppe Esposito */ 18769c0bf11SEmanuele Giuseppe Esposito const char *const *mutable_opts; 18869c0bf11SEmanuele Giuseppe Esposito 18969c0bf11SEmanuele Giuseppe Esposito /* 19069c0bf11SEmanuele Giuseppe Esposito * Pointer to a NULL-terminated array of names of strong options 19169c0bf11SEmanuele Giuseppe Esposito * that can be specified for bdrv_open(). A strong option is one 19269c0bf11SEmanuele Giuseppe Esposito * that changes the data of a BDS. 19369c0bf11SEmanuele Giuseppe Esposito * If this pointer is NULL, the array is considered empty. 19469c0bf11SEmanuele Giuseppe Esposito * "filename" and "driver" are always considered strong. 19569c0bf11SEmanuele Giuseppe Esposito */ 19669c0bf11SEmanuele Giuseppe Esposito const char *const *strong_runtime_opts; 19769c0bf11SEmanuele Giuseppe Esposito 19869c0bf11SEmanuele Giuseppe Esposito 19969c0bf11SEmanuele Giuseppe Esposito /* 20069c0bf11SEmanuele Giuseppe Esposito * Global state (GS) API. These functions run under the BQL. 20169c0bf11SEmanuele Giuseppe Esposito * 20269c0bf11SEmanuele Giuseppe Esposito * See include/block/block-global-state.h for more information about 20369c0bf11SEmanuele Giuseppe Esposito * the GS API. 20469c0bf11SEmanuele Giuseppe Esposito */ 20569c0bf11SEmanuele Giuseppe Esposito 20669c0bf11SEmanuele Giuseppe Esposito /* 20769c0bf11SEmanuele Giuseppe Esposito * This function is invoked under BQL before .bdrv_co_amend() 20869c0bf11SEmanuele Giuseppe Esposito * (which in contrast does not necessarily run under the BQL) 20969c0bf11SEmanuele Giuseppe Esposito * to allow driver-specific initialization code that requires 21069c0bf11SEmanuele Giuseppe Esposito * the BQL, like setting up specific permission flags. 21169c0bf11SEmanuele Giuseppe Esposito */ 212840428a2SEmanuele Giuseppe Esposito int GRAPH_RDLOCK_PTR (*bdrv_amend_pre_run)( 213840428a2SEmanuele Giuseppe Esposito BlockDriverState *bs, Error **errp); 21469c0bf11SEmanuele Giuseppe Esposito /* 21569c0bf11SEmanuele Giuseppe Esposito * This function is invoked under BQL after .bdrv_co_amend() 21669c0bf11SEmanuele Giuseppe Esposito * to allow cleaning up what was done in .bdrv_amend_pre_run(). 21769c0bf11SEmanuele Giuseppe Esposito */ 218840428a2SEmanuele Giuseppe Esposito void GRAPH_RDLOCK_PTR (*bdrv_amend_clean)(BlockDriverState *bs); 21969c0bf11SEmanuele Giuseppe Esposito 22069c0bf11SEmanuele Giuseppe Esposito /* 22169c0bf11SEmanuele Giuseppe Esposito * Return true if @to_replace can be replaced by a BDS with the 22269c0bf11SEmanuele Giuseppe Esposito * same data as @bs without it affecting @bs's behavior (that is, 22369c0bf11SEmanuele Giuseppe Esposito * without it being visible to @bs's parents). 22469c0bf11SEmanuele Giuseppe Esposito */ 225533c6e4eSKevin Wolf bool GRAPH_RDLOCK_PTR (*bdrv_recurse_can_replace)( 226533c6e4eSKevin Wolf BlockDriverState *bs, BlockDriverState *to_replace); 22769c0bf11SEmanuele Giuseppe Esposito 22869c0bf11SEmanuele Giuseppe Esposito int (*bdrv_probe_device)(const char *filename); 22969c0bf11SEmanuele Giuseppe Esposito 23069c0bf11SEmanuele Giuseppe Esposito /* 23169c0bf11SEmanuele Giuseppe Esposito * Any driver implementing this callback is expected to be able to handle 23269c0bf11SEmanuele Giuseppe Esposito * NULL file names in its .bdrv_open() implementation. 23369c0bf11SEmanuele Giuseppe Esposito */ 23469c0bf11SEmanuele Giuseppe Esposito void (*bdrv_parse_filename)(const char *filename, QDict *options, 23569c0bf11SEmanuele Giuseppe Esposito Error **errp); 23669c0bf11SEmanuele Giuseppe Esposito 23769c0bf11SEmanuele Giuseppe Esposito /* For handling image reopen for split or non-split files. */ 238ebc2752bSEmanuele Giuseppe Esposito int (*bdrv_reopen_prepare)(BDRVReopenState *reopen_state, 239ebc2752bSEmanuele Giuseppe Esposito BlockReopenQueue *queue, Error **errp); 240ebc2752bSEmanuele Giuseppe Esposito void (*bdrv_reopen_commit)(BDRVReopenState *reopen_state); 241ebc2752bSEmanuele Giuseppe Esposito void (*bdrv_reopen_commit_post)(BDRVReopenState *reopen_state); 242ebc2752bSEmanuele Giuseppe Esposito void (*bdrv_reopen_abort)(BDRVReopenState *reopen_state); 243ebc2752bSEmanuele Giuseppe Esposito void (*bdrv_join_options)(QDict *options, QDict *old_options); 244ebc2752bSEmanuele Giuseppe Esposito 2451a30b0f5SKevin Wolf int GRAPH_UNLOCKED_PTR (*bdrv_open)( 2461a30b0f5SKevin Wolf BlockDriverState *bs, QDict *options, int flags, Error **errp); 247ebc2752bSEmanuele Giuseppe Esposito 248ebc2752bSEmanuele Giuseppe Esposito /* Protocol drivers should implement this instead of bdrv_open */ 2491a30b0f5SKevin Wolf int GRAPH_UNLOCKED_PTR (*bdrv_file_open)( 2501a30b0f5SKevin Wolf BlockDriverState *bs, QDict *options, int flags, Error **errp); 251ebc2752bSEmanuele Giuseppe Esposito void (*bdrv_close)(BlockDriverState *bs); 252ebc2752bSEmanuele Giuseppe Esposito 2534db7ba3bSKevin Wolf int coroutine_fn GRAPH_UNLOCKED_PTR (*bdrv_co_create)( 2544ec8df01SKevin Wolf BlockdevCreateOptions *opts, Error **errp); 2554ec8df01SKevin Wolf 2564db7ba3bSKevin Wolf int coroutine_fn GRAPH_UNLOCKED_PTR (*bdrv_co_create_opts)( 2574ec8df01SKevin Wolf BlockDriver *drv, const char *filename, QemuOpts *opts, Error **errp); 258ebc2752bSEmanuele Giuseppe Esposito 259ebc2752bSEmanuele Giuseppe Esposito int (*bdrv_amend_options)(BlockDriverState *bs, 260ebc2752bSEmanuele Giuseppe Esposito QemuOpts *opts, 261ebc2752bSEmanuele Giuseppe Esposito BlockDriverAmendStatusCB *status_cb, 262ebc2752bSEmanuele Giuseppe Esposito void *cb_opaque, 263ebc2752bSEmanuele Giuseppe Esposito bool force, 264ebc2752bSEmanuele Giuseppe Esposito Error **errp); 265ebc2752bSEmanuele Giuseppe Esposito 266ebc2752bSEmanuele Giuseppe Esposito int (*bdrv_make_empty)(BlockDriverState *bs); 267ebc2752bSEmanuele Giuseppe Esposito 268ebc2752bSEmanuele Giuseppe Esposito /* 269ebc2752bSEmanuele Giuseppe Esposito * Refreshes the bs->exact_filename field. If that is impossible, 270ebc2752bSEmanuele Giuseppe Esposito * bs->exact_filename has to be left empty. 271ebc2752bSEmanuele Giuseppe Esposito */ 272ebc2752bSEmanuele Giuseppe Esposito void (*bdrv_refresh_filename)(BlockDriverState *bs); 273ebc2752bSEmanuele Giuseppe Esposito 274ebc2752bSEmanuele Giuseppe Esposito /* 275ebc2752bSEmanuele Giuseppe Esposito * Gathers the open options for all children into @target. 276ebc2752bSEmanuele Giuseppe Esposito * A simple format driver (without backing file support) might 277ebc2752bSEmanuele Giuseppe Esposito * implement this function like this: 278ebc2752bSEmanuele Giuseppe Esposito * 279ebc2752bSEmanuele Giuseppe Esposito * QINCREF(bs->file->bs->full_open_options); 280ebc2752bSEmanuele Giuseppe Esposito * qdict_put(target, "file", bs->file->bs->full_open_options); 281ebc2752bSEmanuele Giuseppe Esposito * 282ebc2752bSEmanuele Giuseppe Esposito * If not specified, the generic implementation will simply put 283ebc2752bSEmanuele Giuseppe Esposito * all children's options under their respective name. 284ebc2752bSEmanuele Giuseppe Esposito * 285ebc2752bSEmanuele Giuseppe Esposito * @backing_overridden is true when bs->backing seems not to be 286ebc2752bSEmanuele Giuseppe Esposito * the child that would result from opening bs->backing_file. 287ebc2752bSEmanuele Giuseppe Esposito * Therefore, if it is true, the backing child's options should be 288ebc2752bSEmanuele Giuseppe Esposito * gathered; otherwise, there is no need since the backing child 289ebc2752bSEmanuele Giuseppe Esposito * is the one implied by the image header. 290ebc2752bSEmanuele Giuseppe Esposito * 291ebc2752bSEmanuele Giuseppe Esposito * Note that ideally this function would not be needed. Every 292ebc2752bSEmanuele Giuseppe Esposito * block driver which implements it is probably doing something 293ebc2752bSEmanuele Giuseppe Esposito * shady regarding its runtime option structure. 294ebc2752bSEmanuele Giuseppe Esposito */ 295ebc2752bSEmanuele Giuseppe Esposito void (*bdrv_gather_child_options)(BlockDriverState *bs, QDict *target, 296ebc2752bSEmanuele Giuseppe Esposito bool backing_overridden); 297ebc2752bSEmanuele Giuseppe Esposito 298ebc2752bSEmanuele Giuseppe Esposito /* 299ebc2752bSEmanuele Giuseppe Esposito * Returns an allocated string which is the directory name of this BDS: It 300ebc2752bSEmanuele Giuseppe Esposito * will be used to make relative filenames absolute by prepending this 301ebc2752bSEmanuele Giuseppe Esposito * function's return value to them. 302ebc2752bSEmanuele Giuseppe Esposito */ 303ebc2752bSEmanuele Giuseppe Esposito char *(*bdrv_dirname)(BlockDriverState *bs, Error **errp); 304ebc2752bSEmanuele Giuseppe Esposito 30569c0bf11SEmanuele Giuseppe Esposito /* 30669c0bf11SEmanuele Giuseppe Esposito * This informs the driver that we are no longer interested in the result 30769c0bf11SEmanuele Giuseppe Esposito * of in-flight requests, so don't waste the time if possible. 30869c0bf11SEmanuele Giuseppe Esposito * 30969c0bf11SEmanuele Giuseppe Esposito * One example usage is to avoid waiting for an nbd target node reconnect 31069c0bf11SEmanuele Giuseppe Esposito * timeout during job-cancel with force=true. 31169c0bf11SEmanuele Giuseppe Esposito */ 31269c0bf11SEmanuele Giuseppe Esposito void (*bdrv_cancel_in_flight)(BlockDriverState *bs); 31369c0bf11SEmanuele Giuseppe Esposito 3143804e3cfSKevin Wolf int GRAPH_RDLOCK_PTR (*bdrv_inactivate)(BlockDriverState *bs); 31569c0bf11SEmanuele Giuseppe Esposito 31669c0bf11SEmanuele Giuseppe Esposito int (*bdrv_snapshot_create)(BlockDriverState *bs, 31769c0bf11SEmanuele Giuseppe Esposito QEMUSnapshotInfo *sn_info); 31869c0bf11SEmanuele Giuseppe Esposito int (*bdrv_snapshot_goto)(BlockDriverState *bs, 31969c0bf11SEmanuele Giuseppe Esposito const char *snapshot_id); 32069c0bf11SEmanuele Giuseppe Esposito int (*bdrv_snapshot_delete)(BlockDriverState *bs, 32169c0bf11SEmanuele Giuseppe Esposito const char *snapshot_id, 32269c0bf11SEmanuele Giuseppe Esposito const char *name, 32369c0bf11SEmanuele Giuseppe Esposito Error **errp); 32469c0bf11SEmanuele Giuseppe Esposito int (*bdrv_snapshot_list)(BlockDriverState *bs, 32569c0bf11SEmanuele Giuseppe Esposito QEMUSnapshotInfo **psn_info); 32669c0bf11SEmanuele Giuseppe Esposito int (*bdrv_snapshot_load_tmp)(BlockDriverState *bs, 32769c0bf11SEmanuele Giuseppe Esposito const char *snapshot_id, 32869c0bf11SEmanuele Giuseppe Esposito const char *name, 32969c0bf11SEmanuele Giuseppe Esposito Error **errp); 33069c0bf11SEmanuele Giuseppe Esposito 33169c0bf11SEmanuele Giuseppe Esposito int (*bdrv_change_backing_file)(BlockDriverState *bs, 33269c0bf11SEmanuele Giuseppe Esposito const char *backing_file, const char *backing_fmt); 33369c0bf11SEmanuele Giuseppe Esposito 33469c0bf11SEmanuele Giuseppe Esposito /* TODO Better pass a option string/QDict/QemuOpts to add any rule? */ 33569c0bf11SEmanuele Giuseppe Esposito int (*bdrv_debug_breakpoint)(BlockDriverState *bs, const char *event, 33669c0bf11SEmanuele Giuseppe Esposito const char *tag); 33769c0bf11SEmanuele Giuseppe Esposito int (*bdrv_debug_remove_breakpoint)(BlockDriverState *bs, 33869c0bf11SEmanuele Giuseppe Esposito const char *tag); 33969c0bf11SEmanuele Giuseppe Esposito int (*bdrv_debug_resume)(BlockDriverState *bs, const char *tag); 34069c0bf11SEmanuele Giuseppe Esposito bool (*bdrv_debug_is_suspended)(BlockDriverState *bs, const char *tag); 34169c0bf11SEmanuele Giuseppe Esposito 342e19b157fSKevin Wolf void GRAPH_RDLOCK_PTR (*bdrv_refresh_limits)( 343e19b157fSKevin Wolf BlockDriverState *bs, Error **errp); 34469c0bf11SEmanuele Giuseppe Esposito 34569c0bf11SEmanuele Giuseppe Esposito /* 34669c0bf11SEmanuele Giuseppe Esposito * Returns 1 if newly created images are guaranteed to contain only 34769c0bf11SEmanuele Giuseppe Esposito * zeros, 0 otherwise. 34869c0bf11SEmanuele Giuseppe Esposito */ 34969c0bf11SEmanuele Giuseppe Esposito int (*bdrv_has_zero_init)(BlockDriverState *bs); 35069c0bf11SEmanuele Giuseppe Esposito 35169c0bf11SEmanuele Giuseppe Esposito /* 35269c0bf11SEmanuele Giuseppe Esposito * Remove fd handlers, timers, and other event loop callbacks so the event 35369c0bf11SEmanuele Giuseppe Esposito * loop is no longer in use. Called with no in-flight requests and in 35469c0bf11SEmanuele Giuseppe Esposito * depth-first traversal order with parents before child nodes. 35569c0bf11SEmanuele Giuseppe Esposito */ 35669c0bf11SEmanuele Giuseppe Esposito void (*bdrv_detach_aio_context)(BlockDriverState *bs); 35769c0bf11SEmanuele Giuseppe Esposito 35869c0bf11SEmanuele Giuseppe Esposito /* 35969c0bf11SEmanuele Giuseppe Esposito * Add fd handlers, timers, and other event loop callbacks so I/O requests 36069c0bf11SEmanuele Giuseppe Esposito * can be processed again. Called with no in-flight requests and in 36169c0bf11SEmanuele Giuseppe Esposito * depth-first traversal order with child nodes before parent nodes. 36269c0bf11SEmanuele Giuseppe Esposito */ 36369c0bf11SEmanuele Giuseppe Esposito void (*bdrv_attach_aio_context)(BlockDriverState *bs, 36469c0bf11SEmanuele Giuseppe Esposito AioContext *new_context); 36569c0bf11SEmanuele Giuseppe Esposito 36669c0bf11SEmanuele Giuseppe Esposito /** 367ab613350SStefan Hajnoczi * bdrv_drain_begin is called if implemented in the beginning of a 368ab613350SStefan Hajnoczi * drain operation to drain and stop any internal sources of requests in 369ab613350SStefan Hajnoczi * the driver. 370ab613350SStefan Hajnoczi * bdrv_drain_end is called if implemented at the end of the drain. 371ab613350SStefan Hajnoczi * 372ab613350SStefan Hajnoczi * They should be used by the driver to e.g. manage scheduled I/O 373ab613350SStefan Hajnoczi * requests, or toggle an internal state. After the end of the drain new 374ab613350SStefan Hajnoczi * requests will continue normally. 375ab613350SStefan Hajnoczi * 376ab613350SStefan Hajnoczi * Implementations of both functions must not call aio_poll(). 377ab613350SStefan Hajnoczi */ 378ab613350SStefan Hajnoczi void (*bdrv_drain_begin)(BlockDriverState *bs); 379ab613350SStefan Hajnoczi void (*bdrv_drain_end)(BlockDriverState *bs); 380ab613350SStefan Hajnoczi 381ab613350SStefan Hajnoczi /** 38269c0bf11SEmanuele Giuseppe Esposito * Try to get @bs's logical and physical block size. 38369c0bf11SEmanuele Giuseppe Esposito * On success, store them in @bsz and return zero. 38469c0bf11SEmanuele Giuseppe Esposito * On failure, return negative errno. 38569c0bf11SEmanuele Giuseppe Esposito */ 38669c0bf11SEmanuele Giuseppe Esposito int (*bdrv_probe_blocksizes)(BlockDriverState *bs, BlockSizes *bsz); 38769c0bf11SEmanuele Giuseppe Esposito /** 38869c0bf11SEmanuele Giuseppe Esposito * Try to get @bs's geometry (cyls, heads, sectors) 38969c0bf11SEmanuele Giuseppe Esposito * On success, store them in @geo and return 0. 39069c0bf11SEmanuele Giuseppe Esposito * On failure return -errno. 39169c0bf11SEmanuele Giuseppe Esposito * Only drivers that want to override guest geometry implement this 39269c0bf11SEmanuele Giuseppe Esposito * callback; see hd_geometry_guess(). 39369c0bf11SEmanuele Giuseppe Esposito */ 39469c0bf11SEmanuele Giuseppe Esposito int (*bdrv_probe_geometry)(BlockDriverState *bs, HDGeometry *geo); 39569c0bf11SEmanuele Giuseppe Esposito 39669c0bf11SEmanuele Giuseppe Esposito void (*bdrv_add_child)(BlockDriverState *parent, BlockDriverState *child, 39769c0bf11SEmanuele Giuseppe Esposito Error **errp); 39869c0bf11SEmanuele Giuseppe Esposito void (*bdrv_del_child)(BlockDriverState *parent, BdrvChild *child, 39969c0bf11SEmanuele Giuseppe Esposito Error **errp); 40069c0bf11SEmanuele Giuseppe Esposito 40169c0bf11SEmanuele Giuseppe Esposito /** 40269c0bf11SEmanuele Giuseppe Esposito * Informs the block driver that a permission change is intended. The 40369c0bf11SEmanuele Giuseppe Esposito * driver checks whether the change is permissible and may take other 40469c0bf11SEmanuele Giuseppe Esposito * preparations for the change (e.g. get file system locks). This operation 40569c0bf11SEmanuele Giuseppe Esposito * is always followed either by a call to either .bdrv_set_perm or 40669c0bf11SEmanuele Giuseppe Esposito * .bdrv_abort_perm_update. 40769c0bf11SEmanuele Giuseppe Esposito * 40869c0bf11SEmanuele Giuseppe Esposito * Checks whether the requested set of cumulative permissions in @perm 40969c0bf11SEmanuele Giuseppe Esposito * can be granted for accessing @bs and whether no other users are using 41069c0bf11SEmanuele Giuseppe Esposito * permissions other than those given in @shared (both arguments take 41169c0bf11SEmanuele Giuseppe Esposito * BLK_PERM_* bitmasks). 41269c0bf11SEmanuele Giuseppe Esposito * 41369c0bf11SEmanuele Giuseppe Esposito * If both conditions are met, 0 is returned. Otherwise, -errno is returned 41469c0bf11SEmanuele Giuseppe Esposito * and errp is set to an error describing the conflict. 41569c0bf11SEmanuele Giuseppe Esposito */ 41669c0bf11SEmanuele Giuseppe Esposito int (*bdrv_check_perm)(BlockDriverState *bs, uint64_t perm, 41769c0bf11SEmanuele Giuseppe Esposito uint64_t shared, Error **errp); 41869c0bf11SEmanuele Giuseppe Esposito 41969c0bf11SEmanuele Giuseppe Esposito /** 42069c0bf11SEmanuele Giuseppe Esposito * Called to inform the driver that the set of cumulative set of used 421a1a62cedSMichael Tokarev * permissions for @bs has changed to @perm, and the set of shareable 42269c0bf11SEmanuele Giuseppe Esposito * permission to @shared. The driver can use this to propagate changes to 42369c0bf11SEmanuele Giuseppe Esposito * its children (i.e. request permissions only if a parent actually needs 42469c0bf11SEmanuele Giuseppe Esposito * them). 42569c0bf11SEmanuele Giuseppe Esposito * 42669c0bf11SEmanuele Giuseppe Esposito * This function is only invoked after bdrv_check_perm(), so block drivers 42769c0bf11SEmanuele Giuseppe Esposito * may rely on preparations made in their .bdrv_check_perm implementation. 42869c0bf11SEmanuele Giuseppe Esposito */ 42969c0bf11SEmanuele Giuseppe Esposito void (*bdrv_set_perm)(BlockDriverState *bs, uint64_t perm, uint64_t shared); 43069c0bf11SEmanuele Giuseppe Esposito 43169c0bf11SEmanuele Giuseppe Esposito /* 43269c0bf11SEmanuele Giuseppe Esposito * Called to inform the driver that after a previous bdrv_check_perm() 43369c0bf11SEmanuele Giuseppe Esposito * call, the permission update is not performed and any preparations made 43469c0bf11SEmanuele Giuseppe Esposito * for it (e.g. taken file locks) need to be undone. 43569c0bf11SEmanuele Giuseppe Esposito * 43669c0bf11SEmanuele Giuseppe Esposito * This function can be called even for nodes that never saw a 43769c0bf11SEmanuele Giuseppe Esposito * bdrv_check_perm() call. It is a no-op then. 43869c0bf11SEmanuele Giuseppe Esposito */ 43969c0bf11SEmanuele Giuseppe Esposito void (*bdrv_abort_perm_update)(BlockDriverState *bs); 44069c0bf11SEmanuele Giuseppe Esposito 44169c0bf11SEmanuele Giuseppe Esposito /** 44269c0bf11SEmanuele Giuseppe Esposito * Returns in @nperm and @nshared the permissions that the driver for @bs 44369c0bf11SEmanuele Giuseppe Esposito * needs on its child @c, based on the cumulative permissions requested by 44469c0bf11SEmanuele Giuseppe Esposito * the parents in @parent_perm and @parent_shared. 44569c0bf11SEmanuele Giuseppe Esposito * 44669c0bf11SEmanuele Giuseppe Esposito * If @c is NULL, return the permissions for attaching a new child for the 44769c0bf11SEmanuele Giuseppe Esposito * given @child_class and @role. 44869c0bf11SEmanuele Giuseppe Esposito * 44969c0bf11SEmanuele Giuseppe Esposito * If @reopen_queue is non-NULL, don't return the currently needed 45069c0bf11SEmanuele Giuseppe Esposito * permissions, but those that will be needed after applying the 45169c0bf11SEmanuele Giuseppe Esposito * @reopen_queue. 45269c0bf11SEmanuele Giuseppe Esposito */ 45369c0bf11SEmanuele Giuseppe Esposito void (*bdrv_child_perm)(BlockDriverState *bs, BdrvChild *c, 45469c0bf11SEmanuele Giuseppe Esposito BdrvChildRole role, 45569c0bf11SEmanuele Giuseppe Esposito BlockReopenQueue *reopen_queue, 45669c0bf11SEmanuele Giuseppe Esposito uint64_t parent_perm, uint64_t parent_shared, 45769c0bf11SEmanuele Giuseppe Esposito uint64_t *nperm, uint64_t *nshared); 45869c0bf11SEmanuele Giuseppe Esposito 45969c0bf11SEmanuele Giuseppe Esposito /** 46069c0bf11SEmanuele Giuseppe Esposito * Register/unregister a buffer for I/O. For example, when the driver is 46169c0bf11SEmanuele Giuseppe Esposito * interested to know the memory areas that will later be used in iovs, so 46269c0bf11SEmanuele Giuseppe Esposito * that it can do IOMMU mapping with VFIO etc., in order to get better 46369c0bf11SEmanuele Giuseppe Esposito * performance. In the case of VFIO drivers, this callback is used to do 46469c0bf11SEmanuele Giuseppe Esposito * DMA mapping for hot buffers. 465f4ec04baSStefan Hajnoczi * 466f4ec04baSStefan Hajnoczi * Returns: true on success, false on failure 46769c0bf11SEmanuele Giuseppe Esposito */ 468d9249c25SKevin Wolf bool GRAPH_RDLOCK_PTR (*bdrv_register_buf)( 469d9249c25SKevin Wolf BlockDriverState *bs, void *host, size_t size, Error **errp); 470d9249c25SKevin Wolf void GRAPH_RDLOCK_PTR (*bdrv_unregister_buf)( 471d9249c25SKevin Wolf BlockDriverState *bs, void *host, size_t size); 47269c0bf11SEmanuele Giuseppe Esposito 47369c0bf11SEmanuele Giuseppe Esposito /* 47469c0bf11SEmanuele Giuseppe Esposito * This field is modified only under the BQL, and is part of 47569c0bf11SEmanuele Giuseppe Esposito * the global state. 47669c0bf11SEmanuele Giuseppe Esposito */ 47769c0bf11SEmanuele Giuseppe Esposito QLIST_ENTRY(BlockDriver) list; 47869c0bf11SEmanuele Giuseppe Esposito 47969c0bf11SEmanuele Giuseppe Esposito /* 48069c0bf11SEmanuele Giuseppe Esposito * I/O API functions. These functions are thread-safe. 48169c0bf11SEmanuele Giuseppe Esposito * 48269c0bf11SEmanuele Giuseppe Esposito * See include/block/block-io.h for more information about 48369c0bf11SEmanuele Giuseppe Esposito * the I/O API. 48469c0bf11SEmanuele Giuseppe Esposito */ 48569c0bf11SEmanuele Giuseppe Esposito 48669c0bf11SEmanuele Giuseppe Esposito int (*bdrv_probe)(const uint8_t *buf, int buf_size, const char *filename); 48769c0bf11SEmanuele Giuseppe Esposito 488840428a2SEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_amend)( 489840428a2SEmanuele Giuseppe Esposito BlockDriverState *bs, BlockdevAmendOptions *opts, bool force, 49069c0bf11SEmanuele Giuseppe Esposito Error **errp); 49169c0bf11SEmanuele Giuseppe Esposito 492ebc2752bSEmanuele Giuseppe Esposito /* aio */ 4937b1fb72eSKevin Wolf BlockAIOCB * GRAPH_RDLOCK_PTR (*bdrv_aio_preadv)(BlockDriverState *bs, 494ebc2752bSEmanuele Giuseppe Esposito int64_t offset, int64_t bytes, QEMUIOVector *qiov, 495ebc2752bSEmanuele Giuseppe Esposito BdrvRequestFlags flags, BlockCompletionFunc *cb, void *opaque); 4967b1fb72eSKevin Wolf 4977b1fb72eSKevin Wolf BlockAIOCB * GRAPH_RDLOCK_PTR (*bdrv_aio_pwritev)(BlockDriverState *bs, 498ebc2752bSEmanuele Giuseppe Esposito int64_t offset, int64_t bytes, QEMUIOVector *qiov, 499ebc2752bSEmanuele Giuseppe Esposito BdrvRequestFlags flags, BlockCompletionFunc *cb, void *opaque); 5007b1fb72eSKevin Wolf 50188095349SEmanuele Giuseppe Esposito BlockAIOCB * GRAPH_RDLOCK_PTR (*bdrv_aio_flush)( 50288095349SEmanuele Giuseppe Esposito BlockDriverState *bs, BlockCompletionFunc *cb, void *opaque); 5039a5a1c62SEmanuele Giuseppe Esposito 5049a5a1c62SEmanuele Giuseppe Esposito BlockAIOCB * GRAPH_RDLOCK_PTR (*bdrv_aio_pdiscard)( 5059a5a1c62SEmanuele Giuseppe Esposito BlockDriverState *bs, int64_t offset, int bytes, 506ebc2752bSEmanuele Giuseppe Esposito BlockCompletionFunc *cb, void *opaque); 507ebc2752bSEmanuele Giuseppe Esposito 5087b1fb72eSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_readv)(BlockDriverState *bs, 509ebc2752bSEmanuele Giuseppe Esposito int64_t sector_num, int nb_sectors, QEMUIOVector *qiov); 510ebc2752bSEmanuele Giuseppe Esposito 511ebc2752bSEmanuele Giuseppe Esposito /** 512ebc2752bSEmanuele Giuseppe Esposito * @offset: position in bytes to read at 513ebc2752bSEmanuele Giuseppe Esposito * @bytes: number of bytes to read 514ebc2752bSEmanuele Giuseppe Esposito * @qiov: the buffers to fill with read data 515ebc2752bSEmanuele Giuseppe Esposito * @flags: currently unused, always 0 516ebc2752bSEmanuele Giuseppe Esposito * 517ebc2752bSEmanuele Giuseppe Esposito * @offset and @bytes will be a multiple of 'request_alignment', 518ebc2752bSEmanuele Giuseppe Esposito * but the length of individual @qiov elements does not have to 519ebc2752bSEmanuele Giuseppe Esposito * be a multiple. 520ebc2752bSEmanuele Giuseppe Esposito * 521ebc2752bSEmanuele Giuseppe Esposito * @bytes will always equal the total size of @qiov, and will be 522ebc2752bSEmanuele Giuseppe Esposito * no larger than 'max_transfer'. 523ebc2752bSEmanuele Giuseppe Esposito * 524ebc2752bSEmanuele Giuseppe Esposito * The buffer in @qiov may point directly to guest memory. 525ebc2752bSEmanuele Giuseppe Esposito */ 5267b1fb72eSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_preadv)(BlockDriverState *bs, 527ebc2752bSEmanuele Giuseppe Esposito int64_t offset, int64_t bytes, QEMUIOVector *qiov, 528ebc2752bSEmanuele Giuseppe Esposito BdrvRequestFlags flags); 529ebc2752bSEmanuele Giuseppe Esposito 5307b1fb72eSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_preadv_part)( 5317b1fb72eSKevin Wolf BlockDriverState *bs, int64_t offset, int64_t bytes, 532ebc2752bSEmanuele Giuseppe Esposito QEMUIOVector *qiov, size_t qiov_offset, 533ebc2752bSEmanuele Giuseppe Esposito BdrvRequestFlags flags); 534ebc2752bSEmanuele Giuseppe Esposito 5357b1fb72eSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_writev)(BlockDriverState *bs, 536ebc2752bSEmanuele Giuseppe Esposito int64_t sector_num, int nb_sectors, QEMUIOVector *qiov, 537ebc2752bSEmanuele Giuseppe Esposito int flags); 538ebc2752bSEmanuele Giuseppe Esposito /** 539ebc2752bSEmanuele Giuseppe Esposito * @offset: position in bytes to write at 540ebc2752bSEmanuele Giuseppe Esposito * @bytes: number of bytes to write 541ebc2752bSEmanuele Giuseppe Esposito * @qiov: the buffers containing data to write 542ebc2752bSEmanuele Giuseppe Esposito * @flags: zero or more bits allowed by 'supported_write_flags' 543ebc2752bSEmanuele Giuseppe Esposito * 544ebc2752bSEmanuele Giuseppe Esposito * @offset and @bytes will be a multiple of 'request_alignment', 545ebc2752bSEmanuele Giuseppe Esposito * but the length of individual @qiov elements does not have to 546ebc2752bSEmanuele Giuseppe Esposito * be a multiple. 547ebc2752bSEmanuele Giuseppe Esposito * 548ebc2752bSEmanuele Giuseppe Esposito * @bytes will always equal the total size of @qiov, and will be 549ebc2752bSEmanuele Giuseppe Esposito * no larger than 'max_transfer'. 550ebc2752bSEmanuele Giuseppe Esposito * 551ebc2752bSEmanuele Giuseppe Esposito * The buffer in @qiov may point directly to guest memory. 552ebc2752bSEmanuele Giuseppe Esposito */ 5537b1fb72eSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_pwritev)( 5547b1fb72eSKevin Wolf BlockDriverState *bs, int64_t offset, int64_t bytes, QEMUIOVector *qiov, 555ebc2752bSEmanuele Giuseppe Esposito BdrvRequestFlags flags); 5567b1fb72eSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_pwritev_part)( 5577b1fb72eSKevin Wolf BlockDriverState *bs, int64_t offset, int64_t bytes, QEMUIOVector *qiov, 5587b1fb72eSKevin Wolf size_t qiov_offset, BdrvRequestFlags flags); 559ebc2752bSEmanuele Giuseppe Esposito 560ebc2752bSEmanuele Giuseppe Esposito /* 561ebc2752bSEmanuele Giuseppe Esposito * Efficiently zero a region of the disk image. Typically an image format 562ebc2752bSEmanuele Giuseppe Esposito * would use a compact metadata representation to implement this. This 563ebc2752bSEmanuele Giuseppe Esposito * function pointer may be NULL or return -ENOSUP and .bdrv_co_writev() 564ebc2752bSEmanuele Giuseppe Esposito * will be called instead. 565ebc2752bSEmanuele Giuseppe Esposito */ 566abaf8b75SKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_pwrite_zeroes)( 567abaf8b75SKevin Wolf BlockDriverState *bs, int64_t offset, int64_t bytes, 568abaf8b75SKevin Wolf BdrvRequestFlags flags); 5699a5a1c62SEmanuele Giuseppe Esposito 5709a5a1c62SEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_pdiscard)( 5719a5a1c62SEmanuele Giuseppe Esposito BlockDriverState *bs, int64_t offset, int64_t bytes); 572ebc2752bSEmanuele Giuseppe Esposito 573ebc2752bSEmanuele Giuseppe Esposito /* 574ebc2752bSEmanuele Giuseppe Esposito * Map [offset, offset + nbytes) range onto a child of @bs to copy from, 575ebc2752bSEmanuele Giuseppe Esposito * and invoke bdrv_co_copy_range_from(child, ...), or invoke 576ebc2752bSEmanuele Giuseppe Esposito * bdrv_co_copy_range_to() if @bs is the leaf child to copy data from. 577ebc2752bSEmanuele Giuseppe Esposito * 578ebc2752bSEmanuele Giuseppe Esposito * See the comment of bdrv_co_copy_range for the parameter and return value 579ebc2752bSEmanuele Giuseppe Esposito * semantics. 580ebc2752bSEmanuele Giuseppe Esposito */ 581742bf09bSEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_copy_range_from)( 582742bf09bSEmanuele Giuseppe Esposito BlockDriverState *bs, BdrvChild *src, int64_t offset, 583742bf09bSEmanuele Giuseppe Esposito BdrvChild *dst, int64_t dst_offset, int64_t bytes, 584742bf09bSEmanuele Giuseppe Esposito BdrvRequestFlags read_flags, BdrvRequestFlags write_flags); 585ebc2752bSEmanuele Giuseppe Esposito 586ebc2752bSEmanuele Giuseppe Esposito /* 587ebc2752bSEmanuele Giuseppe Esposito * Map [offset, offset + nbytes) range onto a child of bs to copy data to, 588ebc2752bSEmanuele Giuseppe Esposito * and invoke bdrv_co_copy_range_to(child, src, ...), or perform the copy 589ebc2752bSEmanuele Giuseppe Esposito * operation if @bs is the leaf and @src has the same BlockDriver. Return 590ebc2752bSEmanuele Giuseppe Esposito * -ENOTSUP if @bs is the leaf but @src has a different BlockDriver. 591ebc2752bSEmanuele Giuseppe Esposito * 592ebc2752bSEmanuele Giuseppe Esposito * See the comment of bdrv_co_copy_range for the parameter and return value 593ebc2752bSEmanuele Giuseppe Esposito * semantics. 594ebc2752bSEmanuele Giuseppe Esposito */ 595742bf09bSEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_copy_range_to)( 596742bf09bSEmanuele Giuseppe Esposito BlockDriverState *bs, BdrvChild *src, int64_t src_offset, 597742bf09bSEmanuele Giuseppe Esposito BdrvChild *dst, int64_t dst_offset, int64_t bytes, 598742bf09bSEmanuele Giuseppe Esposito BdrvRequestFlags read_flags, BdrvRequestFlags write_flags); 599ebc2752bSEmanuele Giuseppe Esposito 600ebc2752bSEmanuele Giuseppe Esposito /* 601ebc2752bSEmanuele Giuseppe Esposito * Building block for bdrv_block_status[_above] and 602ebc2752bSEmanuele Giuseppe Esposito * bdrv_is_allocated[_above]. The driver should answer only 603ebc2752bSEmanuele Giuseppe Esposito * according to the current layer, and should only need to set 604ebc2752bSEmanuele Giuseppe Esposito * BDRV_BLOCK_DATA, BDRV_BLOCK_ZERO, BDRV_BLOCK_OFFSET_VALID, 605ebc2752bSEmanuele Giuseppe Esposito * and/or BDRV_BLOCK_RAW; if the current layer defers to a backing 606ebc2752bSEmanuele Giuseppe Esposito * layer, the result should be 0 (and not BDRV_BLOCK_ZERO). See 607ebc2752bSEmanuele Giuseppe Esposito * block.h for the overall meaning of the bits. As a hint, the 608ebc2752bSEmanuele Giuseppe Esposito * flag want_zero is true if the caller cares more about precise 609ebc2752bSEmanuele Giuseppe Esposito * mappings (favor accurate _OFFSET_VALID/_ZERO) or false for 610ebc2752bSEmanuele Giuseppe Esposito * overall allocation (favor larger *pnum, perhaps by reporting 611ebc2752bSEmanuele Giuseppe Esposito * _DATA instead of _ZERO). The block layer guarantees input 612ebc2752bSEmanuele Giuseppe Esposito * clamped to bdrv_getlength() and aligned to request_alignment, 613ebc2752bSEmanuele Giuseppe Esposito * as well as non-NULL pnum, map, and file; in turn, the driver 614ebc2752bSEmanuele Giuseppe Esposito * must return an error or set pnum to an aligned non-zero value. 615ebc2752bSEmanuele Giuseppe Esposito * 616ebc2752bSEmanuele Giuseppe Esposito * Note that @bytes is just a hint on how big of a region the 617ebc2752bSEmanuele Giuseppe Esposito * caller wants to inspect. It is not a limit on *pnum. 618ebc2752bSEmanuele Giuseppe Esposito * Implementations are free to return larger values of *pnum if 619ebc2752bSEmanuele Giuseppe Esposito * doing so does not incur a performance penalty. 620ebc2752bSEmanuele Giuseppe Esposito * 621ebc2752bSEmanuele Giuseppe Esposito * block/io.c's bdrv_co_block_status() will utilize an unclamped 622ebc2752bSEmanuele Giuseppe Esposito * *pnum value for the block-status cache on protocol nodes, prior 623ebc2752bSEmanuele Giuseppe Esposito * to clamping *pnum for return to its caller. 624ebc2752bSEmanuele Giuseppe Esposito */ 6257ff9579eSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_block_status)( 6267ff9579eSKevin Wolf BlockDriverState *bs, 627ebc2752bSEmanuele Giuseppe Esposito bool want_zero, int64_t offset, int64_t bytes, int64_t *pnum, 628ebc2752bSEmanuele Giuseppe Esposito int64_t *map, BlockDriverState **file); 629ebc2752bSEmanuele Giuseppe Esposito 630ebc2752bSEmanuele Giuseppe Esposito /* 631ce14f3b4SVladimir Sementsov-Ogievskiy * Snapshot-access API. 632ce14f3b4SVladimir Sementsov-Ogievskiy * 633ce14f3b4SVladimir Sementsov-Ogievskiy * Block-driver may provide snapshot-access API: special functions to access 634ce14f3b4SVladimir Sementsov-Ogievskiy * some internal "snapshot". The functions are similar with normal 635ce14f3b4SVladimir Sementsov-Ogievskiy * read/block_status/discard handler, but don't have any specific handling 636ce14f3b4SVladimir Sementsov-Ogievskiy * in generic block-layer: no serializing, no alignment, no tracked 637ce14f3b4SVladimir Sementsov-Ogievskiy * requests. So, block-driver that realizes these APIs is fully responsible 638ce14f3b4SVladimir Sementsov-Ogievskiy * for synchronization between snapshot-access API and normal IO requests. 6391c14eaabSVladimir Sementsov-Ogievskiy * 6401c14eaabSVladimir Sementsov-Ogievskiy * TODO: To be able to support qcow2's internal snapshots, this API will 6411c14eaabSVladimir Sementsov-Ogievskiy * need to be extended to: 6421c14eaabSVladimir Sementsov-Ogievskiy * - be able to select a specific snapshot 6431c14eaabSVladimir Sementsov-Ogievskiy * - receive the snapshot's actual length (which may differ from bs's 6441c14eaabSVladimir Sementsov-Ogievskiy * length) 645ce14f3b4SVladimir Sementsov-Ogievskiy */ 6467b9e8b22SKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_preadv_snapshot)( 6477b9e8b22SKevin Wolf BlockDriverState *bs, int64_t offset, int64_t bytes, 6487b9e8b22SKevin Wolf QEMUIOVector *qiov, size_t qiov_offset); 6497b9e8b22SKevin Wolf 6507b9e8b22SKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_snapshot_block_status)( 6517b9e8b22SKevin Wolf BlockDriverState *bs, bool want_zero, int64_t offset, int64_t bytes, 6527b9e8b22SKevin Wolf int64_t *pnum, int64_t *map, BlockDriverState **file); 6539a5a1c62SEmanuele Giuseppe Esposito 6549a5a1c62SEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_pdiscard_snapshot)( 6559a5a1c62SEmanuele Giuseppe Esposito BlockDriverState *bs, int64_t offset, int64_t bytes); 656ce14f3b4SVladimir Sementsov-Ogievskiy 657ce14f3b4SVladimir Sementsov-Ogievskiy /* 658ebc2752bSEmanuele Giuseppe Esposito * Invalidate any cached meta-data. 659ebc2752bSEmanuele Giuseppe Esposito */ 6601b3ff9feSKevin Wolf void coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_invalidate_cache)( 6611b3ff9feSKevin Wolf BlockDriverState *bs, Error **errp); 662ebc2752bSEmanuele Giuseppe Esposito 663ebc2752bSEmanuele Giuseppe Esposito /* 664ebc2752bSEmanuele Giuseppe Esposito * Flushes all data for all layers by calling bdrv_co_flush for underlying 665ebc2752bSEmanuele Giuseppe Esposito * layers, if needed. This function is needed for deterministic 666ebc2752bSEmanuele Giuseppe Esposito * synchronization of the flush finishing callback. 667ebc2752bSEmanuele Giuseppe Esposito */ 66888095349SEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_flush)(BlockDriverState *bs); 669ebc2752bSEmanuele Giuseppe Esposito 670ebc2752bSEmanuele Giuseppe Esposito /* Delete a created file. */ 67148aef794SKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_delete_file)( 67248aef794SKevin Wolf BlockDriverState *bs, Error **errp); 673ebc2752bSEmanuele Giuseppe Esposito 674ebc2752bSEmanuele Giuseppe Esposito /* 675ebc2752bSEmanuele Giuseppe Esposito * Flushes all data that was already written to the OS all the way down to 676ebc2752bSEmanuele Giuseppe Esposito * the disk (for example file-posix.c calls fsync()). 677ebc2752bSEmanuele Giuseppe Esposito */ 67888095349SEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_flush_to_disk)( 67988095349SEmanuele Giuseppe Esposito BlockDriverState *bs); 680ebc2752bSEmanuele Giuseppe Esposito 681ebc2752bSEmanuele Giuseppe Esposito /* 682ebc2752bSEmanuele Giuseppe Esposito * Flushes all internal caches to the OS. The data may still sit in a 683ebc2752bSEmanuele Giuseppe Esposito * writeback cache of the host OS, but it will survive a crash of the qemu 684ebc2752bSEmanuele Giuseppe Esposito * process. 685ebc2752bSEmanuele Giuseppe Esposito */ 68688095349SEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_flush_to_os)( 68788095349SEmanuele Giuseppe Esposito BlockDriverState *bs); 688ebc2752bSEmanuele Giuseppe Esposito 689ebc2752bSEmanuele Giuseppe Esposito /* 690ebc2752bSEmanuele Giuseppe Esposito * Truncate @bs to @offset bytes using the given @prealloc mode 691ebc2752bSEmanuele Giuseppe Esposito * when growing. Modes other than PREALLOC_MODE_OFF should be 692ebc2752bSEmanuele Giuseppe Esposito * rejected when shrinking @bs. 693ebc2752bSEmanuele Giuseppe Esposito * 694ebc2752bSEmanuele Giuseppe Esposito * If @exact is true, @bs must be resized to exactly @offset. 695ebc2752bSEmanuele Giuseppe Esposito * Otherwise, it is sufficient for @bs (if it is a host block 696ebc2752bSEmanuele Giuseppe Esposito * device and thus there is no way to resize it) to be at least 697ebc2752bSEmanuele Giuseppe Esposito * @offset bytes in length. 698ebc2752bSEmanuele Giuseppe Esposito * 699ebc2752bSEmanuele Giuseppe Esposito * If @exact is true and this function fails but would succeed 700ebc2752bSEmanuele Giuseppe Esposito * with @exact = false, it should return -ENOTSUP. 701ebc2752bSEmanuele Giuseppe Esposito */ 702c2b8e315SKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_truncate)( 703c2b8e315SKevin Wolf BlockDriverState *bs, int64_t offset, bool exact, 704c2b8e315SKevin Wolf PreallocMode prealloc, BdrvRequestFlags flags, Error **errp); 705c2b8e315SKevin Wolf 7068ab8140aSKevin Wolf int64_t coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_getlength)( 7078ab8140aSKevin Wolf BlockDriverState *bs); 7088ab8140aSKevin Wolf 709de335638SEmanuele Giuseppe Esposito int64_t coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_get_allocated_file_size)( 71082618d7bSEmanuele Giuseppe Esposito BlockDriverState *bs); 71182618d7bSEmanuele Giuseppe Esposito 712ebc2752bSEmanuele Giuseppe Esposito BlockMeasureInfo *(*bdrv_measure)(QemuOpts *opts, BlockDriverState *in_bs, 713ebc2752bSEmanuele Giuseppe Esposito Error **errp); 714ebc2752bSEmanuele Giuseppe Esposito 7157b1fb72eSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_pwritev_compressed)( 7167b1fb72eSKevin Wolf BlockDriverState *bs, int64_t offset, int64_t bytes, 7177b1fb72eSKevin Wolf QEMUIOVector *qiov); 7187b1fb72eSKevin Wolf 7197b1fb72eSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_pwritev_compressed_part)( 7207b1fb72eSKevin Wolf BlockDriverState *bs, int64_t offset, int64_t bytes, 7217b1fb72eSKevin Wolf QEMUIOVector *qiov, size_t qiov_offset); 722ebc2752bSEmanuele Giuseppe Esposito 723a00e70c0SEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_get_info)( 724a00e70c0SEmanuele Giuseppe Esposito BlockDriverState *bs, BlockDriverInfo *bdi); 725ebc2752bSEmanuele Giuseppe Esposito 726ebc2752bSEmanuele Giuseppe Esposito ImageInfoSpecific *(*bdrv_get_specific_info)(BlockDriverState *bs, 727ebc2752bSEmanuele Giuseppe Esposito Error **errp); 728ebc2752bSEmanuele Giuseppe Esposito BlockStatsSpecific *(*bdrv_get_specific_stats)(BlockDriverState *bs); 729ebc2752bSEmanuele Giuseppe Esposito 730ca5e2ad9SEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_save_vmstate)( 7311b3ff9feSKevin Wolf BlockDriverState *bs, QEMUIOVector *qiov, int64_t pos); 7321b3ff9feSKevin Wolf 733ca5e2ad9SEmanuele Giuseppe Esposito int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_load_vmstate)( 7341b3ff9feSKevin Wolf BlockDriverState *bs, QEMUIOVector *qiov, int64_t pos); 735ebc2752bSEmanuele Giuseppe Esposito 7366d43eaa3SSam Li int coroutine_fn (*bdrv_co_zone_report)(BlockDriverState *bs, 7376d43eaa3SSam Li int64_t offset, unsigned int *nr_zones, 7386d43eaa3SSam Li BlockZoneDescriptor *zones); 7396d43eaa3SSam Li int coroutine_fn (*bdrv_co_zone_mgmt)(BlockDriverState *bs, BlockZoneOp op, 7406d43eaa3SSam Li int64_t offset, int64_t len); 7414751d09aSSam Li int coroutine_fn (*bdrv_co_zone_append)(BlockDriverState *bs, 7424751d09aSSam Li int64_t *offset, QEMUIOVector *qiov, 7434751d09aSSam Li BdrvRequestFlags flags); 7446d43eaa3SSam Li 745ebc2752bSEmanuele Giuseppe Esposito /* removable device specific */ 746c73ff92cSEmanuele Giuseppe Esposito bool coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_is_inserted)( 747c73ff92cSEmanuele Giuseppe Esposito BlockDriverState *bs); 74879a292e5SKevin Wolf void coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_eject)( 74979a292e5SKevin Wolf BlockDriverState *bs, bool eject_flag); 75079a292e5SKevin Wolf void coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_lock_medium)( 75179a292e5SKevin Wolf BlockDriverState *bs, bool locked); 752ebc2752bSEmanuele Giuseppe Esposito 753ebc2752bSEmanuele Giuseppe Esposito /* to control generic scsi devices */ 75426c518abSKevin Wolf BlockAIOCB *coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_aio_ioctl)( 75526c518abSKevin Wolf BlockDriverState *bs, unsigned long int req, void *buf, 756ebc2752bSEmanuele Giuseppe Esposito BlockCompletionFunc *cb, void *opaque); 75726c518abSKevin Wolf 75826c518abSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_ioctl)( 75926c518abSKevin Wolf BlockDriverState *bs, unsigned long int req, void *buf); 760ebc2752bSEmanuele Giuseppe Esposito 761ebc2752bSEmanuele Giuseppe Esposito /* 762ebc2752bSEmanuele Giuseppe Esposito * Returns 0 for completed check, -errno for internal errors. 763ebc2752bSEmanuele Giuseppe Esposito * The check results are stored in result. 764ebc2752bSEmanuele Giuseppe Esposito */ 7651b3ff9feSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_check)( 7661b3ff9feSKevin Wolf BlockDriverState *bs, BdrvCheckResult *result, BdrvCheckMode fix); 767ebc2752bSEmanuele Giuseppe Esposito 768cb2bfaa4SEmanuele Giuseppe Esposito void coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_debug_event)( 769cb2bfaa4SEmanuele Giuseppe Esposito BlockDriverState *bs, BlkdebugEvent event); 770ebc2752bSEmanuele Giuseppe Esposito 771ebc2752bSEmanuele Giuseppe Esposito bool (*bdrv_supports_persistent_dirty_bitmap)(BlockDriverState *bs); 772167f748dSKevin Wolf 773167f748dSKevin Wolf bool coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_can_store_new_dirty_bitmap)( 774c2d76808SAlberto Faria BlockDriverState *bs, const char *name, uint32_t granularity, 775ebc2752bSEmanuele Giuseppe Esposito Error **errp); 776167f748dSKevin Wolf 777167f748dSKevin Wolf int coroutine_fn GRAPH_RDLOCK_PTR (*bdrv_co_remove_persistent_dirty_bitmap)( 778c2d76808SAlberto Faria BlockDriverState *bs, const char *name, Error **errp); 779ebc2752bSEmanuele Giuseppe Esposito }; 780ebc2752bSEmanuele Giuseppe Esposito 7817b1fb72eSKevin Wolf static inline bool TSA_NO_TSA block_driver_can_compress(BlockDriver *drv) 782ebc2752bSEmanuele Giuseppe Esposito { 783ebc2752bSEmanuele Giuseppe Esposito return drv->bdrv_co_pwritev_compressed || 784ebc2752bSEmanuele Giuseppe Esposito drv->bdrv_co_pwritev_compressed_part; 785ebc2752bSEmanuele Giuseppe Esposito } 786ebc2752bSEmanuele Giuseppe Esposito 787ebc2752bSEmanuele Giuseppe Esposito typedef struct BlockLimits { 788ebc2752bSEmanuele Giuseppe Esposito /* 789ebc2752bSEmanuele Giuseppe Esposito * Alignment requirement, in bytes, for offset/length of I/O 790ebc2752bSEmanuele Giuseppe Esposito * requests. Must be a power of 2 less than INT_MAX; defaults to 791ebc2752bSEmanuele Giuseppe Esposito * 1 for drivers with modern byte interfaces, and to 512 792ebc2752bSEmanuele Giuseppe Esposito * otherwise. 793ebc2752bSEmanuele Giuseppe Esposito */ 794ebc2752bSEmanuele Giuseppe Esposito uint32_t request_alignment; 795ebc2752bSEmanuele Giuseppe Esposito 796ebc2752bSEmanuele Giuseppe Esposito /* 797ebc2752bSEmanuele Giuseppe Esposito * Maximum number of bytes that can be discarded at once. Must be multiple 798ebc2752bSEmanuele Giuseppe Esposito * of pdiscard_alignment, but need not be power of 2. May be 0 if no 799ebc2752bSEmanuele Giuseppe Esposito * inherent 64-bit limit. 800ebc2752bSEmanuele Giuseppe Esposito */ 801ebc2752bSEmanuele Giuseppe Esposito int64_t max_pdiscard; 802ebc2752bSEmanuele Giuseppe Esposito 803ebc2752bSEmanuele Giuseppe Esposito /* 804ebc2752bSEmanuele Giuseppe Esposito * Optimal alignment for discard requests in bytes. A power of 2 805ebc2752bSEmanuele Giuseppe Esposito * is best but not mandatory. Must be a multiple of 806ebc2752bSEmanuele Giuseppe Esposito * bl.request_alignment, and must be less than max_pdiscard if 807ebc2752bSEmanuele Giuseppe Esposito * that is set. May be 0 if bl.request_alignment is good enough 808ebc2752bSEmanuele Giuseppe Esposito */ 809ebc2752bSEmanuele Giuseppe Esposito uint32_t pdiscard_alignment; 810ebc2752bSEmanuele Giuseppe Esposito 811ebc2752bSEmanuele Giuseppe Esposito /* 812ebc2752bSEmanuele Giuseppe Esposito * Maximum number of bytes that can zeroized at once. Must be multiple of 813ebc2752bSEmanuele Giuseppe Esposito * pwrite_zeroes_alignment. 0 means no limit. 814ebc2752bSEmanuele Giuseppe Esposito */ 815ebc2752bSEmanuele Giuseppe Esposito int64_t max_pwrite_zeroes; 816ebc2752bSEmanuele Giuseppe Esposito 817ebc2752bSEmanuele Giuseppe Esposito /* 818ebc2752bSEmanuele Giuseppe Esposito * Optimal alignment for write zeroes requests in bytes. A power 819ebc2752bSEmanuele Giuseppe Esposito * of 2 is best but not mandatory. Must be a multiple of 820ebc2752bSEmanuele Giuseppe Esposito * bl.request_alignment, and must be less than max_pwrite_zeroes 821ebc2752bSEmanuele Giuseppe Esposito * if that is set. May be 0 if bl.request_alignment is good 822ebc2752bSEmanuele Giuseppe Esposito * enough 823ebc2752bSEmanuele Giuseppe Esposito */ 824ebc2752bSEmanuele Giuseppe Esposito uint32_t pwrite_zeroes_alignment; 825ebc2752bSEmanuele Giuseppe Esposito 826ebc2752bSEmanuele Giuseppe Esposito /* 827ebc2752bSEmanuele Giuseppe Esposito * Optimal transfer length in bytes. A power of 2 is best but not 828ebc2752bSEmanuele Giuseppe Esposito * mandatory. Must be a multiple of bl.request_alignment, or 0 if 829ebc2752bSEmanuele Giuseppe Esposito * no preferred size 830ebc2752bSEmanuele Giuseppe Esposito */ 831ebc2752bSEmanuele Giuseppe Esposito uint32_t opt_transfer; 832ebc2752bSEmanuele Giuseppe Esposito 833ebc2752bSEmanuele Giuseppe Esposito /* 834ebc2752bSEmanuele Giuseppe Esposito * Maximal transfer length in bytes. Need not be power of 2, but 835ebc2752bSEmanuele Giuseppe Esposito * must be multiple of opt_transfer and bl.request_alignment, or 0 836ebc2752bSEmanuele Giuseppe Esposito * for no 32-bit limit. For now, anything larger than INT_MAX is 837ebc2752bSEmanuele Giuseppe Esposito * clamped down. 838ebc2752bSEmanuele Giuseppe Esposito */ 839ebc2752bSEmanuele Giuseppe Esposito uint32_t max_transfer; 840ebc2752bSEmanuele Giuseppe Esposito 841ebc2752bSEmanuele Giuseppe Esposito /* 842ebc2752bSEmanuele Giuseppe Esposito * Maximal hardware transfer length in bytes. Applies whenever 843ebc2752bSEmanuele Giuseppe Esposito * transfers to the device bypass the kernel I/O scheduler, for 844ebc2752bSEmanuele Giuseppe Esposito * example with SG_IO. If larger than max_transfer or if zero, 845ebc2752bSEmanuele Giuseppe Esposito * blk_get_max_hw_transfer will fall back to max_transfer. 846ebc2752bSEmanuele Giuseppe Esposito */ 847ebc2752bSEmanuele Giuseppe Esposito uint64_t max_hw_transfer; 848ebc2752bSEmanuele Giuseppe Esposito 849ebc2752bSEmanuele Giuseppe Esposito /* 850ebc2752bSEmanuele Giuseppe Esposito * Maximal number of scatter/gather elements allowed by the hardware. 851ebc2752bSEmanuele Giuseppe Esposito * Applies whenever transfers to the device bypass the kernel I/O 852ebc2752bSEmanuele Giuseppe Esposito * scheduler, for example with SG_IO. If larger than max_iov 853ebc2752bSEmanuele Giuseppe Esposito * or if zero, blk_get_max_hw_iov will fall back to max_iov. 854ebc2752bSEmanuele Giuseppe Esposito */ 855ebc2752bSEmanuele Giuseppe Esposito int max_hw_iov; 856ebc2752bSEmanuele Giuseppe Esposito 857ebc2752bSEmanuele Giuseppe Esposito 858ebc2752bSEmanuele Giuseppe Esposito /* memory alignment, in bytes so that no bounce buffer is needed */ 859ebc2752bSEmanuele Giuseppe Esposito size_t min_mem_alignment; 860ebc2752bSEmanuele Giuseppe Esposito 861ebc2752bSEmanuele Giuseppe Esposito /* memory alignment, in bytes, for bounce buffer */ 862ebc2752bSEmanuele Giuseppe Esposito size_t opt_mem_alignment; 863ebc2752bSEmanuele Giuseppe Esposito 864ebc2752bSEmanuele Giuseppe Esposito /* maximum number of iovec elements */ 865ebc2752bSEmanuele Giuseppe Esposito int max_iov; 866160a29e2SPaolo Bonzini 867160a29e2SPaolo Bonzini /* 868160a29e2SPaolo Bonzini * true if the length of the underlying file can change, and QEMU 869160a29e2SPaolo Bonzini * is expected to adjust automatically. Mostly for CD-ROM drives, 870160a29e2SPaolo Bonzini * whose length is zero when the tray is empty (they don't need 871160a29e2SPaolo Bonzini * an explicit monitor command to load the disk inside the guest). 872160a29e2SPaolo Bonzini */ 873160a29e2SPaolo Bonzini bool has_variable_length; 874a735b56eSSam Li 875a735b56eSSam Li /* device zone model */ 876a735b56eSSam Li BlockZoneModel zoned; 8776d43eaa3SSam Li 8786d43eaa3SSam Li /* zone size expressed in bytes */ 8796d43eaa3SSam Li uint32_t zone_size; 8806d43eaa3SSam Li 8816d43eaa3SSam Li /* total number of zones */ 8826d43eaa3SSam Li uint32_t nr_zones; 8836d43eaa3SSam Li 8846d43eaa3SSam Li /* maximum sectors of a zone append write operation */ 8856d43eaa3SSam Li uint32_t max_append_sectors; 8866d43eaa3SSam Li 8876d43eaa3SSam Li /* maximum number of open zones */ 8886d43eaa3SSam Li uint32_t max_open_zones; 8896d43eaa3SSam Li 8906d43eaa3SSam Li /* maximum number of active zones */ 8916d43eaa3SSam Li uint32_t max_active_zones; 892a3c41f06SSam Li 893a3c41f06SSam Li uint32_t write_granularity; 894ebc2752bSEmanuele Giuseppe Esposito } BlockLimits; 895ebc2752bSEmanuele Giuseppe Esposito 896ebc2752bSEmanuele Giuseppe Esposito typedef struct BdrvOpBlocker BdrvOpBlocker; 897ebc2752bSEmanuele Giuseppe Esposito 898ebc2752bSEmanuele Giuseppe Esposito typedef struct BdrvAioNotifier { 899ebc2752bSEmanuele Giuseppe Esposito void (*attached_aio_context)(AioContext *new_context, void *opaque); 900ebc2752bSEmanuele Giuseppe Esposito void (*detach_aio_context)(void *opaque); 901ebc2752bSEmanuele Giuseppe Esposito 902ebc2752bSEmanuele Giuseppe Esposito void *opaque; 903ebc2752bSEmanuele Giuseppe Esposito bool deleted; 904ebc2752bSEmanuele Giuseppe Esposito 905ebc2752bSEmanuele Giuseppe Esposito QLIST_ENTRY(BdrvAioNotifier) list; 906ebc2752bSEmanuele Giuseppe Esposito } BdrvAioNotifier; 907ebc2752bSEmanuele Giuseppe Esposito 908ebc2752bSEmanuele Giuseppe Esposito struct BdrvChildClass { 909ebc2752bSEmanuele Giuseppe Esposito /* 910ebc2752bSEmanuele Giuseppe Esposito * If true, bdrv_replace_node() doesn't change the node this BdrvChild 911ebc2752bSEmanuele Giuseppe Esposito * points to. 912ebc2752bSEmanuele Giuseppe Esposito */ 913ebc2752bSEmanuele Giuseppe Esposito bool stay_at_node; 914ebc2752bSEmanuele Giuseppe Esposito 915ebc2752bSEmanuele Giuseppe Esposito /* 916ebc2752bSEmanuele Giuseppe Esposito * If true, the parent is a BlockDriverState and bdrv_next_all_states() 917ebc2752bSEmanuele Giuseppe Esposito * will return it. This information is used for drain_all, where every node 918ebc2752bSEmanuele Giuseppe Esposito * will be drained separately, so the drain only needs to be propagated to 919ebc2752bSEmanuele Giuseppe Esposito * non-BDS parents. 920ebc2752bSEmanuele Giuseppe Esposito */ 921ebc2752bSEmanuele Giuseppe Esposito bool parent_is_bds; 922ebc2752bSEmanuele Giuseppe Esposito 923abc5a79cSEmanuele Giuseppe Esposito /* 924abc5a79cSEmanuele Giuseppe Esposito * Global state (GS) API. These functions run under the BQL. 925abc5a79cSEmanuele Giuseppe Esposito * 926abc5a79cSEmanuele Giuseppe Esposito * See include/block/block-global-state.h for more information about 927abc5a79cSEmanuele Giuseppe Esposito * the GS API. 928abc5a79cSEmanuele Giuseppe Esposito */ 929ebc2752bSEmanuele Giuseppe Esposito void (*inherit_options)(BdrvChildRole role, bool parent_is_format, 930ebc2752bSEmanuele Giuseppe Esposito int *child_flags, QDict *child_options, 931ebc2752bSEmanuele Giuseppe Esposito int parent_flags, QDict *parent_options); 932ebc2752bSEmanuele Giuseppe Esposito void (*change_media)(BdrvChild *child, bool load); 933ebc2752bSEmanuele Giuseppe Esposito 934ebc2752bSEmanuele Giuseppe Esposito /* 935ebc2752bSEmanuele Giuseppe Esposito * Returns a malloced string that describes the parent of the child for a 936ebc2752bSEmanuele Giuseppe Esposito * human reader. This could be a node-name, BlockBackend name, qdev ID or 937ebc2752bSEmanuele Giuseppe Esposito * QOM path of the device owning the BlockBackend, job type and ID etc. The 938ebc2752bSEmanuele Giuseppe Esposito * caller is responsible for freeing the memory. 939ebc2752bSEmanuele Giuseppe Esposito */ 940ebc2752bSEmanuele Giuseppe Esposito char *(*get_parent_desc)(BdrvChild *child); 941ebc2752bSEmanuele Giuseppe Esposito 942ebc2752bSEmanuele Giuseppe Esposito /* 943ebc2752bSEmanuele Giuseppe Esposito * Notifies the parent that the child has been activated/inactivated (e.g. 944ebc2752bSEmanuele Giuseppe Esposito * when migration is completing) and it can start/stop requesting 945ebc2752bSEmanuele Giuseppe Esposito * permissions and doing I/O on it. 946ebc2752bSEmanuele Giuseppe Esposito */ 9473804e3cfSKevin Wolf void GRAPH_RDLOCK_PTR (*activate)(BdrvChild *child, Error **errp); 9483804e3cfSKevin Wolf int GRAPH_RDLOCK_PTR (*inactivate)(BdrvChild *child); 949ebc2752bSEmanuele Giuseppe Esposito 950303de47bSKevin Wolf void GRAPH_WRLOCK_PTR (*attach)(BdrvChild *child); 951303de47bSKevin Wolf void GRAPH_WRLOCK_PTR (*detach)(BdrvChild *child); 952ebc2752bSEmanuele Giuseppe Esposito 953ebc2752bSEmanuele Giuseppe Esposito /* 954ab613350SStefan Hajnoczi * If this pair of functions is implemented, the parent doesn't issue new 955ab613350SStefan Hajnoczi * requests after returning from .drained_begin() until .drained_end() is 956ab613350SStefan Hajnoczi * called. 957ab613350SStefan Hajnoczi * 958ab613350SStefan Hajnoczi * These functions must not change the graph (and therefore also must not 959ab613350SStefan Hajnoczi * call aio_poll(), which could change the graph indirectly). 960ab613350SStefan Hajnoczi * 961ab613350SStefan Hajnoczi * Note that this can be nested. If drained_begin() was called twice, new 962ab613350SStefan Hajnoczi * I/O is allowed only after drained_end() was called twice, too. 963ab613350SStefan Hajnoczi */ 964ab613350SStefan Hajnoczi void (*drained_begin)(BdrvChild *child); 965ab613350SStefan Hajnoczi void (*drained_end)(BdrvChild *child); 966ab613350SStefan Hajnoczi 967ab613350SStefan Hajnoczi /* 968ab613350SStefan Hajnoczi * Returns whether the parent has pending requests for the child. This 969ab613350SStefan Hajnoczi * callback is polled after .drained_begin() has been called until all 970ab613350SStefan Hajnoczi * activity on the child has stopped. 971ab613350SStefan Hajnoczi */ 972ab613350SStefan Hajnoczi bool (*drained_poll)(BdrvChild *child); 973ab613350SStefan Hajnoczi 974ab613350SStefan Hajnoczi /* 975ebc2752bSEmanuele Giuseppe Esposito * Notifies the parent that the filename of its child has changed (e.g. 976ebc2752bSEmanuele Giuseppe Esposito * because the direct child was removed from the backing chain), so that it 977ebc2752bSEmanuele Giuseppe Esposito * can update its reference. 978ebc2752bSEmanuele Giuseppe Esposito */ 979ebc2752bSEmanuele Giuseppe Esposito int (*update_filename)(BdrvChild *child, BlockDriverState *new_base, 980ebc2752bSEmanuele Giuseppe Esposito const char *filename, Error **errp); 981ebc2752bSEmanuele Giuseppe Esposito 9827e8c182fSEmanuele Giuseppe Esposito bool (*change_aio_ctx)(BdrvChild *child, AioContext *ctx, 983e08cc001SEmanuele Giuseppe Esposito GHashTable *visited, Transaction *tran, 984e08cc001SEmanuele Giuseppe Esposito Error **errp); 985ebc2752bSEmanuele Giuseppe Esposito 986abc5a79cSEmanuele Giuseppe Esposito /* 987abc5a79cSEmanuele Giuseppe Esposito * I/O API functions. These functions are thread-safe. 988abc5a79cSEmanuele Giuseppe Esposito * 989abc5a79cSEmanuele Giuseppe Esposito * See include/block/block-io.h for more information about 990abc5a79cSEmanuele Giuseppe Esposito * the I/O API. 991abc5a79cSEmanuele Giuseppe Esposito */ 992abc5a79cSEmanuele Giuseppe Esposito 993abc5a79cSEmanuele Giuseppe Esposito void (*resize)(BdrvChild *child); 994abc5a79cSEmanuele Giuseppe Esposito 995abc5a79cSEmanuele Giuseppe Esposito /* 996abc5a79cSEmanuele Giuseppe Esposito * Returns a name that is supposedly more useful for human users than the 997abc5a79cSEmanuele Giuseppe Esposito * node name for identifying the node in question (in particular, a BB 998abc5a79cSEmanuele Giuseppe Esposito * name), or NULL if the parent can't provide a better name. 999abc5a79cSEmanuele Giuseppe Esposito */ 1000abc5a79cSEmanuele Giuseppe Esposito const char *(*get_name)(BdrvChild *child); 1001abc5a79cSEmanuele Giuseppe Esposito 1002d5f8d79cSHanna Reitz AioContext *(*get_parent_aio_context)(BdrvChild *child); 1003ebc2752bSEmanuele Giuseppe Esposito }; 1004ebc2752bSEmanuele Giuseppe Esposito 1005ebc2752bSEmanuele Giuseppe Esposito extern const BdrvChildClass child_of_bds; 1006ebc2752bSEmanuele Giuseppe Esposito 1007ebc2752bSEmanuele Giuseppe Esposito struct BdrvChild { 1008ebc2752bSEmanuele Giuseppe Esposito BlockDriverState *bs; 1009ebc2752bSEmanuele Giuseppe Esposito char *name; 1010ebc2752bSEmanuele Giuseppe Esposito const BdrvChildClass *klass; 1011ebc2752bSEmanuele Giuseppe Esposito BdrvChildRole role; 1012ebc2752bSEmanuele Giuseppe Esposito void *opaque; 1013ebc2752bSEmanuele Giuseppe Esposito 1014ebc2752bSEmanuele Giuseppe Esposito /** 1015ebc2752bSEmanuele Giuseppe Esposito * Granted permissions for operating on this BdrvChild (BLK_PERM_* bitmask) 1016ebc2752bSEmanuele Giuseppe Esposito */ 1017ebc2752bSEmanuele Giuseppe Esposito uint64_t perm; 1018ebc2752bSEmanuele Giuseppe Esposito 1019ebc2752bSEmanuele Giuseppe Esposito /** 1020ebc2752bSEmanuele Giuseppe Esposito * Permissions that can still be granted to other users of @bs while this 1021ebc2752bSEmanuele Giuseppe Esposito * BdrvChild is still attached to it. (BLK_PERM_* bitmask) 1022ebc2752bSEmanuele Giuseppe Esposito */ 1023ebc2752bSEmanuele Giuseppe Esposito uint64_t shared_perm; 1024ebc2752bSEmanuele Giuseppe Esposito 1025ebc2752bSEmanuele Giuseppe Esposito /* 1026ebc2752bSEmanuele Giuseppe Esposito * This link is frozen: the child can neither be replaced nor 1027ebc2752bSEmanuele Giuseppe Esposito * detached from the parent. 1028ebc2752bSEmanuele Giuseppe Esposito */ 1029ebc2752bSEmanuele Giuseppe Esposito bool frozen; 1030ebc2752bSEmanuele Giuseppe Esposito 1031ebc2752bSEmanuele Giuseppe Esposito /* 103257e05be3SKevin Wolf * True if the parent of this child has been drained by this BdrvChild 1033ebc2752bSEmanuele Giuseppe Esposito * (through klass->drained_*). 103457e05be3SKevin Wolf * 103557e05be3SKevin Wolf * It is generally true if bs->quiesce_counter > 0. It may differ while the 1036ebc2752bSEmanuele Giuseppe Esposito * child is entering or leaving a drained section. 1037ebc2752bSEmanuele Giuseppe Esposito */ 103857e05be3SKevin Wolf bool quiesced_parent; 1039ebc2752bSEmanuele Giuseppe Esposito 1040ebc2752bSEmanuele Giuseppe Esposito QLIST_ENTRY(BdrvChild) next; 1041ebc2752bSEmanuele Giuseppe Esposito QLIST_ENTRY(BdrvChild) next_parent; 1042ebc2752bSEmanuele Giuseppe Esposito }; 1043ebc2752bSEmanuele Giuseppe Esposito 1044ebc2752bSEmanuele Giuseppe Esposito /* 1045ebc2752bSEmanuele Giuseppe Esposito * Allows bdrv_co_block_status() to cache one data region for a 1046ebc2752bSEmanuele Giuseppe Esposito * protocol node. 1047ebc2752bSEmanuele Giuseppe Esposito * 1048ebc2752bSEmanuele Giuseppe Esposito * @valid: Whether the cache is valid (should be accessed with atomic 1049ebc2752bSEmanuele Giuseppe Esposito * functions so this can be reset by RCU readers) 1050ebc2752bSEmanuele Giuseppe Esposito * @data_start: Offset where we know (or strongly assume) is data 1051ebc2752bSEmanuele Giuseppe Esposito * @data_end: Offset where the data region ends (which is not necessarily 1052ebc2752bSEmanuele Giuseppe Esposito * the start of a zeroed region) 1053ebc2752bSEmanuele Giuseppe Esposito */ 1054ebc2752bSEmanuele Giuseppe Esposito typedef struct BdrvBlockStatusCache { 1055ebc2752bSEmanuele Giuseppe Esposito struct rcu_head rcu; 1056ebc2752bSEmanuele Giuseppe Esposito 1057ebc2752bSEmanuele Giuseppe Esposito bool valid; 1058ebc2752bSEmanuele Giuseppe Esposito int64_t data_start; 1059ebc2752bSEmanuele Giuseppe Esposito int64_t data_end; 1060ebc2752bSEmanuele Giuseppe Esposito } BdrvBlockStatusCache; 1061ebc2752bSEmanuele Giuseppe Esposito 1062ebc2752bSEmanuele Giuseppe Esposito struct BlockDriverState { 1063ebc2752bSEmanuele Giuseppe Esposito /* 1064ebc2752bSEmanuele Giuseppe Esposito * Protected by big QEMU lock or read-only after opening. No special 1065ebc2752bSEmanuele Giuseppe Esposito * locking needed during I/O... 1066ebc2752bSEmanuele Giuseppe Esposito */ 1067ebc2752bSEmanuele Giuseppe Esposito int open_flags; /* flags used to open the file, re-used for re-open */ 1068ebc2752bSEmanuele Giuseppe Esposito bool encrypted; /* if true, the media is encrypted */ 1069ebc2752bSEmanuele Giuseppe Esposito bool sg; /* if true, the device is a /dev/sg* */ 1070ebc2752bSEmanuele Giuseppe Esposito bool probed; /* if true, format was probed rather than specified */ 1071ebc2752bSEmanuele Giuseppe Esposito bool force_share; /* if true, always allow all shared permissions */ 1072ebc2752bSEmanuele Giuseppe Esposito bool implicit; /* if true, this filter node was automatically inserted */ 1073ebc2752bSEmanuele Giuseppe Esposito 1074ebc2752bSEmanuele Giuseppe Esposito BlockDriver *drv; /* NULL means no media */ 1075ebc2752bSEmanuele Giuseppe Esposito void *opaque; 1076ebc2752bSEmanuele Giuseppe Esposito 1077ebc2752bSEmanuele Giuseppe Esposito AioContext *aio_context; /* event loop used for fd handlers, timers, etc */ 1078ebc2752bSEmanuele Giuseppe Esposito /* 1079ebc2752bSEmanuele Giuseppe Esposito * long-running tasks intended to always use the same AioContext as this 1080ebc2752bSEmanuele Giuseppe Esposito * BDS may register themselves in this list to be notified of changes 1081ebc2752bSEmanuele Giuseppe Esposito * regarding this BDS's context 1082ebc2752bSEmanuele Giuseppe Esposito */ 1083ebc2752bSEmanuele Giuseppe Esposito QLIST_HEAD(, BdrvAioNotifier) aio_notifiers; 1084ebc2752bSEmanuele Giuseppe Esposito bool walking_aio_notifiers; /* to make removal during iteration safe */ 1085ebc2752bSEmanuele Giuseppe Esposito 1086ebc2752bSEmanuele Giuseppe Esposito char filename[PATH_MAX]; 1087ebc2752bSEmanuele Giuseppe Esposito /* 1088ebc2752bSEmanuele Giuseppe Esposito * If not empty, this image is a diff in relation to backing_file. 1089ebc2752bSEmanuele Giuseppe Esposito * Note that this is the name given in the image header and 1090ebc2752bSEmanuele Giuseppe Esposito * therefore may or may not be equal to .backing->bs->filename. 1091ebc2752bSEmanuele Giuseppe Esposito * If this field contains a relative path, it is to be resolved 1092ebc2752bSEmanuele Giuseppe Esposito * relatively to the overlay's location. 1093ebc2752bSEmanuele Giuseppe Esposito */ 1094ebc2752bSEmanuele Giuseppe Esposito char backing_file[PATH_MAX]; 1095ebc2752bSEmanuele Giuseppe Esposito /* 1096ebc2752bSEmanuele Giuseppe Esposito * The backing filename indicated by the image header. Contrary 1097ebc2752bSEmanuele Giuseppe Esposito * to backing_file, if we ever open this file, auto_backing_file 1098ebc2752bSEmanuele Giuseppe Esposito * is replaced by the resulting BDS's filename (i.e. after a 1099ebc2752bSEmanuele Giuseppe Esposito * bdrv_refresh_filename() run). 1100ebc2752bSEmanuele Giuseppe Esposito */ 1101ebc2752bSEmanuele Giuseppe Esposito char auto_backing_file[PATH_MAX]; 1102ebc2752bSEmanuele Giuseppe Esposito char backing_format[16]; /* if non-zero and backing_file exists */ 1103ebc2752bSEmanuele Giuseppe Esposito 1104ebc2752bSEmanuele Giuseppe Esposito QDict *full_open_options; 1105ebc2752bSEmanuele Giuseppe Esposito char exact_filename[PATH_MAX]; 1106ebc2752bSEmanuele Giuseppe Esposito 1107ebc2752bSEmanuele Giuseppe Esposito /* I/O Limits */ 1108ebc2752bSEmanuele Giuseppe Esposito BlockLimits bl; 1109ebc2752bSEmanuele Giuseppe Esposito 1110ebc2752bSEmanuele Giuseppe Esposito /* 1111ebc2752bSEmanuele Giuseppe Esposito * Flags honored during pread 1112ebc2752bSEmanuele Giuseppe Esposito */ 111398b3ddc7SStefan Hajnoczi BdrvRequestFlags supported_read_flags; 1114ebc2752bSEmanuele Giuseppe Esposito /* 1115ebc2752bSEmanuele Giuseppe Esposito * Flags honored during pwrite (so far: BDRV_REQ_FUA, 1116ebc2752bSEmanuele Giuseppe Esposito * BDRV_REQ_WRITE_UNCHANGED). 1117ebc2752bSEmanuele Giuseppe Esposito * If a driver does not support BDRV_REQ_WRITE_UNCHANGED, those 1118ebc2752bSEmanuele Giuseppe Esposito * writes will be issued as normal writes without the flag set. 1119ebc2752bSEmanuele Giuseppe Esposito * This is important to note for drivers that do not explicitly 1120ebc2752bSEmanuele Giuseppe Esposito * request a WRITE permission for their children and instead take 1121ebc2752bSEmanuele Giuseppe Esposito * the same permissions as their parent did (this is commonly what 1122ebc2752bSEmanuele Giuseppe Esposito * block filters do). Such drivers have to be aware that the 1123ebc2752bSEmanuele Giuseppe Esposito * parent may have taken a WRITE_UNCHANGED permission only and is 1124ebc2752bSEmanuele Giuseppe Esposito * issuing such requests. Drivers either must make sure that 1125ebc2752bSEmanuele Giuseppe Esposito * these requests do not result in plain WRITE accesses (usually 1126ebc2752bSEmanuele Giuseppe Esposito * by supporting BDRV_REQ_WRITE_UNCHANGED, and then forwarding 1127ebc2752bSEmanuele Giuseppe Esposito * every incoming write request as-is, including potentially that 1128ebc2752bSEmanuele Giuseppe Esposito * flag), or they have to explicitly take the WRITE permission for 1129ebc2752bSEmanuele Giuseppe Esposito * their children. 1130ebc2752bSEmanuele Giuseppe Esposito */ 113198b3ddc7SStefan Hajnoczi BdrvRequestFlags supported_write_flags; 1132ebc2752bSEmanuele Giuseppe Esposito /* 1133ebc2752bSEmanuele Giuseppe Esposito * Flags honored during pwrite_zeroes (so far: BDRV_REQ_FUA, 1134ebc2752bSEmanuele Giuseppe Esposito * BDRV_REQ_MAY_UNMAP, BDRV_REQ_WRITE_UNCHANGED) 1135ebc2752bSEmanuele Giuseppe Esposito */ 113698b3ddc7SStefan Hajnoczi BdrvRequestFlags supported_zero_flags; 1137ebc2752bSEmanuele Giuseppe Esposito /* 1138ebc2752bSEmanuele Giuseppe Esposito * Flags honoured during truncate (so far: BDRV_REQ_ZERO_WRITE). 1139ebc2752bSEmanuele Giuseppe Esposito * 1140ebc2752bSEmanuele Giuseppe Esposito * If BDRV_REQ_ZERO_WRITE is given, the truncate operation must make sure 1141ebc2752bSEmanuele Giuseppe Esposito * that any added space reads as all zeros. If this can't be guaranteed, 1142ebc2752bSEmanuele Giuseppe Esposito * the operation must fail. 1143ebc2752bSEmanuele Giuseppe Esposito */ 114498b3ddc7SStefan Hajnoczi BdrvRequestFlags supported_truncate_flags; 1145ebc2752bSEmanuele Giuseppe Esposito 1146ebc2752bSEmanuele Giuseppe Esposito /* the following member gives a name to every node on the bs graph. */ 1147ebc2752bSEmanuele Giuseppe Esposito char node_name[32]; 1148ebc2752bSEmanuele Giuseppe Esposito /* element of the list of named nodes building the graph */ 1149ebc2752bSEmanuele Giuseppe Esposito QTAILQ_ENTRY(BlockDriverState) node_list; 1150ebc2752bSEmanuele Giuseppe Esposito /* element of the list of all BlockDriverStates (all_bdrv_states) */ 1151ebc2752bSEmanuele Giuseppe Esposito QTAILQ_ENTRY(BlockDriverState) bs_list; 1152ebc2752bSEmanuele Giuseppe Esposito /* element of the list of monitor-owned BDS */ 1153ebc2752bSEmanuele Giuseppe Esposito QTAILQ_ENTRY(BlockDriverState) monitor_list; 1154ebc2752bSEmanuele Giuseppe Esposito int refcnt; 1155ebc2752bSEmanuele Giuseppe Esposito 1156ebc2752bSEmanuele Giuseppe Esposito /* operation blockers. Protected by BQL. */ 1157ebc2752bSEmanuele Giuseppe Esposito QLIST_HEAD(, BdrvOpBlocker) op_blockers[BLOCK_OP_TYPE_MAX]; 1158ebc2752bSEmanuele Giuseppe Esposito 1159ebc2752bSEmanuele Giuseppe Esposito /* 1160ebc2752bSEmanuele Giuseppe Esposito * The node that this node inherited default options from (and a reopen on 1161ebc2752bSEmanuele Giuseppe Esposito * which can affect this node by changing these defaults). This is always a 1162ebc2752bSEmanuele Giuseppe Esposito * parent node of this node. 1163ebc2752bSEmanuele Giuseppe Esposito */ 1164ebc2752bSEmanuele Giuseppe Esposito BlockDriverState *inherits_from; 11655bb04747SVladimir Sementsov-Ogievskiy 11665bb04747SVladimir Sementsov-Ogievskiy /* 11675bb04747SVladimir Sementsov-Ogievskiy * @backing and @file are some of @children or NULL. All these three fields 11685bb04747SVladimir Sementsov-Ogievskiy * (@file, @backing and @children) are modified only in 11695bb04747SVladimir Sementsov-Ogievskiy * bdrv_child_cb_attach() and bdrv_child_cb_detach(). 11705bb04747SVladimir Sementsov-Ogievskiy * 11715bb04747SVladimir Sementsov-Ogievskiy * See also comment in include/block/block.h, to learn how backing and file 11725bb04747SVladimir Sementsov-Ogievskiy * are connected with BdrvChildRole. 11735bb04747SVladimir Sementsov-Ogievskiy */ 1174ebc2752bSEmanuele Giuseppe Esposito QLIST_HEAD(, BdrvChild) children; 11755bb04747SVladimir Sementsov-Ogievskiy BdrvChild *backing; 11765bb04747SVladimir Sementsov-Ogievskiy BdrvChild *file; 11775bb04747SVladimir Sementsov-Ogievskiy 1178ebc2752bSEmanuele Giuseppe Esposito QLIST_HEAD(, BdrvChild) parents; 1179ebc2752bSEmanuele Giuseppe Esposito 1180ebc2752bSEmanuele Giuseppe Esposito QDict *options; 1181ebc2752bSEmanuele Giuseppe Esposito QDict *explicit_options; 1182ebc2752bSEmanuele Giuseppe Esposito BlockdevDetectZeroesOptions detect_zeroes; 1183ebc2752bSEmanuele Giuseppe Esposito 1184ebc2752bSEmanuele Giuseppe Esposito /* The error object in use for blocking operations on backing_hd */ 1185ebc2752bSEmanuele Giuseppe Esposito Error *backing_blocker; 1186ebc2752bSEmanuele Giuseppe Esposito 1187ebc2752bSEmanuele Giuseppe Esposito /* Protected by AioContext lock */ 1188ebc2752bSEmanuele Giuseppe Esposito 1189ebc2752bSEmanuele Giuseppe Esposito /* 1190ebc2752bSEmanuele Giuseppe Esposito * If we are reading a disk image, give its size in sectors. 1191ebc2752bSEmanuele Giuseppe Esposito * Generally read-only; it is written to by load_snapshot and 1192ebc2752bSEmanuele Giuseppe Esposito * save_snaphost, but the block layer is quiescent during those. 1193ebc2752bSEmanuele Giuseppe Esposito */ 1194ebc2752bSEmanuele Giuseppe Esposito int64_t total_sectors; 1195ebc2752bSEmanuele Giuseppe Esposito 1196ebc2752bSEmanuele Giuseppe Esposito /* threshold limit for writes, in bytes. "High water mark". */ 1197ebc2752bSEmanuele Giuseppe Esposito uint64_t write_threshold_offset; 1198ebc2752bSEmanuele Giuseppe Esposito 1199ebc2752bSEmanuele Giuseppe Esposito /* 1200ebc2752bSEmanuele Giuseppe Esposito * Writing to the list requires the BQL _and_ the dirty_bitmap_mutex. 1201ebc2752bSEmanuele Giuseppe Esposito * Reading from the list can be done with either the BQL or the 1202ebc2752bSEmanuele Giuseppe Esposito * dirty_bitmap_mutex. Modifying a bitmap only requires 1203ebc2752bSEmanuele Giuseppe Esposito * dirty_bitmap_mutex. 1204ebc2752bSEmanuele Giuseppe Esposito */ 1205ebc2752bSEmanuele Giuseppe Esposito QemuMutex dirty_bitmap_mutex; 1206ebc2752bSEmanuele Giuseppe Esposito QLIST_HEAD(, BdrvDirtyBitmap) dirty_bitmaps; 1207ebc2752bSEmanuele Giuseppe Esposito 1208ebc2752bSEmanuele Giuseppe Esposito /* Offset after the highest byte written to */ 1209ebc2752bSEmanuele Giuseppe Esposito Stat64 wr_highest_offset; 1210ebc2752bSEmanuele Giuseppe Esposito 1211ebc2752bSEmanuele Giuseppe Esposito /* 1212ebc2752bSEmanuele Giuseppe Esposito * If true, copy read backing sectors into image. Can be >1 if more 1213ebc2752bSEmanuele Giuseppe Esposito * than one client has requested copy-on-read. Accessed with atomic 1214ebc2752bSEmanuele Giuseppe Esposito * ops. 1215ebc2752bSEmanuele Giuseppe Esposito */ 1216ebc2752bSEmanuele Giuseppe Esposito int copy_on_read; 1217ebc2752bSEmanuele Giuseppe Esposito 1218ebc2752bSEmanuele Giuseppe Esposito /* 1219ebc2752bSEmanuele Giuseppe Esposito * number of in-flight requests; overall and serialising. 1220ebc2752bSEmanuele Giuseppe Esposito * Accessed with atomic ops. 1221ebc2752bSEmanuele Giuseppe Esposito */ 1222ebc2752bSEmanuele Giuseppe Esposito unsigned int in_flight; 1223ebc2752bSEmanuele Giuseppe Esposito unsigned int serialising_in_flight; 1224ebc2752bSEmanuele Giuseppe Esposito 1225ebc2752bSEmanuele Giuseppe Esposito /* do we need to tell the quest if we have a volatile write cache? */ 1226ebc2752bSEmanuele Giuseppe Esposito int enable_write_cache; 1227ebc2752bSEmanuele Giuseppe Esposito 1228ebc2752bSEmanuele Giuseppe Esposito /* Accessed with atomic ops. */ 1229ebc2752bSEmanuele Giuseppe Esposito int quiesce_counter; 1230ebc2752bSEmanuele Giuseppe Esposito 1231ebc2752bSEmanuele Giuseppe Esposito unsigned int write_gen; /* Current data generation */ 1232ebc2752bSEmanuele Giuseppe Esposito 1233ebc2752bSEmanuele Giuseppe Esposito /* Protected by reqs_lock. */ 1234fa9185fcSStefan Hajnoczi QemuMutex reqs_lock; 1235ebc2752bSEmanuele Giuseppe Esposito QLIST_HEAD(, BdrvTrackedRequest) tracked_requests; 1236ebc2752bSEmanuele Giuseppe Esposito CoQueue flush_queue; /* Serializing flush queue */ 1237ebc2752bSEmanuele Giuseppe Esposito bool active_flush_req; /* Flush request in flight? */ 1238ebc2752bSEmanuele Giuseppe Esposito 1239ebc2752bSEmanuele Giuseppe Esposito /* Only read/written by whoever has set active_flush_req to true. */ 1240ebc2752bSEmanuele Giuseppe Esposito unsigned int flushed_gen; /* Flushed write generation */ 1241ebc2752bSEmanuele Giuseppe Esposito 1242ebc2752bSEmanuele Giuseppe Esposito /* BdrvChild links to this node may never be frozen */ 1243ebc2752bSEmanuele Giuseppe Esposito bool never_freeze; 1244ebc2752bSEmanuele Giuseppe Esposito 1245ebc2752bSEmanuele Giuseppe Esposito /* Lock for block-status cache RCU writers */ 1246ebc2752bSEmanuele Giuseppe Esposito CoMutex bsc_modify_lock; 1247ebc2752bSEmanuele Giuseppe Esposito /* Always non-NULL, but must only be dereferenced under an RCU read guard */ 1248ebc2752bSEmanuele Giuseppe Esposito BdrvBlockStatusCache *block_status_cache; 1249a3c41f06SSam Li 1250a3c41f06SSam Li /* array of write pointers' location of each zone in the zoned device. */ 1251a3c41f06SSam Li BlockZoneWps *wps; 1252ebc2752bSEmanuele Giuseppe Esposito }; 1253ebc2752bSEmanuele Giuseppe Esposito 1254ebc2752bSEmanuele Giuseppe Esposito struct BlockBackendRootState { 1255ebc2752bSEmanuele Giuseppe Esposito int open_flags; 1256ebc2752bSEmanuele Giuseppe Esposito BlockdevDetectZeroesOptions detect_zeroes; 1257ebc2752bSEmanuele Giuseppe Esposito }; 1258ebc2752bSEmanuele Giuseppe Esposito 1259ebc2752bSEmanuele Giuseppe Esposito typedef enum BlockMirrorBackingMode { 1260ebc2752bSEmanuele Giuseppe Esposito /* 1261ebc2752bSEmanuele Giuseppe Esposito * Reuse the existing backing chain from the source for the target. 1262ebc2752bSEmanuele Giuseppe Esposito * - sync=full: Set backing BDS to NULL. 1263ebc2752bSEmanuele Giuseppe Esposito * - sync=top: Use source's backing BDS. 1264ebc2752bSEmanuele Giuseppe Esposito * - sync=none: Use source as the backing BDS. 1265ebc2752bSEmanuele Giuseppe Esposito */ 1266ebc2752bSEmanuele Giuseppe Esposito MIRROR_SOURCE_BACKING_CHAIN, 1267ebc2752bSEmanuele Giuseppe Esposito 1268ebc2752bSEmanuele Giuseppe Esposito /* Open the target's backing chain completely anew */ 1269ebc2752bSEmanuele Giuseppe Esposito MIRROR_OPEN_BACKING_CHAIN, 1270ebc2752bSEmanuele Giuseppe Esposito 1271ebc2752bSEmanuele Giuseppe Esposito /* Do not change the target's backing BDS after job completion */ 1272ebc2752bSEmanuele Giuseppe Esposito MIRROR_LEAVE_BACKING_CHAIN, 1273ebc2752bSEmanuele Giuseppe Esposito } BlockMirrorBackingMode; 1274ebc2752bSEmanuele Giuseppe Esposito 1275ebc2752bSEmanuele Giuseppe Esposito 1276ebc2752bSEmanuele Giuseppe Esposito /* 1277ebc2752bSEmanuele Giuseppe Esposito * Essential block drivers which must always be statically linked into qemu, and 1278ebc2752bSEmanuele Giuseppe Esposito * which therefore can be accessed without using bdrv_find_format() 1279ebc2752bSEmanuele Giuseppe Esposito */ 1280ebc2752bSEmanuele Giuseppe Esposito extern BlockDriver bdrv_file; 1281ebc2752bSEmanuele Giuseppe Esposito extern BlockDriver bdrv_raw; 1282ebc2752bSEmanuele Giuseppe Esposito extern BlockDriver bdrv_qcow2; 1283ebc2752bSEmanuele Giuseppe Esposito 1284ebc2752bSEmanuele Giuseppe Esposito extern unsigned int bdrv_drain_all_count; 1285ebc2752bSEmanuele Giuseppe Esposito extern QemuOptsList bdrv_create_opts_simple; 1286ebc2752bSEmanuele Giuseppe Esposito 1287ebc2752bSEmanuele Giuseppe Esposito /* 1288ebc2752bSEmanuele Giuseppe Esposito * Common functions that are neither I/O nor Global State. 1289ebc2752bSEmanuele Giuseppe Esposito * 129004ae220dSWilfred Mallawa * See include/block/block-common.h for more information about 1291ebc2752bSEmanuele Giuseppe Esposito * the Common API. 1292ebc2752bSEmanuele Giuseppe Esposito */ 1293ebc2752bSEmanuele Giuseppe Esposito 1294ebc2752bSEmanuele Giuseppe Esposito static inline BlockDriverState *child_bs(BdrvChild *child) 1295ebc2752bSEmanuele Giuseppe Esposito { 1296ebc2752bSEmanuele Giuseppe Esposito return child ? child->bs : NULL; 1297ebc2752bSEmanuele Giuseppe Esposito } 1298ebc2752bSEmanuele Giuseppe Esposito 1299ebc2752bSEmanuele Giuseppe Esposito int bdrv_check_request(int64_t offset, int64_t bytes, Error **errp); 130069fbfff9SBin Meng char *create_tmp_file(Error **errp); 1301ebc2752bSEmanuele Giuseppe Esposito void bdrv_parse_filename_strip_prefix(const char *filename, const char *prefix, 1302ebc2752bSEmanuele Giuseppe Esposito QDict *options); 1303ebc2752bSEmanuele Giuseppe Esposito 1304ebc2752bSEmanuele Giuseppe Esposito 1305ebc2752bSEmanuele Giuseppe Esposito int bdrv_check_qiov_request(int64_t offset, int64_t bytes, 1306ebc2752bSEmanuele Giuseppe Esposito QEMUIOVector *qiov, size_t qiov_offset, 1307ebc2752bSEmanuele Giuseppe Esposito Error **errp); 1308ebc2752bSEmanuele Giuseppe Esposito 1309ebc2752bSEmanuele Giuseppe Esposito #ifdef _WIN32 1310ebc2752bSEmanuele Giuseppe Esposito int is_windows_drive(const char *filename); 1311ebc2752bSEmanuele Giuseppe Esposito #endif 1312ebc2752bSEmanuele Giuseppe Esposito 1313ebc2752bSEmanuele Giuseppe Esposito #endif /* BLOCK_INT_COMMON_H */ 1314