]>
Commit | Line | Data |
---|---|---|
26f54e9a MA |
1 | /* |
2 | * QEMU Block backends | |
3 | * | |
60cb2fa7 | 4 | * Copyright (C) 2014-2016 Red Hat, Inc. |
26f54e9a MA |
5 | * |
6 | * Authors: | |
7 | * Markus Armbruster <armbru@redhat.com>, | |
8 | * | |
9 | * This work is licensed under the terms of the GNU LGPL, version 2.1 | |
10 | * or later. See the COPYING.LIB file in the top-level directory. | |
11 | */ | |
12 | ||
80c71a24 | 13 | #include "qemu/osdep.h" |
26f54e9a MA |
14 | #include "sysemu/block-backend.h" |
15 | #include "block/block_int.h" | |
373340b2 | 16 | #include "block/blockjob.h" |
16d36e29 | 17 | #include "block/coroutines.h" |
281d22d8 | 18 | #include "block/throttle-groups.h" |
13d4ff07 | 19 | #include "hw/qdev-core.h" |
18e46a03 | 20 | #include "sysemu/blockdev.h" |
54d31236 | 21 | #include "sysemu/runstate.h" |
e4ec5ad4 | 22 | #include "sysemu/replay.h" |
e688df6b | 23 | #include "qapi/error.h" |
9af23989 | 24 | #include "qapi/qapi-events-block.h" |
f348b6d1 | 25 | #include "qemu/id.h" |
db725815 | 26 | #include "qemu/main-loop.h" |
922a01a0 | 27 | #include "qemu/option.h" |
1e98fefd | 28 | #include "trace.h" |
5f7772c4 | 29 | #include "migration/misc.h" |
a7f53e26 MA |
30 | |
31 | /* Number of coroutines to reserve per attached device model */ | |
32 | #define COROUTINE_POOL_RESERVATION 64 | |
26f54e9a | 33 | |
1bf1cbc9 KW |
34 | #define NOT_DONE 0x7fffffff /* used while emulated sync operation in progress */ |
35 | ||
4981bdec HR |
36 | static AioContext *blk_aiocb_get_aio_context(BlockAIOCB *acb); |
37 | ||
d03654ea SH |
38 | typedef struct BlockBackendAioNotifier { |
39 | void (*attached_aio_context)(AioContext *new_context, void *opaque); | |
40 | void (*detach_aio_context)(void *opaque); | |
41 | void *opaque; | |
42 | QLIST_ENTRY(BlockBackendAioNotifier) list; | |
43 | } BlockBackendAioNotifier; | |
44 | ||
26f54e9a MA |
45 | struct BlockBackend { |
46 | char *name; | |
47 | int refcnt; | |
f21d96d0 | 48 | BdrvChild *root; |
d861ab3a | 49 | AioContext *ctx; |
26f8b3a8 | 50 | DriveInfo *legacy_dinfo; /* null unless created by drive_new() */ |
2cf22d6a | 51 | QTAILQ_ENTRY(BlockBackend) link; /* for block_backends */ |
9492b0b9 | 52 | QTAILQ_ENTRY(BlockBackend) monitor_link; /* for monitor_block_backends */ |
f2cd875d | 53 | BlockBackendPublic public; |
a7f53e26 | 54 | |
d09ea2d2 | 55 | DeviceState *dev; /* attached device model, if any */ |
a7f53e26 MA |
56 | const BlockDevOps *dev_ops; |
57 | void *dev_opaque; | |
68e9ec01 | 58 | |
281d22d8 HR |
59 | /* If the BDS tree is removed, some of its options are stored here (which |
60 | * can be used to restore those options in the new BDS on insert) */ | |
61 | BlockBackendRootState root_state; | |
62 | ||
bfd18d1e KW |
63 | bool enable_write_cache; |
64 | ||
7f0e9da6 HR |
65 | /* I/O stats (display with "info blockstats"). */ |
66 | BlockAcctStats stats; | |
373340b2 HR |
67 | |
68 | BlockdevOnError on_read_error, on_write_error; | |
69 | bool iostatus_enabled; | |
70 | BlockDeviceIoStatus iostatus; | |
3301f6c6 | 71 | |
981776b3 KW |
72 | uint64_t perm; |
73 | uint64_t shared_perm; | |
d35ff5e6 | 74 | bool disable_perm; |
981776b3 | 75 | |
980b0f94 | 76 | bool allow_aio_context_change; |
c10c9d96 KW |
77 | bool allow_write_beyond_eof; |
78 | ||
a2c4c3b1 | 79 | /* Protected by BQL */ |
3301f6c6 | 80 | NotifierList remove_bs_notifiers, insert_bs_notifiers; |
d03654ea | 81 | QLIST_HEAD(, BlockBackendAioNotifier) aio_notifiers; |
f4d9cc88 | 82 | |
c4d5bf99 | 83 | int quiesce_counter; /* atomic: written under BQL, read by other threads */ |
407ae2ae | 84 | QemuMutex queued_requests_lock; /* protects queued_requests */ |
cf312932 | 85 | CoQueue queued_requests; |
ef80ec50 | 86 | bool disable_request_queuing; /* atomic */ |
cf312932 | 87 | |
5f7772c4 | 88 | VMChangeStateEntry *vmsh; |
ca2e2144 | 89 | bool force_allow_inactivate; |
33f2a757 SH |
90 | |
91 | /* Number of in-flight aio requests. BlockDriverState also counts | |
92 | * in-flight requests but aio requests can exist even when blk->root is | |
93 | * NULL, so we cannot rely on its counter for that case. | |
94 | * Accessed with atomic ops. | |
95 | */ | |
96 | unsigned int in_flight; | |
26f54e9a MA |
97 | }; |
98 | ||
e7f7d676 HR |
99 | typedef struct BlockBackendAIOCB { |
100 | BlockAIOCB common; | |
4981bdec | 101 | BlockBackend *blk; |
e7f7d676 HR |
102 | int ret; |
103 | } BlockBackendAIOCB; | |
104 | ||
105 | static const AIOCBInfo block_backend_aiocb_info = { | |
4981bdec | 106 | .get_aio_context = blk_aiocb_get_aio_context, |
e7f7d676 HR |
107 | .aiocb_size = sizeof(BlockBackendAIOCB), |
108 | }; | |
109 | ||
8fb3c76c | 110 | static void drive_info_del(DriveInfo *dinfo); |
7c8eece4 | 111 | static BlockBackend *bdrv_first_blk(BlockDriverState *bs); |
8fb3c76c | 112 | |
a2c4c3b1 | 113 | /* All BlockBackends. Protected by BQL. */ |
2cf22d6a HR |
114 | static QTAILQ_HEAD(, BlockBackend) block_backends = |
115 | QTAILQ_HEAD_INITIALIZER(block_backends); | |
116 | ||
a2c4c3b1 EGE |
117 | /* |
118 | * All BlockBackends referenced by the monitor and which are iterated through by | |
119 | * blk_next(). Protected by BQL. | |
120 | */ | |
9492b0b9 HR |
121 | static QTAILQ_HEAD(, BlockBackend) monitor_block_backends = |
122 | QTAILQ_HEAD_INITIALIZER(monitor_block_backends); | |
26f54e9a | 123 | |
3cdc69d3 | 124 | static void blk_root_inherit_options(BdrvChildRole role, bool parent_is_format, |
272c02ea | 125 | int *child_flags, QDict *child_options, |
f21d96d0 KW |
126 | int parent_flags, QDict *parent_options) |
127 | { | |
128 | /* We're not supposed to call this function for root nodes */ | |
129 | abort(); | |
130 | } | |
c2066af0 | 131 | static void blk_root_drained_begin(BdrvChild *child); |
fe5258a5 | 132 | static bool blk_root_drained_poll(BdrvChild *child); |
2f65df6e | 133 | static void blk_root_drained_end(BdrvChild *child); |
f21d96d0 | 134 | |
5c8cab48 KW |
135 | static void blk_root_change_media(BdrvChild *child, bool load); |
136 | static void blk_root_resize(BdrvChild *child); | |
137 | ||
33949396 EGE |
138 | static bool blk_root_change_aio_ctx(BdrvChild *child, AioContext *ctx, |
139 | GHashTable *visited, Transaction *tran, | |
140 | Error **errp); | |
38475269 | 141 | |
b5411555 KW |
142 | static char *blk_root_get_parent_desc(BdrvChild *child) |
143 | { | |
144 | BlockBackend *blk = child->opaque; | |
fd240a18 | 145 | g_autofree char *dev_id = NULL; |
b5411555 KW |
146 | |
147 | if (blk->name) { | |
fd240a18 | 148 | return g_strdup_printf("block device '%s'", blk->name); |
b5411555 KW |
149 | } |
150 | ||
151 | dev_id = blk_get_attached_dev_id(blk); | |
152 | if (*dev_id) { | |
fd240a18 | 153 | return g_strdup_printf("block device '%s'", dev_id); |
b5411555 KW |
154 | } else { |
155 | /* TODO Callback into the BB owner for something more detailed */ | |
fd240a18 | 156 | return g_strdup("an unnamed block device"); |
b5411555 KW |
157 | } |
158 | } | |
159 | ||
4c265bf9 KW |
160 | static const char *blk_root_get_name(BdrvChild *child) |
161 | { | |
162 | return blk_name(child->opaque); | |
163 | } | |
164 | ||
538f0497 | 165 | static void blk_vm_state_changed(void *opaque, bool running, RunState state) |
5f7772c4 FZ |
166 | { |
167 | Error *local_err = NULL; | |
168 | BlockBackend *blk = opaque; | |
169 | ||
170 | if (state == RUN_STATE_INMIGRATE) { | |
171 | return; | |
172 | } | |
173 | ||
174 | qemu_del_vm_change_state_handler(blk->vmsh); | |
175 | blk->vmsh = NULL; | |
176 | blk_set_perm(blk, blk->perm, blk->shared_perm, &local_err); | |
177 | if (local_err) { | |
178 | error_report_err(local_err); | |
179 | } | |
180 | } | |
181 | ||
4417ab7a KW |
182 | /* |
183 | * Notifies the user of the BlockBackend that migration has completed. qdev | |
184 | * devices can tighten their permissions in response (specifically revoke | |
185 | * shared write permissions that we needed for storage migration). | |
186 | * | |
187 | * If an error is returned, the VM cannot be allowed to be resumed. | |
188 | */ | |
189 | static void blk_root_activate(BdrvChild *child, Error **errp) | |
190 | { | |
191 | BlockBackend *blk = child->opaque; | |
192 | Error *local_err = NULL; | |
492a1196 | 193 | uint64_t saved_shared_perm; |
4417ab7a KW |
194 | |
195 | if (!blk->disable_perm) { | |
196 | return; | |
197 | } | |
198 | ||
199 | blk->disable_perm = false; | |
200 | ||
492a1196 HR |
201 | /* |
202 | * blk->shared_perm contains the permissions we want to share once | |
203 | * migration is really completely done. For now, we need to share | |
204 | * all; but we also need to retain blk->shared_perm, which is | |
205 | * overwritten by a successful blk_set_perm() call. Save it and | |
206 | * restore it below. | |
207 | */ | |
208 | saved_shared_perm = blk->shared_perm; | |
209 | ||
5f7772c4 FZ |
210 | blk_set_perm(blk, blk->perm, BLK_PERM_ALL, &local_err); |
211 | if (local_err) { | |
212 | error_propagate(errp, local_err); | |
213 | blk->disable_perm = true; | |
214 | return; | |
215 | } | |
492a1196 | 216 | blk->shared_perm = saved_shared_perm; |
5f7772c4 FZ |
217 | |
218 | if (runstate_check(RUN_STATE_INMIGRATE)) { | |
219 | /* Activation can happen when migration process is still active, for | |
220 | * example when nbd_server_add is called during non-shared storage | |
221 | * migration. Defer the shared_perm update to migration completion. */ | |
222 | if (!blk->vmsh) { | |
223 | blk->vmsh = qemu_add_vm_change_state_handler(blk_vm_state_changed, | |
224 | blk); | |
225 | } | |
226 | return; | |
227 | } | |
228 | ||
4417ab7a KW |
229 | blk_set_perm(blk, blk->perm, blk->shared_perm, &local_err); |
230 | if (local_err) { | |
231 | error_propagate(errp, local_err); | |
232 | blk->disable_perm = true; | |
233 | return; | |
234 | } | |
235 | } | |
236 | ||
ca2e2144 FZ |
237 | void blk_set_force_allow_inactivate(BlockBackend *blk) |
238 | { | |
0439c5a4 | 239 | GLOBAL_STATE_CODE(); |
ca2e2144 FZ |
240 | blk->force_allow_inactivate = true; |
241 | } | |
242 | ||
c16de8f5 FZ |
243 | static bool blk_can_inactivate(BlockBackend *blk) |
244 | { | |
ca2e2144 | 245 | /* If it is a guest device, inactivate is ok. */ |
c16de8f5 FZ |
246 | if (blk->dev || blk_name(blk)[0]) { |
247 | return true; | |
248 | } | |
249 | ||
ca2e2144 FZ |
250 | /* Inactivating means no more writes to the image can be done, |
251 | * even if those writes would be changes invisible to the | |
252 | * guest. For block job BBs that satisfy this, we can just allow | |
253 | * it. This is the case for mirror job source, which is required | |
254 | * by libvirt non-shared block migration. */ | |
255 | if (!(blk->perm & (BLK_PERM_WRITE | BLK_PERM_WRITE_UNCHANGED))) { | |
256 | return true; | |
257 | } | |
258 | ||
259 | return blk->force_allow_inactivate; | |
c16de8f5 FZ |
260 | } |
261 | ||
cfa1a572 KW |
262 | static int blk_root_inactivate(BdrvChild *child) |
263 | { | |
264 | BlockBackend *blk = child->opaque; | |
265 | ||
266 | if (blk->disable_perm) { | |
267 | return 0; | |
268 | } | |
269 | ||
c16de8f5 | 270 | if (!blk_can_inactivate(blk)) { |
cfa1a572 KW |
271 | return -EPERM; |
272 | } | |
273 | ||
274 | blk->disable_perm = true; | |
275 | if (blk->root) { | |
276 | bdrv_child_try_set_perm(blk->root, 0, BLK_PERM_ALL, &error_abort); | |
277 | } | |
278 | ||
279 | return 0; | |
280 | } | |
281 | ||
d03654ea SH |
282 | static void blk_root_attach(BdrvChild *child) |
283 | { | |
284 | BlockBackend *blk = child->opaque; | |
285 | BlockBackendAioNotifier *notifier; | |
286 | ||
287 | trace_blk_root_attach(child, blk, child->bs); | |
288 | ||
289 | QLIST_FOREACH(notifier, &blk->aio_notifiers, list) { | |
290 | bdrv_add_aio_context_notifier(child->bs, | |
291 | notifier->attached_aio_context, | |
292 | notifier->detach_aio_context, | |
293 | notifier->opaque); | |
294 | } | |
295 | } | |
296 | ||
297 | static void blk_root_detach(BdrvChild *child) | |
298 | { | |
299 | BlockBackend *blk = child->opaque; | |
300 | BlockBackendAioNotifier *notifier; | |
301 | ||
302 | trace_blk_root_detach(child, blk, child->bs); | |
303 | ||
304 | QLIST_FOREACH(notifier, &blk->aio_notifiers, list) { | |
305 | bdrv_remove_aio_context_notifier(child->bs, | |
306 | notifier->attached_aio_context, | |
307 | notifier->detach_aio_context, | |
308 | notifier->opaque); | |
309 | } | |
310 | } | |
311 | ||
3ca1f322 VSO |
312 | static AioContext *blk_root_get_parent_aio_context(BdrvChild *c) |
313 | { | |
314 | BlockBackend *blk = c->opaque; | |
d5f8d79c | 315 | IO_CODE(); |
3ca1f322 VSO |
316 | |
317 | return blk_get_aio_context(blk); | |
318 | } | |
319 | ||
bd86fb99 | 320 | static const BdrvChildClass child_root = { |
c2066af0 KW |
321 | .inherit_options = blk_root_inherit_options, |
322 | ||
5c8cab48 KW |
323 | .change_media = blk_root_change_media, |
324 | .resize = blk_root_resize, | |
4c265bf9 | 325 | .get_name = blk_root_get_name, |
b5411555 | 326 | .get_parent_desc = blk_root_get_parent_desc, |
5c8cab48 | 327 | |
c2066af0 | 328 | .drained_begin = blk_root_drained_begin, |
fe5258a5 | 329 | .drained_poll = blk_root_drained_poll, |
c2066af0 | 330 | .drained_end = blk_root_drained_end, |
4417ab7a KW |
331 | |
332 | .activate = blk_root_activate, | |
cfa1a572 | 333 | .inactivate = blk_root_inactivate, |
d03654ea SH |
334 | |
335 | .attach = blk_root_attach, | |
336 | .detach = blk_root_detach, | |
38475269 | 337 | |
33949396 | 338 | .change_aio_ctx = blk_root_change_aio_ctx, |
3ca1f322 VSO |
339 | |
340 | .get_parent_aio_context = blk_root_get_parent_aio_context, | |
f21d96d0 KW |
341 | }; |
342 | ||
26f54e9a | 343 | /* |
efaa7c4e | 344 | * Create a new BlockBackend with a reference count of one. |
6d0eb64d KW |
345 | * |
346 | * @perm is a bitmasks of BLK_PERM_* constants which describes the permissions | |
347 | * to request for a block driver node that is attached to this BlockBackend. | |
348 | * @shared_perm is a bitmask which describes which permissions may be granted | |
349 | * to other users of the attached node. | |
350 | * Both sets of permissions can be changed later using blk_set_perm(). | |
351 | * | |
26f54e9a MA |
352 | * Return the new BlockBackend on success, null on failure. |
353 | */ | |
d861ab3a | 354 | BlockBackend *blk_new(AioContext *ctx, uint64_t perm, uint64_t shared_perm) |
26f54e9a MA |
355 | { |
356 | BlockBackend *blk; | |
357 | ||
0439c5a4 EGE |
358 | GLOBAL_STATE_CODE(); |
359 | ||
26f54e9a | 360 | blk = g_new0(BlockBackend, 1); |
26f54e9a | 361 | blk->refcnt = 1; |
d861ab3a | 362 | blk->ctx = ctx; |
6d0eb64d KW |
363 | blk->perm = perm; |
364 | blk->shared_perm = shared_perm; | |
0c3169df KW |
365 | blk_set_enable_write_cache(blk, true); |
366 | ||
cb53460b KW |
367 | blk->on_read_error = BLOCKDEV_ON_ERROR_REPORT; |
368 | blk->on_write_error = BLOCKDEV_ON_ERROR_ENOSPC; | |
369 | ||
9caa6f3d | 370 | block_acct_init(&blk->stats); |
27ccdd52 | 371 | |
407ae2ae | 372 | qemu_mutex_init(&blk->queued_requests_lock); |
cf312932 | 373 | qemu_co_queue_init(&blk->queued_requests); |
3301f6c6 HR |
374 | notifier_list_init(&blk->remove_bs_notifiers); |
375 | notifier_list_init(&blk->insert_bs_notifiers); | |
d03654ea | 376 | QLIST_INIT(&blk->aio_notifiers); |
27ccdd52 | 377 | |
2cf22d6a | 378 | QTAILQ_INSERT_TAIL(&block_backends, blk, link); |
26f54e9a MA |
379 | return blk; |
380 | } | |
381 | ||
a3aeeab5 EB |
382 | /* |
383 | * Create a new BlockBackend connected to an existing BlockDriverState. | |
384 | * | |
385 | * @perm is a bitmasks of BLK_PERM_* constants which describes the | |
386 | * permissions to request for @bs that is attached to this | |
387 | * BlockBackend. @shared_perm is a bitmask which describes which | |
388 | * permissions may be granted to other users of the attached node. | |
389 | * Both sets of permissions can be changed later using blk_set_perm(). | |
390 | * | |
391 | * Return the new BlockBackend on success, null on failure. | |
4c20dd24 KW |
392 | * |
393 | * Callers must hold the AioContext lock of @bs. | |
a3aeeab5 EB |
394 | */ |
395 | BlockBackend *blk_new_with_bs(BlockDriverState *bs, uint64_t perm, | |
396 | uint64_t shared_perm, Error **errp) | |
397 | { | |
398 | BlockBackend *blk = blk_new(bdrv_get_aio_context(bs), perm, shared_perm); | |
399 | ||
0439c5a4 EGE |
400 | GLOBAL_STATE_CODE(); |
401 | ||
a3aeeab5 EB |
402 | if (blk_insert_bs(blk, bs, errp) < 0) { |
403 | blk_unref(blk); | |
404 | return NULL; | |
405 | } | |
406 | return blk; | |
407 | } | |
408 | ||
7e7d56d9 | 409 | /* |
28eb9b12 | 410 | * Creates a new BlockBackend, opens a new BlockDriverState, and connects both. |
4c20dd24 KW |
411 | * By default, the new BlockBackend is in the main AioContext, but if the |
412 | * parameters connect it with any existing node in a different AioContext, it | |
413 | * may end up there instead. | |
ca49a4fd HR |
414 | * |
415 | * Just as with bdrv_open(), after having called this function the reference to | |
416 | * @options belongs to the block layer (even on failure). | |
417 | * | |
4c20dd24 KW |
418 | * Called without holding an AioContext lock. |
419 | * | |
ca49a4fd HR |
420 | * TODO: Remove @filename and @flags; it should be possible to specify a whole |
421 | * BDS tree just by specifying the @options QDict (or @reference, | |
422 | * alternatively). At the time of adding this function, this is not possible, | |
423 | * though, so callers of this function have to be able to specify @filename and | |
424 | * @flags. | |
425 | */ | |
efaa7c4e HR |
426 | BlockBackend *blk_new_open(const char *filename, const char *reference, |
427 | QDict *options, int flags, Error **errp) | |
ca49a4fd HR |
428 | { |
429 | BlockBackend *blk; | |
28eb9b12 | 430 | BlockDriverState *bs; |
4c20dd24 | 431 | AioContext *ctx; |
1f4ad7d3 | 432 | uint64_t perm = 0; |
35b7f4ab | 433 | uint64_t shared = BLK_PERM_ALL; |
c62d32f5 | 434 | |
0439c5a4 EGE |
435 | GLOBAL_STATE_CODE(); |
436 | ||
35b7f4ab KW |
437 | /* |
438 | * blk_new_open() is mainly used in .bdrv_create implementations and the | |
439 | * tools where sharing isn't a major concern because the BDS stays private | |
440 | * and the file is generally not supposed to be used by a second process, | |
441 | * so we just request permission according to the flags. | |
c62d32f5 KW |
442 | * |
443 | * The exceptions are xen_disk and blockdev_init(); in these cases, the | |
444 | * caller of blk_new_open() doesn't make use of the permissions, but they | |
445 | * shouldn't hurt either. We can still share everything here because the | |
35b7f4ab KW |
446 | * guest devices will add their own blockers if they can't share. |
447 | */ | |
1f4ad7d3 KW |
448 | if ((flags & BDRV_O_NO_IO) == 0) { |
449 | perm |= BLK_PERM_CONSISTENT_READ; | |
450 | if (flags & BDRV_O_RDWR) { | |
451 | perm |= BLK_PERM_WRITE; | |
452 | } | |
c62d32f5 KW |
453 | } |
454 | if (flags & BDRV_O_RESIZE) { | |
455 | perm |= BLK_PERM_RESIZE; | |
456 | } | |
35b7f4ab KW |
457 | if (flags & BDRV_O_NO_SHARE) { |
458 | shared = BLK_PERM_CONSISTENT_READ | BLK_PERM_WRITE_UNCHANGED; | |
459 | } | |
ca49a4fd | 460 | |
c6e0a6de | 461 | aio_context_acquire(qemu_get_aio_context()); |
5b363937 | 462 | bs = bdrv_open(filename, reference, options, flags, errp); |
c6e0a6de | 463 | aio_context_release(qemu_get_aio_context()); |
5b363937 | 464 | if (!bs) { |
ca49a4fd HR |
465 | return NULL; |
466 | } | |
467 | ||
4c20dd24 KW |
468 | /* bdrv_open() could have moved bs to a different AioContext */ |
469 | ctx = bdrv_get_aio_context(bs); | |
470 | blk = blk_new(bdrv_get_aio_context(bs), perm, shared); | |
471 | blk->perm = perm; | |
472 | blk->shared_perm = shared; | |
473 | ||
474 | aio_context_acquire(ctx); | |
475 | blk_insert_bs(blk, bs, errp); | |
476 | bdrv_unref(bs); | |
477 | aio_context_release(ctx); | |
478 | ||
50bfbe93 | 479 | if (!blk->root) { |
50bfbe93 FZ |
480 | blk_unref(blk); |
481 | return NULL; | |
482 | } | |
72e775c7 | 483 | |
ca49a4fd HR |
484 | return blk; |
485 | } | |
486 | ||
26f54e9a MA |
487 | static void blk_delete(BlockBackend *blk) |
488 | { | |
489 | assert(!blk->refcnt); | |
e5e78550 | 490 | assert(!blk->name); |
a7f53e26 | 491 | assert(!blk->dev); |
022cdc9f | 492 | if (blk->public.throttle_group_member.throttle_state) { |
1606e4cf EB |
493 | blk_io_limits_disable(blk); |
494 | } | |
f21d96d0 | 495 | if (blk->root) { |
13855c6b | 496 | blk_remove_bs(blk); |
7e7d56d9 | 497 | } |
5f7772c4 FZ |
498 | if (blk->vmsh) { |
499 | qemu_del_vm_change_state_handler(blk->vmsh); | |
500 | blk->vmsh = NULL; | |
501 | } | |
3301f6c6 HR |
502 | assert(QLIST_EMPTY(&blk->remove_bs_notifiers.notifiers)); |
503 | assert(QLIST_EMPTY(&blk->insert_bs_notifiers.notifiers)); | |
d03654ea | 504 | assert(QLIST_EMPTY(&blk->aio_notifiers)); |
407ae2ae SH |
505 | assert(qemu_co_queue_empty(&blk->queued_requests)); |
506 | qemu_mutex_destroy(&blk->queued_requests_lock); | |
2cf22d6a | 507 | QTAILQ_REMOVE(&block_backends, blk, link); |
18e46a03 | 508 | drive_info_del(blk->legacy_dinfo); |
979e9b03 | 509 | block_acct_cleanup(&blk->stats); |
26f54e9a MA |
510 | g_free(blk); |
511 | } | |
512 | ||
8fb3c76c MA |
513 | static void drive_info_del(DriveInfo *dinfo) |
514 | { | |
515 | if (!dinfo) { | |
516 | return; | |
517 | } | |
518 | qemu_opts_del(dinfo->opts); | |
8fb3c76c MA |
519 | g_free(dinfo); |
520 | } | |
521 | ||
f636ae85 AG |
522 | int blk_get_refcnt(BlockBackend *blk) |
523 | { | |
0439c5a4 | 524 | GLOBAL_STATE_CODE(); |
f636ae85 AG |
525 | return blk ? blk->refcnt : 0; |
526 | } | |
527 | ||
26f54e9a MA |
528 | /* |
529 | * Increment @blk's reference count. | |
530 | * @blk must not be null. | |
531 | */ | |
532 | void blk_ref(BlockBackend *blk) | |
533 | { | |
5ca9d21b | 534 | assert(blk->refcnt > 0); |
0439c5a4 | 535 | GLOBAL_STATE_CODE(); |
26f54e9a MA |
536 | blk->refcnt++; |
537 | } | |
538 | ||
539 | /* | |
540 | * Decrement @blk's reference count. | |
541 | * If this drops it to zero, destroy @blk. | |
542 | * For convenience, do nothing if @blk is null. | |
543 | */ | |
544 | void blk_unref(BlockBackend *blk) | |
545 | { | |
0439c5a4 | 546 | GLOBAL_STATE_CODE(); |
26f54e9a MA |
547 | if (blk) { |
548 | assert(blk->refcnt > 0); | |
5ca9d21b KW |
549 | if (blk->refcnt > 1) { |
550 | blk->refcnt--; | |
551 | } else { | |
552 | blk_drain(blk); | |
553 | /* blk_drain() cannot resurrect blk, nobody held a reference */ | |
554 | assert(blk->refcnt == 1); | |
555 | blk->refcnt = 0; | |
26f54e9a MA |
556 | blk_delete(blk); |
557 | } | |
558 | } | |
559 | } | |
560 | ||
2cf22d6a HR |
561 | /* |
562 | * Behaves similarly to blk_next() but iterates over all BlockBackends, even the | |
563 | * ones which are hidden (i.e. are not referenced by the monitor). | |
564 | */ | |
a429b9b5 | 565 | BlockBackend *blk_all_next(BlockBackend *blk) |
2cf22d6a | 566 | { |
0439c5a4 | 567 | GLOBAL_STATE_CODE(); |
2cf22d6a HR |
568 | return blk ? QTAILQ_NEXT(blk, link) |
569 | : QTAILQ_FIRST(&block_backends); | |
570 | } | |
571 | ||
d8da3cef HR |
572 | void blk_remove_all_bs(void) |
573 | { | |
74d1b8fc | 574 | BlockBackend *blk = NULL; |
d8da3cef | 575 | |
0439c5a4 EGE |
576 | GLOBAL_STATE_CODE(); |
577 | ||
2cf22d6a | 578 | while ((blk = blk_all_next(blk)) != NULL) { |
d8da3cef HR |
579 | AioContext *ctx = blk_get_aio_context(blk); |
580 | ||
581 | aio_context_acquire(ctx); | |
f21d96d0 | 582 | if (blk->root) { |
d8da3cef HR |
583 | blk_remove_bs(blk); |
584 | } | |
585 | aio_context_release(ctx); | |
586 | } | |
587 | } | |
588 | ||
26f54e9a | 589 | /* |
9492b0b9 | 590 | * Return the monitor-owned BlockBackend after @blk. |
26f54e9a MA |
591 | * If @blk is null, return the first one. |
592 | * Else, return @blk's next sibling, which may be null. | |
593 | * | |
594 | * To iterate over all BlockBackends, do | |
595 | * for (blk = blk_next(NULL); blk; blk = blk_next(blk)) { | |
596 | * ... | |
597 | * } | |
598 | */ | |
599 | BlockBackend *blk_next(BlockBackend *blk) | |
600 | { | |
0439c5a4 | 601 | GLOBAL_STATE_CODE(); |
9492b0b9 HR |
602 | return blk ? QTAILQ_NEXT(blk, monitor_link) |
603 | : QTAILQ_FIRST(&monitor_block_backends); | |
26f54e9a MA |
604 | } |
605 | ||
7c8eece4 KW |
606 | /* Iterates over all top-level BlockDriverStates, i.e. BDSs that are owned by |
607 | * the monitor or attached to a BlockBackend */ | |
88be7b4b | 608 | BlockDriverState *bdrv_next(BdrvNextIterator *it) |
7c8eece4 | 609 | { |
5e003f17 HR |
610 | BlockDriverState *bs, *old_bs; |
611 | ||
612 | /* Must be called from the main loop */ | |
613 | assert(qemu_get_current_aio_context() == qemu_get_aio_context()); | |
981f4f57 | 614 | |
7c8eece4 KW |
615 | /* First, return all root nodes of BlockBackends. In order to avoid |
616 | * returning a BDS twice when multiple BBs refer to it, we only return it | |
617 | * if the BB is the first one in the parent list of the BDS. */ | |
618 | if (it->phase == BDRV_NEXT_BACKEND_ROOTS) { | |
5e003f17 HR |
619 | BlockBackend *old_blk = it->blk; |
620 | ||
621 | old_bs = old_blk ? blk_bs(old_blk) : NULL; | |
622 | ||
7c8eece4 KW |
623 | do { |
624 | it->blk = blk_all_next(it->blk); | |
88be7b4b KW |
625 | bs = it->blk ? blk_bs(it->blk) : NULL; |
626 | } while (it->blk && (bs == NULL || bdrv_first_blk(bs) != it->blk)); | |
7c8eece4 | 627 | |
5e003f17 HR |
628 | if (it->blk) { |
629 | blk_ref(it->blk); | |
630 | } | |
631 | blk_unref(old_blk); | |
632 | ||
88be7b4b | 633 | if (bs) { |
5e003f17 HR |
634 | bdrv_ref(bs); |
635 | bdrv_unref(old_bs); | |
88be7b4b | 636 | return bs; |
7c8eece4 KW |
637 | } |
638 | it->phase = BDRV_NEXT_MONITOR_OWNED; | |
5e003f17 HR |
639 | } else { |
640 | old_bs = it->bs; | |
7c8eece4 KW |
641 | } |
642 | ||
643 | /* Then return the monitor-owned BDSes without a BB attached. Ignore all | |
644 | * BDSes that are attached to a BlockBackend here; they have been handled | |
645 | * by the above block already */ | |
981f4f57 | 646 | do { |
7c8eece4 | 647 | it->bs = bdrv_next_monitor_owned(it->bs); |
88be7b4b KW |
648 | bs = it->bs; |
649 | } while (bs && bdrv_has_blk(bs)); | |
650 | ||
5e003f17 HR |
651 | if (bs) { |
652 | bdrv_ref(bs); | |
653 | } | |
654 | bdrv_unref(old_bs); | |
655 | ||
88be7b4b KW |
656 | return bs; |
657 | } | |
658 | ||
5e003f17 | 659 | static void bdrv_next_reset(BdrvNextIterator *it) |
88be7b4b KW |
660 | { |
661 | *it = (BdrvNextIterator) { | |
662 | .phase = BDRV_NEXT_BACKEND_ROOTS, | |
663 | }; | |
5e003f17 | 664 | } |
981f4f57 | 665 | |
5e003f17 HR |
666 | BlockDriverState *bdrv_first(BdrvNextIterator *it) |
667 | { | |
0439c5a4 | 668 | GLOBAL_STATE_CODE(); |
5e003f17 | 669 | bdrv_next_reset(it); |
88be7b4b | 670 | return bdrv_next(it); |
981f4f57 HR |
671 | } |
672 | ||
5e003f17 HR |
673 | /* Must be called when aborting a bdrv_next() iteration before |
674 | * bdrv_next() returns NULL */ | |
675 | void bdrv_next_cleanup(BdrvNextIterator *it) | |
676 | { | |
677 | /* Must be called from the main loop */ | |
678 | assert(qemu_get_current_aio_context() == qemu_get_aio_context()); | |
679 | ||
680 | if (it->phase == BDRV_NEXT_BACKEND_ROOTS) { | |
681 | if (it->blk) { | |
682 | bdrv_unref(blk_bs(it->blk)); | |
683 | blk_unref(it->blk); | |
684 | } | |
685 | } else { | |
686 | bdrv_unref(it->bs); | |
687 | } | |
688 | ||
689 | bdrv_next_reset(it); | |
690 | } | |
691 | ||
e5e78550 HR |
692 | /* |
693 | * Add a BlockBackend into the list of backends referenced by the monitor, with | |
694 | * the given @name acting as the handle for the monitor. | |
695 | * Strictly for use by blockdev.c. | |
696 | * | |
697 | * @name must not be null or empty. | |
698 | * | |
699 | * Returns true on success and false on failure. In the latter case, an Error | |
700 | * object is returned through @errp. | |
701 | */ | |
702 | bool monitor_add_blk(BlockBackend *blk, const char *name, Error **errp) | |
703 | { | |
704 | assert(!blk->name); | |
705 | assert(name && name[0]); | |
0439c5a4 | 706 | GLOBAL_STATE_CODE(); |
e5e78550 HR |
707 | |
708 | if (!id_wellformed(name)) { | |
709 | error_setg(errp, "Invalid device name"); | |
710 | return false; | |
711 | } | |
712 | if (blk_by_name(name)) { | |
713 | error_setg(errp, "Device with id '%s' already exists", name); | |
714 | return false; | |
715 | } | |
716 | if (bdrv_find_node(name)) { | |
717 | error_setg(errp, | |
718 | "Device name '%s' conflicts with an existing node name", | |
719 | name); | |
720 | return false; | |
721 | } | |
722 | ||
723 | blk->name = g_strdup(name); | |
724 | QTAILQ_INSERT_TAIL(&monitor_block_backends, blk, monitor_link); | |
725 | return true; | |
726 | } | |
727 | ||
728 | /* | |
729 | * Remove a BlockBackend from the list of backends referenced by the monitor. | |
730 | * Strictly for use by blockdev.c. | |
731 | */ | |
732 | void monitor_remove_blk(BlockBackend *blk) | |
733 | { | |
0439c5a4 EGE |
734 | GLOBAL_STATE_CODE(); |
735 | ||
e5e78550 HR |
736 | if (!blk->name) { |
737 | return; | |
738 | } | |
739 | ||
740 | QTAILQ_REMOVE(&monitor_block_backends, blk, monitor_link); | |
741 | g_free(blk->name); | |
742 | blk->name = NULL; | |
743 | } | |
744 | ||
26f54e9a | 745 | /* |
7e7d56d9 | 746 | * Return @blk's name, a non-null string. |
e5e78550 | 747 | * Returns an empty string iff @blk is not referenced by the monitor. |
26f54e9a | 748 | */ |
0731a50f | 749 | const char *blk_name(const BlockBackend *blk) |
26f54e9a | 750 | { |
37868b2a | 751 | IO_CODE(); |
e5e78550 | 752 | return blk->name ?: ""; |
26f54e9a MA |
753 | } |
754 | ||
755 | /* | |
756 | * Return the BlockBackend with name @name if it exists, else null. | |
757 | * @name must not be null. | |
758 | */ | |
759 | BlockBackend *blk_by_name(const char *name) | |
760 | { | |
74d1b8fc | 761 | BlockBackend *blk = NULL; |
26f54e9a | 762 | |
0439c5a4 | 763 | GLOBAL_STATE_CODE(); |
26f54e9a | 764 | assert(name); |
74d1b8fc | 765 | while ((blk = blk_next(blk)) != NULL) { |
26f54e9a MA |
766 | if (!strcmp(name, blk->name)) { |
767 | return blk; | |
768 | } | |
769 | } | |
770 | return NULL; | |
771 | } | |
7e7d56d9 MA |
772 | |
773 | /* | |
774 | * Return the BlockDriverState attached to @blk if any, else null. | |
775 | */ | |
776 | BlockDriverState *blk_bs(BlockBackend *blk) | |
777 | { | |
37868b2a | 778 | IO_CODE(); |
f21d96d0 | 779 | return blk->root ? blk->root->bs : NULL; |
7e7d56d9 MA |
780 | } |
781 | ||
7c8eece4 | 782 | static BlockBackend *bdrv_first_blk(BlockDriverState *bs) |
dde33812 KW |
783 | { |
784 | BdrvChild *child; | |
bdb73476 EGE |
785 | |
786 | GLOBAL_STATE_CODE(); | |
787 | ||
dde33812 | 788 | QLIST_FOREACH(child, &bs->parents, next_parent) { |
bd86fb99 | 789 | if (child->klass == &child_root) { |
7c8eece4 | 790 | return child->opaque; |
dde33812 KW |
791 | } |
792 | } | |
793 | ||
7c8eece4 KW |
794 | return NULL; |
795 | } | |
796 | ||
797 | /* | |
798 | * Returns true if @bs has an associated BlockBackend. | |
799 | */ | |
800 | bool bdrv_has_blk(BlockDriverState *bs) | |
801 | { | |
0439c5a4 | 802 | GLOBAL_STATE_CODE(); |
7c8eece4 | 803 | return bdrv_first_blk(bs) != NULL; |
dde33812 KW |
804 | } |
805 | ||
b6c1bae5 KW |
806 | /* |
807 | * Returns true if @bs has only BlockBackends as parents. | |
808 | */ | |
809 | bool bdrv_is_root_node(BlockDriverState *bs) | |
810 | { | |
811 | BdrvChild *c; | |
812 | ||
0439c5a4 | 813 | GLOBAL_STATE_CODE(); |
b6c1bae5 | 814 | QLIST_FOREACH(c, &bs->parents, next_parent) { |
bd86fb99 | 815 | if (c->klass != &child_root) { |
b6c1bae5 KW |
816 | return false; |
817 | } | |
818 | } | |
819 | ||
820 | return true; | |
821 | } | |
822 | ||
18e46a03 MA |
823 | /* |
824 | * Return @blk's DriveInfo if any, else null. | |
825 | */ | |
826 | DriveInfo *blk_legacy_dinfo(BlockBackend *blk) | |
827 | { | |
c5be7445 | 828 | GLOBAL_STATE_CODE(); |
18e46a03 MA |
829 | return blk->legacy_dinfo; |
830 | } | |
831 | ||
832 | /* | |
833 | * Set @blk's DriveInfo to @dinfo, and return it. | |
834 | * @blk must not have a DriveInfo set already. | |
835 | * No other BlockBackend may have the same DriveInfo set. | |
836 | */ | |
837 | DriveInfo *blk_set_legacy_dinfo(BlockBackend *blk, DriveInfo *dinfo) | |
838 | { | |
839 | assert(!blk->legacy_dinfo); | |
c5be7445 | 840 | GLOBAL_STATE_CODE(); |
18e46a03 MA |
841 | return blk->legacy_dinfo = dinfo; |
842 | } | |
843 | ||
844 | /* | |
845 | * Return the BlockBackend with DriveInfo @dinfo. | |
846 | * It must exist. | |
847 | */ | |
848 | BlockBackend *blk_by_legacy_dinfo(DriveInfo *dinfo) | |
849 | { | |
74d1b8fc | 850 | BlockBackend *blk = NULL; |
c5be7445 | 851 | GLOBAL_STATE_CODE(); |
18e46a03 | 852 | |
74d1b8fc | 853 | while ((blk = blk_next(blk)) != NULL) { |
18e46a03 MA |
854 | if (blk->legacy_dinfo == dinfo) { |
855 | return blk; | |
856 | } | |
857 | } | |
858 | abort(); | |
859 | } | |
860 | ||
f2cd875d KW |
861 | /* |
862 | * Returns a pointer to the publicly accessible fields of @blk. | |
863 | */ | |
864 | BlockBackendPublic *blk_get_public(BlockBackend *blk) | |
865 | { | |
0439c5a4 | 866 | GLOBAL_STATE_CODE(); |
f2cd875d KW |
867 | return &blk->public; |
868 | } | |
869 | ||
870 | /* | |
871 | * Returns a BlockBackend given the associated @public fields. | |
872 | */ | |
873 | BlockBackend *blk_by_public(BlockBackendPublic *public) | |
874 | { | |
0439c5a4 | 875 | GLOBAL_STATE_CODE(); |
f2cd875d KW |
876 | return container_of(public, BlockBackend, public); |
877 | } | |
878 | ||
1c95f7e1 HR |
879 | /* |
880 | * Disassociates the currently associated BlockDriverState from @blk. | |
881 | */ | |
882 | void blk_remove_bs(BlockBackend *blk) | |
883 | { | |
c89bcf3a | 884 | ThrottleGroupMember *tgm = &blk->public.throttle_group_member; |
e6cada92 | 885 | BdrvChild *root; |
022cdc9f | 886 | |
0439c5a4 EGE |
887 | GLOBAL_STATE_CODE(); |
888 | ||
3301f6c6 | 889 | notifier_list_notify(&blk->remove_bs_notifiers, blk); |
c89bcf3a | 890 | if (tgm->throttle_state) { |
1e3552db SH |
891 | BlockDriverState *bs = blk_bs(blk); |
892 | ||
893 | /* | |
894 | * Take a ref in case blk_bs() changes across bdrv_drained_begin(), for | |
895 | * example, if a temporary filter node is removed by a blockjob. | |
896 | */ | |
897 | bdrv_ref(bs); | |
632a7735 | 898 | bdrv_drained_begin(bs); |
c89bcf3a AG |
899 | throttle_group_detach_aio_context(tgm); |
900 | throttle_group_attach_aio_context(tgm, qemu_get_aio_context()); | |
632a7735 | 901 | bdrv_drained_end(bs); |
1e3552db | 902 | bdrv_unref(bs); |
a5614993 | 903 | } |
1c95f7e1 | 904 | |
7ca7f0f6 KW |
905 | blk_update_root_state(blk); |
906 | ||
f45280cb GK |
907 | /* bdrv_root_unref_child() will cause blk->root to become stale and may |
908 | * switch to a completion coroutine later on. Let's drain all I/O here | |
909 | * to avoid that and a potential QEMU crash. | |
910 | */ | |
911 | blk_drain(blk); | |
e6cada92 | 912 | root = blk->root; |
f21d96d0 | 913 | blk->root = NULL; |
e6cada92 | 914 | bdrv_root_unref_child(root); |
1c95f7e1 HR |
915 | } |
916 | ||
0c3c36d6 HR |
917 | /* |
918 | * Associates a new BlockDriverState with @blk. | |
4c20dd24 KW |
919 | * |
920 | * Callers must hold the AioContext lock of @bs. | |
0c3c36d6 | 921 | */ |
d7086422 | 922 | int blk_insert_bs(BlockBackend *blk, BlockDriverState *bs, Error **errp) |
0c3c36d6 | 923 | { |
c89bcf3a | 924 | ThrottleGroupMember *tgm = &blk->public.throttle_group_member; |
0439c5a4 | 925 | GLOBAL_STATE_CODE(); |
b441dc71 | 926 | bdrv_ref(bs); |
1f38f04e HR |
927 | blk->root = bdrv_root_attach_child(bs, "root", &child_root, |
928 | BDRV_CHILD_FILTERED | BDRV_CHILD_PRIMARY, | |
228ca37e | 929 | blk->perm, blk->shared_perm, |
1f38f04e | 930 | blk, errp); |
d7086422 KW |
931 | if (blk->root == NULL) { |
932 | return -EPERM; | |
933 | } | |
3301f6c6 HR |
934 | |
935 | notifier_list_notify(&blk->insert_bs_notifiers, blk); | |
c89bcf3a AG |
936 | if (tgm->throttle_state) { |
937 | throttle_group_detach_aio_context(tgm); | |
938 | throttle_group_attach_aio_context(tgm, bdrv_get_aio_context(bs)); | |
7ca7f0f6 | 939 | } |
d7086422 KW |
940 | |
941 | return 0; | |
0c3c36d6 HR |
942 | } |
943 | ||
ed089506 VSO |
944 | /* |
945 | * Change BlockDriverState associated with @blk. | |
946 | */ | |
947 | int blk_replace_bs(BlockBackend *blk, BlockDriverState *new_bs, Error **errp) | |
948 | { | |
0439c5a4 | 949 | GLOBAL_STATE_CODE(); |
ed089506 VSO |
950 | return bdrv_replace_child_bs(blk->root, new_bs, errp); |
951 | } | |
952 | ||
981776b3 KW |
953 | /* |
954 | * Sets the permission bitmasks that the user of the BlockBackend needs. | |
955 | */ | |
956 | int blk_set_perm(BlockBackend *blk, uint64_t perm, uint64_t shared_perm, | |
957 | Error **errp) | |
958 | { | |
959 | int ret; | |
0439c5a4 | 960 | GLOBAL_STATE_CODE(); |
981776b3 | 961 | |
d35ff5e6 | 962 | if (blk->root && !blk->disable_perm) { |
981776b3 KW |
963 | ret = bdrv_child_try_set_perm(blk->root, perm, shared_perm, errp); |
964 | if (ret < 0) { | |
965 | return ret; | |
966 | } | |
967 | } | |
968 | ||
969 | blk->perm = perm; | |
970 | blk->shared_perm = shared_perm; | |
971 | ||
972 | return 0; | |
973 | } | |
974 | ||
887354bd KW |
975 | void blk_get_perm(BlockBackend *blk, uint64_t *perm, uint64_t *shared_perm) |
976 | { | |
0439c5a4 | 977 | GLOBAL_STATE_CODE(); |
887354bd KW |
978 | *perm = blk->perm; |
979 | *shared_perm = blk->shared_perm; | |
980 | } | |
981 | ||
d09ea2d2 TH |
982 | /* |
983 | * Attach device model @dev to @blk. | |
984 | * Return 0 on success, -EBUSY when a device model is attached already. | |
985 | */ | |
986 | int blk_attach_dev(BlockBackend *blk, DeviceState *dev) | |
4be74634 | 987 | { |
0439c5a4 | 988 | GLOBAL_STATE_CODE(); |
a7f53e26 MA |
989 | if (blk->dev) { |
990 | return -EBUSY; | |
991 | } | |
d35ff5e6 KW |
992 | |
993 | /* While migration is still incoming, we don't need to apply the | |
994 | * permissions of guest device BlockBackends. We might still have a block | |
995 | * job or NBD server writing to the image for storage migration. */ | |
996 | if (runstate_check(RUN_STATE_INMIGRATE)) { | |
997 | blk->disable_perm = true; | |
998 | } | |
999 | ||
84ebe375 | 1000 | blk_ref(blk); |
a7f53e26 | 1001 | blk->dev = dev; |
373340b2 | 1002 | blk_iostatus_reset(blk); |
d35ff5e6 | 1003 | |
a7f53e26 | 1004 | return 0; |
4be74634 MA |
1005 | } |
1006 | ||
a7f53e26 MA |
1007 | /* |
1008 | * Detach device model @dev from @blk. | |
1009 | * @dev must be currently attached to @blk. | |
1010 | */ | |
d09ea2d2 | 1011 | void blk_detach_dev(BlockBackend *blk, DeviceState *dev) |
4be74634 | 1012 | { |
a7f53e26 | 1013 | assert(blk->dev == dev); |
0439c5a4 | 1014 | GLOBAL_STATE_CODE(); |
a7f53e26 MA |
1015 | blk->dev = NULL; |
1016 | blk->dev_ops = NULL; | |
1017 | blk->dev_opaque = NULL; | |
981776b3 | 1018 | blk_set_perm(blk, 0, BLK_PERM_ALL, &error_abort); |
84ebe375 | 1019 | blk_unref(blk); |
4be74634 MA |
1020 | } |
1021 | ||
a7f53e26 MA |
1022 | /* |
1023 | * Return the device model attached to @blk if any, else null. | |
1024 | */ | |
d09ea2d2 | 1025 | DeviceState *blk_get_attached_dev(BlockBackend *blk) |
a7f53e26 | 1026 | { |
0439c5a4 | 1027 | GLOBAL_STATE_CODE(); |
a7f53e26 MA |
1028 | return blk->dev; |
1029 | } | |
1030 | ||
2d76e724 KW |
1031 | /* Return the qdev ID, or if no ID is assigned the QOM path, of the block |
1032 | * device attached to the BlockBackend. */ | |
77beef83 | 1033 | char *blk_get_attached_dev_id(BlockBackend *blk) |
2d76e724 | 1034 | { |
d09ea2d2 | 1035 | DeviceState *dev = blk->dev; |
37868b2a | 1036 | IO_CODE(); |
2d76e724 KW |
1037 | |
1038 | if (!dev) { | |
1039 | return g_strdup(""); | |
1040 | } else if (dev->id) { | |
1041 | return g_strdup(dev->id); | |
1042 | } | |
602414d1 LM |
1043 | |
1044 | return object_get_canonical_path(OBJECT(dev)) ?: g_strdup(""); | |
2d76e724 KW |
1045 | } |
1046 | ||
1c89e1fa KW |
1047 | /* |
1048 | * Return the BlockBackend which has the device model @dev attached if it | |
1049 | * exists, else null. | |
1050 | * | |
1051 | * @dev must not be null. | |
1052 | */ | |
1053 | BlockBackend *blk_by_dev(void *dev) | |
1054 | { | |
1055 | BlockBackend *blk = NULL; | |
1056 | ||
0439c5a4 EGE |
1057 | GLOBAL_STATE_CODE(); |
1058 | ||
1c89e1fa KW |
1059 | assert(dev != NULL); |
1060 | while ((blk = blk_all_next(blk)) != NULL) { | |
1061 | if (blk->dev == dev) { | |
1062 | return blk; | |
1063 | } | |
1064 | } | |
1065 | return NULL; | |
1066 | } | |
1067 | ||
a7f53e26 MA |
1068 | /* |
1069 | * Set @blk's device model callbacks to @ops. | |
1070 | * @opaque is the opaque argument to pass to the callbacks. | |
1071 | * This is for use by device models. | |
1072 | */ | |
1073 | void blk_set_dev_ops(BlockBackend *blk, const BlockDevOps *ops, | |
1074 | void *opaque) | |
1075 | { | |
0439c5a4 | 1076 | GLOBAL_STATE_CODE(); |
a7f53e26 MA |
1077 | blk->dev_ops = ops; |
1078 | blk->dev_opaque = opaque; | |
f4d9cc88 JS |
1079 | |
1080 | /* Are we currently quiesced? Should we enforce this right now? */ | |
c4d5bf99 | 1081 | if (qatomic_read(&blk->quiesce_counter) && ops && ops->drained_begin) { |
f4d9cc88 JS |
1082 | ops->drained_begin(opaque); |
1083 | } | |
a7f53e26 MA |
1084 | } |
1085 | ||
1086 | /* | |
1087 | * Notify @blk's attached device model of media change. | |
39829a01 KW |
1088 | * |
1089 | * If @load is true, notify of media load. This action can fail, meaning that | |
1090 | * the medium cannot be loaded. @errp is set then. | |
1091 | * | |
1092 | * If @load is false, notify of media eject. This can never fail. | |
1093 | * | |
a7f53e26 MA |
1094 | * Also send DEVICE_TRAY_MOVED events as appropriate. |
1095 | */ | |
39829a01 | 1096 | void blk_dev_change_media_cb(BlockBackend *blk, bool load, Error **errp) |
a7f53e26 | 1097 | { |
0439c5a4 | 1098 | GLOBAL_STATE_CODE(); |
a7f53e26 | 1099 | if (blk->dev_ops && blk->dev_ops->change_media_cb) { |
f1f57066 | 1100 | bool tray_was_open, tray_is_open; |
39829a01 | 1101 | Error *local_err = NULL; |
a7f53e26 | 1102 | |
f1f57066 | 1103 | tray_was_open = blk_dev_is_tray_open(blk); |
39829a01 KW |
1104 | blk->dev_ops->change_media_cb(blk->dev_opaque, load, &local_err); |
1105 | if (local_err) { | |
1106 | assert(load == true); | |
1107 | error_propagate(errp, local_err); | |
1108 | return; | |
1109 | } | |
f1f57066 HR |
1110 | tray_is_open = blk_dev_is_tray_open(blk); |
1111 | ||
1112 | if (tray_was_open != tray_is_open) { | |
2d76e724 | 1113 | char *id = blk_get_attached_dev_id(blk); |
3ab72385 | 1114 | qapi_event_send_device_tray_moved(blk_name(blk), id, tray_is_open); |
2d76e724 | 1115 | g_free(id); |
a7f53e26 MA |
1116 | } |
1117 | } | |
1118 | } | |
1119 | ||
5c8cab48 KW |
1120 | static void blk_root_change_media(BdrvChild *child, bool load) |
1121 | { | |
39829a01 | 1122 | blk_dev_change_media_cb(child->opaque, load, NULL); |
5c8cab48 KW |
1123 | } |
1124 | ||
a7f53e26 MA |
1125 | /* |
1126 | * Does @blk's attached device model have removable media? | |
1127 | * %true if no device model is attached. | |
1128 | */ | |
1129 | bool blk_dev_has_removable_media(BlockBackend *blk) | |
1130 | { | |
b4ad82aa | 1131 | GLOBAL_STATE_CODE(); |
a7f53e26 MA |
1132 | return !blk->dev || (blk->dev_ops && blk->dev_ops->change_media_cb); |
1133 | } | |
1134 | ||
8f3a73bc HR |
1135 | /* |
1136 | * Does @blk's attached device model have a tray? | |
1137 | */ | |
1138 | bool blk_dev_has_tray(BlockBackend *blk) | |
1139 | { | |
967d7905 | 1140 | IO_CODE(); |
8f3a73bc HR |
1141 | return blk->dev_ops && blk->dev_ops->is_tray_open; |
1142 | } | |
1143 | ||
a7f53e26 MA |
1144 | /* |
1145 | * Notify @blk's attached device model of a media eject request. | |
1146 | * If @force is true, the medium is about to be yanked out forcefully. | |
1147 | */ | |
1148 | void blk_dev_eject_request(BlockBackend *blk, bool force) | |
4be74634 | 1149 | { |
b4ad82aa | 1150 | GLOBAL_STATE_CODE(); |
a7f53e26 MA |
1151 | if (blk->dev_ops && blk->dev_ops->eject_request_cb) { |
1152 | blk->dev_ops->eject_request_cb(blk->dev_opaque, force); | |
1153 | } | |
4be74634 MA |
1154 | } |
1155 | ||
a7f53e26 MA |
1156 | /* |
1157 | * Does @blk's attached device model have a tray, and is it open? | |
1158 | */ | |
1159 | bool blk_dev_is_tray_open(BlockBackend *blk) | |
4be74634 | 1160 | { |
967d7905 | 1161 | IO_CODE(); |
8f3a73bc | 1162 | if (blk_dev_has_tray(blk)) { |
a7f53e26 MA |
1163 | return blk->dev_ops->is_tray_open(blk->dev_opaque); |
1164 | } | |
1165 | return false; | |
1166 | } | |
1167 | ||
1168 | /* | |
1169 | * Does @blk's attached device model have the medium locked? | |
1170 | * %false if the device model has no such lock. | |
1171 | */ | |
1172 | bool blk_dev_is_medium_locked(BlockBackend *blk) | |
1173 | { | |
b4ad82aa | 1174 | GLOBAL_STATE_CODE(); |
a7f53e26 MA |
1175 | if (blk->dev_ops && blk->dev_ops->is_medium_locked) { |
1176 | return blk->dev_ops->is_medium_locked(blk->dev_opaque); | |
1177 | } | |
1178 | return false; | |
1179 | } | |
1180 | ||
1181 | /* | |
1182 | * Notify @blk's attached device model of a backend size change. | |
1183 | */ | |
5c8cab48 | 1184 | static void blk_root_resize(BdrvChild *child) |
a7f53e26 | 1185 | { |
5c8cab48 KW |
1186 | BlockBackend *blk = child->opaque; |
1187 | ||
a7f53e26 MA |
1188 | if (blk->dev_ops && blk->dev_ops->resize_cb) { |
1189 | blk->dev_ops->resize_cb(blk->dev_opaque); | |
1190 | } | |
1191 | } | |
1192 | ||
1193 | void blk_iostatus_enable(BlockBackend *blk) | |
1194 | { | |
0439c5a4 | 1195 | GLOBAL_STATE_CODE(); |
373340b2 HR |
1196 | blk->iostatus_enabled = true; |
1197 | blk->iostatus = BLOCK_DEVICE_IO_STATUS_OK; | |
1198 | } | |
1199 | ||
1200 | /* The I/O status is only enabled if the drive explicitly | |
1201 | * enables it _and_ the VM is configured to stop on errors */ | |
1202 | bool blk_iostatus_is_enabled(const BlockBackend *blk) | |
1203 | { | |
37868b2a | 1204 | IO_CODE(); |
373340b2 HR |
1205 | return (blk->iostatus_enabled && |
1206 | (blk->on_write_error == BLOCKDEV_ON_ERROR_ENOSPC || | |
1207 | blk->on_write_error == BLOCKDEV_ON_ERROR_STOP || | |
1208 | blk->on_read_error == BLOCKDEV_ON_ERROR_STOP)); | |
1209 | } | |
1210 | ||
1211 | BlockDeviceIoStatus blk_iostatus(const BlockBackend *blk) | |
1212 | { | |
0439c5a4 | 1213 | GLOBAL_STATE_CODE(); |
373340b2 HR |
1214 | return blk->iostatus; |
1215 | } | |
1216 | ||
1217 | void blk_iostatus_disable(BlockBackend *blk) | |
1218 | { | |
0439c5a4 | 1219 | GLOBAL_STATE_CODE(); |
373340b2 HR |
1220 | blk->iostatus_enabled = false; |
1221 | } | |
1222 | ||
1223 | void blk_iostatus_reset(BlockBackend *blk) | |
1224 | { | |
0439c5a4 | 1225 | GLOBAL_STATE_CODE(); |
373340b2 HR |
1226 | if (blk_iostatus_is_enabled(blk)) { |
1227 | blk->iostatus = BLOCK_DEVICE_IO_STATUS_OK; | |
373340b2 HR |
1228 | } |
1229 | } | |
1230 | ||
1231 | void blk_iostatus_set_err(BlockBackend *blk, int error) | |
1232 | { | |
37868b2a | 1233 | IO_CODE(); |
373340b2 HR |
1234 | assert(blk_iostatus_is_enabled(blk)); |
1235 | if (blk->iostatus == BLOCK_DEVICE_IO_STATUS_OK) { | |
1236 | blk->iostatus = error == ENOSPC ? BLOCK_DEVICE_IO_STATUS_NOSPACE : | |
1237 | BLOCK_DEVICE_IO_STATUS_FAILED; | |
1238 | } | |
4be74634 MA |
1239 | } |
1240 | ||
c10c9d96 KW |
1241 | void blk_set_allow_write_beyond_eof(BlockBackend *blk, bool allow) |
1242 | { | |
37868b2a | 1243 | IO_CODE(); |
c10c9d96 KW |
1244 | blk->allow_write_beyond_eof = allow; |
1245 | } | |
1246 | ||
980b0f94 KW |
1247 | void blk_set_allow_aio_context_change(BlockBackend *blk, bool allow) |
1248 | { | |
37868b2a | 1249 | IO_CODE(); |
980b0f94 KW |
1250 | blk->allow_aio_context_change = allow; |
1251 | } | |
1252 | ||
cf312932 KW |
1253 | void blk_set_disable_request_queuing(BlockBackend *blk, bool disable) |
1254 | { | |
37868b2a | 1255 | IO_CODE(); |
ef80ec50 | 1256 | qatomic_set(&blk->disable_request_queuing, disable); |
cf312932 KW |
1257 | } |
1258 | ||
c73ff92c EGE |
1259 | static int coroutine_fn GRAPH_RDLOCK |
1260 | blk_check_byte_request(BlockBackend *blk, int64_t offset, int64_t bytes) | |
e7f7d676 HR |
1261 | { |
1262 | int64_t len; | |
1263 | ||
aa78b825 | 1264 | if (bytes < 0) { |
e7f7d676 HR |
1265 | return -EIO; |
1266 | } | |
1267 | ||
c73ff92c | 1268 | if (!blk_co_is_available(blk)) { |
e7f7d676 HR |
1269 | return -ENOMEDIUM; |
1270 | } | |
1271 | ||
e7f7d676 HR |
1272 | if (offset < 0) { |
1273 | return -EIO; | |
1274 | } | |
1275 | ||
c10c9d96 | 1276 | if (!blk->allow_write_beyond_eof) { |
bd53086e | 1277 | len = bdrv_co_getlength(blk_bs(blk)); |
c10c9d96 KW |
1278 | if (len < 0) { |
1279 | return len; | |
1280 | } | |
1281 | ||
7242db63 | 1282 | if (offset > len || len - offset < bytes) { |
c10c9d96 KW |
1283 | return -EIO; |
1284 | } | |
e7f7d676 HR |
1285 | } |
1286 | ||
1287 | return 0; | |
1288 | } | |
1289 | ||
ff82b783 SH |
1290 | /* Are we currently in a drained section? */ |
1291 | bool blk_in_drain(BlockBackend *blk) | |
1292 | { | |
1293 | GLOBAL_STATE_CODE(); /* change to IO_OR_GS_CODE(), if necessary */ | |
1294 | return qatomic_read(&blk->quiesce_counter); | |
1295 | } | |
1296 | ||
7f16476f | 1297 | /* To be called between exactly one pair of blk_inc/dec_in_flight() */ |
cf312932 KW |
1298 | static void coroutine_fn blk_wait_while_drained(BlockBackend *blk) |
1299 | { | |
7f16476f KW |
1300 | assert(blk->in_flight > 0); |
1301 | ||
ef80ec50 SH |
1302 | if (qatomic_read(&blk->quiesce_counter) && |
1303 | !qatomic_read(&blk->disable_request_queuing)) { | |
407ae2ae SH |
1304 | /* |
1305 | * Take lock before decrementing in flight counter so main loop thread | |
1306 | * waits for us to enqueue ourselves before it can leave the drained | |
1307 | * section. | |
1308 | */ | |
1309 | qemu_mutex_lock(&blk->queued_requests_lock); | |
7f16476f | 1310 | blk_dec_in_flight(blk); |
407ae2ae | 1311 | qemu_co_queue_wait(&blk->queued_requests, &blk->queued_requests_lock); |
7f16476f | 1312 | blk_inc_in_flight(blk); |
407ae2ae | 1313 | qemu_mutex_unlock(&blk->queued_requests_lock); |
cf312932 KW |
1314 | } |
1315 | } | |
1316 | ||
fbb92b67 | 1317 | /* To be called between exactly one pair of blk_inc/dec_in_flight() */ |
d1d3fc3d AF |
1318 | static int coroutine_fn |
1319 | blk_co_do_preadv_part(BlockBackend *blk, int64_t offset, int64_t bytes, | |
1320 | QEMUIOVector *qiov, size_t qiov_offset, | |
1321 | BdrvRequestFlags flags) | |
4be74634 | 1322 | { |
1e98fefd | 1323 | int ret; |
cf312932 | 1324 | BlockDriverState *bs; |
1581a70d | 1325 | IO_CODE(); |
1e98fefd | 1326 | |
cf312932 | 1327 | blk_wait_while_drained(blk); |
b9b10c35 | 1328 | GRAPH_RDLOCK_GUARD(); |
1e98fefd | 1329 | |
cf312932 KW |
1330 | /* Call blk_bs() only after waiting, the graph may have changed */ |
1331 | bs = blk_bs(blk); | |
99723548 | 1332 | trace_blk_co_preadv(blk, bs, offset, bytes, flags); |
1e98fefd KW |
1333 | |
1334 | ret = blk_check_byte_request(blk, offset, bytes); | |
e7f7d676 HR |
1335 | if (ret < 0) { |
1336 | return ret; | |
1337 | } | |
1338 | ||
99723548 PB |
1339 | bdrv_inc_in_flight(bs); |
1340 | ||
441565b2 | 1341 | /* throttling disk I/O */ |
022cdc9f MP |
1342 | if (blk->public.throttle_group_member.throttle_state) { |
1343 | throttle_group_co_io_limits_intercept(&blk->public.throttle_group_member, | |
1344 | bytes, false); | |
441565b2 KW |
1345 | } |
1346 | ||
d1d3fc3d AF |
1347 | ret = bdrv_co_preadv_part(blk->root, offset, bytes, qiov, qiov_offset, |
1348 | flags); | |
99723548 PB |
1349 | bdrv_dec_in_flight(bs); |
1350 | return ret; | |
1bf1cbc9 KW |
1351 | } |
1352 | ||
6f675c93 AF |
1353 | int coroutine_fn blk_co_pread(BlockBackend *blk, int64_t offset, int64_t bytes, |
1354 | void *buf, BdrvRequestFlags flags) | |
1355 | { | |
1356 | QEMUIOVector qiov = QEMU_IOVEC_INIT_BUF(qiov, buf, bytes); | |
1357 | IO_OR_GS_CODE(); | |
1358 | ||
1359 | assert(bytes <= SIZE_MAX); | |
1360 | ||
1361 | return blk_co_preadv(blk, offset, bytes, &qiov, flags); | |
1362 | } | |
1363 | ||
fbb92b67 | 1364 | int coroutine_fn blk_co_preadv(BlockBackend *blk, int64_t offset, |
95479077 | 1365 | int64_t bytes, QEMUIOVector *qiov, |
fbb92b67 KW |
1366 | BdrvRequestFlags flags) |
1367 | { | |
1368 | int ret; | |
37868b2a | 1369 | IO_OR_GS_CODE(); |
fbb92b67 KW |
1370 | |
1371 | blk_inc_in_flight(blk); | |
d1d3fc3d AF |
1372 | ret = blk_co_do_preadv_part(blk, offset, bytes, qiov, 0, flags); |
1373 | blk_dec_in_flight(blk); | |
1374 | ||
1375 | return ret; | |
1376 | } | |
1377 | ||
1378 | int coroutine_fn blk_co_preadv_part(BlockBackend *blk, int64_t offset, | |
1379 | int64_t bytes, QEMUIOVector *qiov, | |
1380 | size_t qiov_offset, BdrvRequestFlags flags) | |
1381 | { | |
1382 | int ret; | |
1383 | IO_OR_GS_CODE(); | |
1384 | ||
1385 | blk_inc_in_flight(blk); | |
1386 | ret = blk_co_do_preadv_part(blk, offset, bytes, qiov, qiov_offset, flags); | |
fbb92b67 KW |
1387 | blk_dec_in_flight(blk); |
1388 | ||
1389 | return ret; | |
1390 | } | |
1391 | ||
1392 | /* To be called between exactly one pair of blk_inc/dec_in_flight() */ | |
07a64aa4 | 1393 | static int coroutine_fn |
70e8775e VSO |
1394 | blk_co_do_pwritev_part(BlockBackend *blk, int64_t offset, int64_t bytes, |
1395 | QEMUIOVector *qiov, size_t qiov_offset, | |
1396 | BdrvRequestFlags flags) | |
a8823a3b | 1397 | { |
bfd18d1e | 1398 | int ret; |
cf312932 | 1399 | BlockDriverState *bs; |
1581a70d | 1400 | IO_CODE(); |
bfd18d1e | 1401 | |
cf312932 | 1402 | blk_wait_while_drained(blk); |
b9b10c35 | 1403 | GRAPH_RDLOCK_GUARD(); |
bfd18d1e | 1404 | |
cf312932 KW |
1405 | /* Call blk_bs() only after waiting, the graph may have changed */ |
1406 | bs = blk_bs(blk); | |
99723548 | 1407 | trace_blk_co_pwritev(blk, bs, offset, bytes, flags); |
1e98fefd | 1408 | |
bfd18d1e | 1409 | ret = blk_check_byte_request(blk, offset, bytes); |
a8823a3b KW |
1410 | if (ret < 0) { |
1411 | return ret; | |
1412 | } | |
1413 | ||
99723548 | 1414 | bdrv_inc_in_flight(bs); |
441565b2 | 1415 | /* throttling disk I/O */ |
022cdc9f MP |
1416 | if (blk->public.throttle_group_member.throttle_state) { |
1417 | throttle_group_co_io_limits_intercept(&blk->public.throttle_group_member, | |
1418 | bytes, true); | |
441565b2 KW |
1419 | } |
1420 | ||
bfd18d1e KW |
1421 | if (!blk->enable_write_cache) { |
1422 | flags |= BDRV_REQ_FUA; | |
1423 | } | |
1424 | ||
b3016864 VSO |
1425 | ret = bdrv_co_pwritev_part(blk->root, offset, bytes, qiov, qiov_offset, |
1426 | flags); | |
99723548 PB |
1427 | bdrv_dec_in_flight(bs); |
1428 | return ret; | |
a8823a3b KW |
1429 | } |
1430 | ||
fbb92b67 | 1431 | int coroutine_fn blk_co_pwritev_part(BlockBackend *blk, int64_t offset, |
34460feb | 1432 | int64_t bytes, |
fbb92b67 KW |
1433 | QEMUIOVector *qiov, size_t qiov_offset, |
1434 | BdrvRequestFlags flags) | |
1435 | { | |
1436 | int ret; | |
37868b2a | 1437 | IO_OR_GS_CODE(); |
fbb92b67 KW |
1438 | |
1439 | blk_inc_in_flight(blk); | |
70e8775e | 1440 | ret = blk_co_do_pwritev_part(blk, offset, bytes, qiov, qiov_offset, flags); |
fbb92b67 KW |
1441 | blk_dec_in_flight(blk); |
1442 | ||
1443 | return ret; | |
1444 | } | |
1445 | ||
6f675c93 AF |
1446 | int coroutine_fn blk_co_pwrite(BlockBackend *blk, int64_t offset, int64_t bytes, |
1447 | const void *buf, BdrvRequestFlags flags) | |
1448 | { | |
1449 | QEMUIOVector qiov = QEMU_IOVEC_INIT_BUF(qiov, buf, bytes); | |
1450 | IO_OR_GS_CODE(); | |
1451 | ||
1452 | assert(bytes <= SIZE_MAX); | |
1453 | ||
1454 | return blk_co_pwritev(blk, offset, bytes, &qiov, flags); | |
1455 | } | |
1456 | ||
b3016864 | 1457 | int coroutine_fn blk_co_pwritev(BlockBackend *blk, int64_t offset, |
34460feb | 1458 | int64_t bytes, QEMUIOVector *qiov, |
b3016864 VSO |
1459 | BdrvRequestFlags flags) |
1460 | { | |
37868b2a | 1461 | IO_OR_GS_CODE(); |
b3016864 VSO |
1462 | return blk_co_pwritev_part(blk, offset, bytes, qiov, 0, flags); |
1463 | } | |
1464 | ||
ff7e261b EGE |
1465 | int coroutine_fn blk_co_block_status_above(BlockBackend *blk, |
1466 | BlockDriverState *base, | |
1467 | int64_t offset, int64_t bytes, | |
1468 | int64_t *pnum, int64_t *map, | |
1469 | BlockDriverState **file) | |
1470 | { | |
1471 | IO_CODE(); | |
7ff9579e | 1472 | GRAPH_RDLOCK_GUARD(); |
ff7e261b EGE |
1473 | return bdrv_co_block_status_above(blk_bs(blk), base, offset, bytes, pnum, |
1474 | map, file); | |
1475 | } | |
1476 | ||
1477 | int coroutine_fn blk_co_is_allocated_above(BlockBackend *blk, | |
1478 | BlockDriverState *base, | |
1479 | bool include_base, int64_t offset, | |
1480 | int64_t bytes, int64_t *pnum) | |
1481 | { | |
1482 | IO_CODE(); | |
7ff9579e | 1483 | GRAPH_RDLOCK_GUARD(); |
ff7e261b EGE |
1484 | return bdrv_co_is_allocated_above(blk_bs(blk), base, include_base, offset, |
1485 | bytes, pnum); | |
1486 | } | |
1487 | ||
1bf1cbc9 KW |
1488 | typedef struct BlkRwCo { |
1489 | BlockBackend *blk; | |
1490 | int64_t offset; | |
c060332c | 1491 | void *iobuf; |
1bf1cbc9 KW |
1492 | int ret; |
1493 | BdrvRequestFlags flags; | |
1494 | } BlkRwCo; | |
1495 | ||
720ff280 KW |
1496 | int blk_make_zero(BlockBackend *blk, BdrvRequestFlags flags) |
1497 | { | |
0439c5a4 | 1498 | GLOBAL_STATE_CODE(); |
720ff280 KW |
1499 | return bdrv_make_zero(blk->root, flags); |
1500 | } | |
1501 | ||
c90e2a9c | 1502 | void blk_inc_in_flight(BlockBackend *blk) |
33f2a757 | 1503 | { |
37868b2a | 1504 | IO_CODE(); |
d73415a3 | 1505 | qatomic_inc(&blk->in_flight); |
33f2a757 SH |
1506 | } |
1507 | ||
c90e2a9c | 1508 | void blk_dec_in_flight(BlockBackend *blk) |
33f2a757 | 1509 | { |
37868b2a | 1510 | IO_CODE(); |
d73415a3 | 1511 | qatomic_dec(&blk->in_flight); |
cfe29d82 | 1512 | aio_wait_kick(); |
33f2a757 SH |
1513 | } |
1514 | ||
e7f7d676 HR |
1515 | static void error_callback_bh(void *opaque) |
1516 | { | |
1517 | struct BlockBackendAIOCB *acb = opaque; | |
99723548 | 1518 | |
33f2a757 | 1519 | blk_dec_in_flight(acb->blk); |
e7f7d676 HR |
1520 | acb->common.cb(acb->common.opaque, acb->ret); |
1521 | qemu_aio_unref(acb); | |
1522 | } | |
1523 | ||
ca78ecfa PL |
1524 | BlockAIOCB *blk_abort_aio_request(BlockBackend *blk, |
1525 | BlockCompletionFunc *cb, | |
1526 | void *opaque, int ret) | |
e7f7d676 HR |
1527 | { |
1528 | struct BlockBackendAIOCB *acb; | |
37868b2a | 1529 | IO_CODE(); |
e7f7d676 | 1530 | |
33f2a757 | 1531 | blk_inc_in_flight(blk); |
e7f7d676 | 1532 | acb = blk_aio_get(&block_backend_aiocb_info, blk, cb, opaque); |
4981bdec | 1533 | acb->blk = blk; |
e7f7d676 HR |
1534 | acb->ret = ret; |
1535 | ||
e4ec5ad4 PD |
1536 | replay_bh_schedule_oneshot_event(blk_get_aio_context(blk), |
1537 | error_callback_bh, acb); | |
e7f7d676 HR |
1538 | return &acb->common; |
1539 | } | |
1540 | ||
57d6a428 KW |
1541 | typedef struct BlkAioEmAIOCB { |
1542 | BlockAIOCB common; | |
1543 | BlkRwCo rwco; | |
a93d81c8 | 1544 | int64_t bytes; |
57d6a428 | 1545 | bool has_returned; |
57d6a428 KW |
1546 | } BlkAioEmAIOCB; |
1547 | ||
1d719ddc SH |
1548 | static AioContext *blk_aio_em_aiocb_get_aio_context(BlockAIOCB *acb_) |
1549 | { | |
1550 | BlkAioEmAIOCB *acb = container_of(acb_, BlkAioEmAIOCB, common); | |
1551 | ||
1552 | return blk_get_aio_context(acb->rwco.blk); | |
1553 | } | |
1554 | ||
57d6a428 KW |
1555 | static const AIOCBInfo blk_aio_em_aiocb_info = { |
1556 | .aiocb_size = sizeof(BlkAioEmAIOCB), | |
1d719ddc | 1557 | .get_aio_context = blk_aio_em_aiocb_get_aio_context, |
57d6a428 KW |
1558 | }; |
1559 | ||
1560 | static void blk_aio_complete(BlkAioEmAIOCB *acb) | |
1561 | { | |
57d6a428 KW |
1562 | if (acb->has_returned) { |
1563 | acb->common.cb(acb->common.opaque, acb->rwco.ret); | |
46aaf2a5 | 1564 | blk_dec_in_flight(acb->rwco.blk); |
57d6a428 KW |
1565 | qemu_aio_unref(acb); |
1566 | } | |
1567 | } | |
1568 | ||
1569 | static void blk_aio_complete_bh(void *opaque) | |
1570 | { | |
fffb6e12 | 1571 | BlkAioEmAIOCB *acb = opaque; |
fffb6e12 PB |
1572 | assert(acb->has_returned); |
1573 | blk_aio_complete(acb); | |
57d6a428 KW |
1574 | } |
1575 | ||
a93d81c8 VSO |
1576 | static BlockAIOCB *blk_aio_prwv(BlockBackend *blk, int64_t offset, |
1577 | int64_t bytes, | |
c060332c | 1578 | void *iobuf, CoroutineEntry co_entry, |
57d6a428 KW |
1579 | BdrvRequestFlags flags, |
1580 | BlockCompletionFunc *cb, void *opaque) | |
1581 | { | |
1582 | BlkAioEmAIOCB *acb; | |
1583 | Coroutine *co; | |
1584 | ||
33f2a757 | 1585 | blk_inc_in_flight(blk); |
57d6a428 KW |
1586 | acb = blk_aio_get(&blk_aio_em_aiocb_info, blk, cb, opaque); |
1587 | acb->rwco = (BlkRwCo) { | |
1588 | .blk = blk, | |
1589 | .offset = offset, | |
c060332c | 1590 | .iobuf = iobuf, |
57d6a428 KW |
1591 | .flags = flags, |
1592 | .ret = NOT_DONE, | |
1593 | }; | |
7fa84cd8 | 1594 | acb->bytes = bytes; |
57d6a428 KW |
1595 | acb->has_returned = false; |
1596 | ||
0b8b8753 | 1597 | co = qemu_coroutine_create(co_entry, acb); |
3d65110f | 1598 | aio_co_enter(blk_get_aio_context(blk), co); |
57d6a428 KW |
1599 | |
1600 | acb->has_returned = true; | |
1601 | if (acb->rwco.ret != NOT_DONE) { | |
e4ec5ad4 PD |
1602 | replay_bh_schedule_oneshot_event(blk_get_aio_context(blk), |
1603 | blk_aio_complete_bh, acb); | |
57d6a428 KW |
1604 | } |
1605 | ||
1606 | return &acb->common; | |
1607 | } | |
1608 | ||
881a4c55 | 1609 | static void coroutine_fn blk_aio_read_entry(void *opaque) |
57d6a428 KW |
1610 | { |
1611 | BlkAioEmAIOCB *acb = opaque; | |
1612 | BlkRwCo *rwco = &acb->rwco; | |
c060332c | 1613 | QEMUIOVector *qiov = rwco->iobuf; |
57d6a428 | 1614 | |
c060332c | 1615 | assert(qiov->size == acb->bytes); |
d1d3fc3d AF |
1616 | rwco->ret = blk_co_do_preadv_part(rwco->blk, rwco->offset, acb->bytes, qiov, |
1617 | 0, rwco->flags); | |
57d6a428 KW |
1618 | blk_aio_complete(acb); |
1619 | } | |
1620 | ||
881a4c55 | 1621 | static void coroutine_fn blk_aio_write_entry(void *opaque) |
57d6a428 KW |
1622 | { |
1623 | BlkAioEmAIOCB *acb = opaque; | |
1624 | BlkRwCo *rwco = &acb->rwco; | |
c060332c | 1625 | QEMUIOVector *qiov = rwco->iobuf; |
57d6a428 | 1626 | |
c060332c | 1627 | assert(!qiov || qiov->size == acb->bytes); |
70e8775e VSO |
1628 | rwco->ret = blk_co_do_pwritev_part(rwco->blk, rwco->offset, acb->bytes, |
1629 | qiov, 0, rwco->flags); | |
57d6a428 KW |
1630 | blk_aio_complete(acb); |
1631 | } | |
1632 | ||
d004bd52 | 1633 | BlockAIOCB *blk_aio_pwrite_zeroes(BlockBackend *blk, int64_t offset, |
a93d81c8 | 1634 | int64_t bytes, BdrvRequestFlags flags, |
d004bd52 | 1635 | BlockCompletionFunc *cb, void *opaque) |
4be74634 | 1636 | { |
37868b2a | 1637 | IO_CODE(); |
a93d81c8 | 1638 | return blk_aio_prwv(blk, offset, bytes, NULL, blk_aio_write_entry, |
983a1600 | 1639 | flags | BDRV_REQ_ZERO_WRITE, cb, opaque); |
4be74634 MA |
1640 | } |
1641 | ||
c86422c5 | 1642 | int64_t coroutine_fn blk_co_getlength(BlockBackend *blk) |
4be74634 | 1643 | { |
37868b2a | 1644 | IO_CODE(); |
c73ff92c | 1645 | GRAPH_RDLOCK_GUARD(); |
c86422c5 | 1646 | |
c73ff92c | 1647 | if (!blk_co_is_available(blk)) { |
c09ba36c HR |
1648 | return -ENOMEDIUM; |
1649 | } | |
1650 | ||
c86422c5 | 1651 | return bdrv_co_getlength(blk_bs(blk)); |
4be74634 MA |
1652 | } |
1653 | ||
9ed98cae | 1654 | int64_t coroutine_fn blk_co_nb_sectors(BlockBackend *blk) |
4be74634 | 1655 | { |
e5203a3b PB |
1656 | BlockDriverState *bs = blk_bs(blk); |
1657 | ||
37868b2a | 1658 | IO_CODE(); |
d8fbf9aa KW |
1659 | GRAPH_RDLOCK_GUARD(); |
1660 | ||
e5203a3b | 1661 | if (!bs) { |
9ed98cae | 1662 | return -ENOMEDIUM; |
a46fc9c9 | 1663 | } else { |
9ed98cae | 1664 | return bdrv_co_nb_sectors(bs); |
a46fc9c9 | 1665 | } |
4be74634 MA |
1666 | } |
1667 | ||
81f730d4 PB |
1668 | /* |
1669 | * This wrapper is written by hand because this function is in the hot I/O path, | |
1670 | * via blk_get_geometry. | |
1671 | */ | |
1672 | int64_t coroutine_mixed_fn blk_nb_sectors(BlockBackend *blk) | |
1673 | { | |
1674 | BlockDriverState *bs = blk_bs(blk); | |
1675 | ||
1676 | IO_CODE(); | |
1677 | ||
1678 | if (!bs) { | |
1679 | return -ENOMEDIUM; | |
1680 | } else { | |
1681 | return bdrv_nb_sectors(bs); | |
1682 | } | |
1683 | } | |
1684 | ||
9ed98cae PB |
1685 | /* return 0 as number of sectors if no device present or error */ |
1686 | void coroutine_fn blk_co_get_geometry(BlockBackend *blk, | |
1687 | uint64_t *nb_sectors_ptr) | |
1ef01253 | 1688 | { |
9ed98cae PB |
1689 | int64_t ret = blk_co_nb_sectors(blk); |
1690 | *nb_sectors_ptr = ret < 0 ? 0 : ret; | |
1ef01253 HR |
1691 | } |
1692 | ||
81f730d4 PB |
1693 | /* |
1694 | * This wrapper is written by hand because this function is in the hot I/O path. | |
1695 | */ | |
1696 | void coroutine_mixed_fn blk_get_geometry(BlockBackend *blk, | |
1697 | uint64_t *nb_sectors_ptr) | |
1698 | { | |
1699 | int64_t ret = blk_nb_sectors(blk); | |
1700 | *nb_sectors_ptr = ret < 0 ? 0 : ret; | |
1701 | } | |
1702 | ||
60cb2fa7 EB |
1703 | BlockAIOCB *blk_aio_preadv(BlockBackend *blk, int64_t offset, |
1704 | QEMUIOVector *qiov, BdrvRequestFlags flags, | |
1705 | BlockCompletionFunc *cb, void *opaque) | |
1706 | { | |
37868b2a | 1707 | IO_CODE(); |
a93d81c8 | 1708 | assert((uint64_t)qiov->size <= INT64_MAX); |
60cb2fa7 EB |
1709 | return blk_aio_prwv(blk, offset, qiov->size, qiov, |
1710 | blk_aio_read_entry, flags, cb, opaque); | |
1711 | } | |
1712 | ||
60cb2fa7 EB |
1713 | BlockAIOCB *blk_aio_pwritev(BlockBackend *blk, int64_t offset, |
1714 | QEMUIOVector *qiov, BdrvRequestFlags flags, | |
1715 | BlockCompletionFunc *cb, void *opaque) | |
1716 | { | |
37868b2a | 1717 | IO_CODE(); |
73d4a113 | 1718 | assert((uint64_t)qiov->size <= INT64_MAX); |
60cb2fa7 EB |
1719 | return blk_aio_prwv(blk, offset, qiov->size, qiov, |
1720 | blk_aio_write_entry, flags, cb, opaque); | |
1721 | } | |
1722 | ||
4be74634 MA |
1723 | void blk_aio_cancel(BlockAIOCB *acb) |
1724 | { | |
0439c5a4 | 1725 | GLOBAL_STATE_CODE(); |
4be74634 MA |
1726 | bdrv_aio_cancel(acb); |
1727 | } | |
1728 | ||
1729 | void blk_aio_cancel_async(BlockAIOCB *acb) | |
1730 | { | |
37868b2a | 1731 | IO_CODE(); |
4be74634 MA |
1732 | bdrv_aio_cancel_async(acb); |
1733 | } | |
1734 | ||
fbb92b67 | 1735 | /* To be called between exactly one pair of blk_inc/dec_in_flight() */ |
df02da00 | 1736 | static int coroutine_fn |
70e8775e | 1737 | blk_co_do_ioctl(BlockBackend *blk, unsigned long int req, void *buf) |
4be74634 | 1738 | { |
1581a70d EGE |
1739 | IO_CODE(); |
1740 | ||
cf312932 | 1741 | blk_wait_while_drained(blk); |
26c518ab | 1742 | GRAPH_RDLOCK_GUARD(); |
cf312932 | 1743 | |
c73ff92c | 1744 | if (!blk_co_is_available(blk)) { |
c09ba36c HR |
1745 | return -ENOMEDIUM; |
1746 | } | |
1747 | ||
48af776a KW |
1748 | return bdrv_co_ioctl(blk_bs(blk), req, buf); |
1749 | } | |
1750 | ||
df02da00 AF |
1751 | int coroutine_fn blk_co_ioctl(BlockBackend *blk, unsigned long int req, |
1752 | void *buf) | |
48af776a | 1753 | { |
16d36e29 | 1754 | int ret; |
37868b2a | 1755 | IO_OR_GS_CODE(); |
c060332c | 1756 | |
16d36e29 | 1757 | blk_inc_in_flight(blk); |
df02da00 | 1758 | ret = blk_co_do_ioctl(blk, req, buf); |
16d36e29 | 1759 | blk_dec_in_flight(blk); |
48af776a | 1760 | |
16d36e29 | 1761 | return ret; |
48af776a KW |
1762 | } |
1763 | ||
881a4c55 | 1764 | static void coroutine_fn blk_aio_ioctl_entry(void *opaque) |
48af776a KW |
1765 | { |
1766 | BlkAioEmAIOCB *acb = opaque; | |
1767 | BlkRwCo *rwco = &acb->rwco; | |
1768 | ||
70e8775e | 1769 | rwco->ret = blk_co_do_ioctl(rwco->blk, rwco->offset, rwco->iobuf); |
c060332c | 1770 | |
48af776a | 1771 | blk_aio_complete(acb); |
4be74634 MA |
1772 | } |
1773 | ||
1774 | BlockAIOCB *blk_aio_ioctl(BlockBackend *blk, unsigned long int req, void *buf, | |
1775 | BlockCompletionFunc *cb, void *opaque) | |
1776 | { | |
37868b2a | 1777 | IO_CODE(); |
c060332c | 1778 | return blk_aio_prwv(blk, req, 0, buf, blk_aio_ioctl_entry, 0, cb, opaque); |
4be74634 MA |
1779 | } |
1780 | ||
fbb92b67 | 1781 | /* To be called between exactly one pair of blk_inc/dec_in_flight() */ |
07a64aa4 | 1782 | static int coroutine_fn |
70e8775e | 1783 | blk_co_do_pdiscard(BlockBackend *blk, int64_t offset, int64_t bytes) |
2bb0dce7 | 1784 | { |
cf312932 | 1785 | int ret; |
1581a70d | 1786 | IO_CODE(); |
cf312932 KW |
1787 | |
1788 | blk_wait_while_drained(blk); | |
9a5a1c62 | 1789 | GRAPH_RDLOCK_GUARD(); |
cf312932 KW |
1790 | |
1791 | ret = blk_check_byte_request(blk, offset, bytes); | |
e7f7d676 HR |
1792 | if (ret < 0) { |
1793 | return ret; | |
1794 | } | |
1795 | ||
0b9fd3f4 | 1796 | return bdrv_co_pdiscard(blk->root, offset, bytes); |
2bb0dce7 HR |
1797 | } |
1798 | ||
881a4c55 | 1799 | static void coroutine_fn blk_aio_pdiscard_entry(void *opaque) |
564806c5 KW |
1800 | { |
1801 | BlkAioEmAIOCB *acb = opaque; | |
1802 | BlkRwCo *rwco = &acb->rwco; | |
1803 | ||
70e8775e | 1804 | rwco->ret = blk_co_do_pdiscard(rwco->blk, rwco->offset, acb->bytes); |
564806c5 KW |
1805 | blk_aio_complete(acb); |
1806 | } | |
1807 | ||
1808 | BlockAIOCB *blk_aio_pdiscard(BlockBackend *blk, | |
a93d81c8 | 1809 | int64_t offset, int64_t bytes, |
564806c5 KW |
1810 | BlockCompletionFunc *cb, void *opaque) |
1811 | { | |
37868b2a | 1812 | IO_CODE(); |
564806c5 KW |
1813 | return blk_aio_prwv(blk, offset, bytes, NULL, blk_aio_pdiscard_entry, 0, |
1814 | cb, opaque); | |
1815 | } | |
1816 | ||
2800637a VSO |
1817 | int coroutine_fn blk_co_pdiscard(BlockBackend *blk, int64_t offset, |
1818 | int64_t bytes) | |
fbb92b67 KW |
1819 | { |
1820 | int ret; | |
37868b2a | 1821 | IO_OR_GS_CODE(); |
fbb92b67 KW |
1822 | |
1823 | blk_inc_in_flight(blk); | |
70e8775e | 1824 | ret = blk_co_do_pdiscard(blk, offset, bytes); |
fbb92b67 KW |
1825 | blk_dec_in_flight(blk); |
1826 | ||
1827 | return ret; | |
1828 | } | |
1829 | ||
fbb92b67 | 1830 | /* To be called between exactly one pair of blk_inc/dec_in_flight() */ |
07a64aa4 | 1831 | static int coroutine_fn blk_co_do_flush(BlockBackend *blk) |
2bb0dce7 | 1832 | { |
1581a70d | 1833 | IO_CODE(); |
88095349 EGE |
1834 | blk_wait_while_drained(blk); |
1835 | GRAPH_RDLOCK_GUARD(); | |
cf312932 | 1836 | |
c73ff92c | 1837 | if (!blk_co_is_available(blk)) { |
c09ba36c HR |
1838 | return -ENOMEDIUM; |
1839 | } | |
1840 | ||
f21d96d0 | 1841 | return bdrv_co_flush(blk_bs(blk)); |
2bb0dce7 HR |
1842 | } |
1843 | ||
881a4c55 | 1844 | static void coroutine_fn blk_aio_flush_entry(void *opaque) |
564806c5 KW |
1845 | { |
1846 | BlkAioEmAIOCB *acb = opaque; | |
1847 | BlkRwCo *rwco = &acb->rwco; | |
1848 | ||
70e8775e | 1849 | rwco->ret = blk_co_do_flush(rwco->blk); |
564806c5 KW |
1850 | blk_aio_complete(acb); |
1851 | } | |
1852 | ||
1853 | BlockAIOCB *blk_aio_flush(BlockBackend *blk, | |
1854 | BlockCompletionFunc *cb, void *opaque) | |
1855 | { | |
37868b2a | 1856 | IO_CODE(); |
564806c5 KW |
1857 | return blk_aio_prwv(blk, 0, 0, NULL, blk_aio_flush_entry, 0, cb, opaque); |
1858 | } | |
1859 | ||
fbb92b67 KW |
1860 | int coroutine_fn blk_co_flush(BlockBackend *blk) |
1861 | { | |
1862 | int ret; | |
37868b2a | 1863 | IO_OR_GS_CODE(); |
fbb92b67 KW |
1864 | |
1865 | blk_inc_in_flight(blk); | |
70e8775e | 1866 | ret = blk_co_do_flush(blk); |
fbb92b67 KW |
1867 | blk_dec_in_flight(blk); |
1868 | ||
1869 | return ret; | |
1870 | } | |
1871 | ||
6d43eaa3 SL |
1872 | static void coroutine_fn blk_aio_zone_report_entry(void *opaque) |
1873 | { | |
1874 | BlkAioEmAIOCB *acb = opaque; | |
1875 | BlkRwCo *rwco = &acb->rwco; | |
1876 | ||
1877 | rwco->ret = blk_co_zone_report(rwco->blk, rwco->offset, | |
1878 | (unsigned int*)(uintptr_t)acb->bytes, | |
1879 | rwco->iobuf); | |
1880 | blk_aio_complete(acb); | |
1881 | } | |
1882 | ||
1883 | BlockAIOCB *blk_aio_zone_report(BlockBackend *blk, int64_t offset, | |
1884 | unsigned int *nr_zones, | |
1885 | BlockZoneDescriptor *zones, | |
1886 | BlockCompletionFunc *cb, void *opaque) | |
1887 | { | |
1888 | BlkAioEmAIOCB *acb; | |
1889 | Coroutine *co; | |
1890 | IO_CODE(); | |
1891 | ||
1892 | blk_inc_in_flight(blk); | |
1893 | acb = blk_aio_get(&blk_aio_em_aiocb_info, blk, cb, opaque); | |
1894 | acb->rwco = (BlkRwCo) { | |
1895 | .blk = blk, | |
1896 | .offset = offset, | |
1897 | .iobuf = zones, | |
1898 | .ret = NOT_DONE, | |
1899 | }; | |
1900 | acb->bytes = (int64_t)(uintptr_t)nr_zones, | |
1901 | acb->has_returned = false; | |
1902 | ||
1903 | co = qemu_coroutine_create(blk_aio_zone_report_entry, acb); | |
1904 | aio_co_enter(blk_get_aio_context(blk), co); | |
1905 | ||
1906 | acb->has_returned = true; | |
1907 | if (acb->rwco.ret != NOT_DONE) { | |
1908 | replay_bh_schedule_oneshot_event(blk_get_aio_context(blk), | |
1909 | blk_aio_complete_bh, acb); | |
1910 | } | |
1911 | ||
1912 | return &acb->common; | |
1913 | } | |
1914 | ||
1915 | static void coroutine_fn blk_aio_zone_mgmt_entry(void *opaque) | |
1916 | { | |
1917 | BlkAioEmAIOCB *acb = opaque; | |
1918 | BlkRwCo *rwco = &acb->rwco; | |
1919 | ||
1920 | rwco->ret = blk_co_zone_mgmt(rwco->blk, | |
1921 | (BlockZoneOp)(uintptr_t)rwco->iobuf, | |
1922 | rwco->offset, acb->bytes); | |
1923 | blk_aio_complete(acb); | |
1924 | } | |
1925 | ||
1926 | BlockAIOCB *blk_aio_zone_mgmt(BlockBackend *blk, BlockZoneOp op, | |
1927 | int64_t offset, int64_t len, | |
1928 | BlockCompletionFunc *cb, void *opaque) { | |
1929 | BlkAioEmAIOCB *acb; | |
1930 | Coroutine *co; | |
1931 | IO_CODE(); | |
1932 | ||
1933 | blk_inc_in_flight(blk); | |
1934 | acb = blk_aio_get(&blk_aio_em_aiocb_info, blk, cb, opaque); | |
1935 | acb->rwco = (BlkRwCo) { | |
1936 | .blk = blk, | |
1937 | .offset = offset, | |
1938 | .iobuf = (void *)(uintptr_t)op, | |
1939 | .ret = NOT_DONE, | |
1940 | }; | |
1941 | acb->bytes = len; | |
1942 | acb->has_returned = false; | |
1943 | ||
1944 | co = qemu_coroutine_create(blk_aio_zone_mgmt_entry, acb); | |
1945 | aio_co_enter(blk_get_aio_context(blk), co); | |
1946 | ||
1947 | acb->has_returned = true; | |
1948 | if (acb->rwco.ret != NOT_DONE) { | |
1949 | replay_bh_schedule_oneshot_event(blk_get_aio_context(blk), | |
1950 | blk_aio_complete_bh, acb); | |
1951 | } | |
1952 | ||
1953 | return &acb->common; | |
1954 | } | |
1955 | ||
4751d09a SL |
1956 | static void coroutine_fn blk_aio_zone_append_entry(void *opaque) |
1957 | { | |
1958 | BlkAioEmAIOCB *acb = opaque; | |
1959 | BlkRwCo *rwco = &acb->rwco; | |
1960 | ||
1961 | rwco->ret = blk_co_zone_append(rwco->blk, (int64_t *)(uintptr_t)acb->bytes, | |
1962 | rwco->iobuf, rwco->flags); | |
1963 | blk_aio_complete(acb); | |
1964 | } | |
1965 | ||
1966 | BlockAIOCB *blk_aio_zone_append(BlockBackend *blk, int64_t *offset, | |
1967 | QEMUIOVector *qiov, BdrvRequestFlags flags, | |
1968 | BlockCompletionFunc *cb, void *opaque) { | |
1969 | BlkAioEmAIOCB *acb; | |
1970 | Coroutine *co; | |
1971 | IO_CODE(); | |
1972 | ||
1973 | blk_inc_in_flight(blk); | |
1974 | acb = blk_aio_get(&blk_aio_em_aiocb_info, blk, cb, opaque); | |
1975 | acb->rwco = (BlkRwCo) { | |
1976 | .blk = blk, | |
1977 | .ret = NOT_DONE, | |
1978 | .flags = flags, | |
1979 | .iobuf = qiov, | |
1980 | }; | |
1981 | acb->bytes = (int64_t)(uintptr_t)offset; | |
1982 | acb->has_returned = false; | |
1983 | ||
1984 | co = qemu_coroutine_create(blk_aio_zone_append_entry, acb); | |
1985 | aio_co_enter(blk_get_aio_context(blk), co); | |
1986 | acb->has_returned = true; | |
1987 | if (acb->rwco.ret != NOT_DONE) { | |
1988 | replay_bh_schedule_oneshot_event(blk_get_aio_context(blk), | |
1989 | blk_aio_complete_bh, acb); | |
1990 | } | |
1991 | ||
1992 | return &acb->common; | |
1993 | } | |
1994 | ||
6d43eaa3 SL |
1995 | /* |
1996 | * Send a zone_report command. | |
1997 | * offset is a byte offset from the start of the device. No alignment | |
1998 | * required for offset. | |
1999 | * nr_zones represents IN maximum and OUT actual. | |
2000 | */ | |
2001 | int coroutine_fn blk_co_zone_report(BlockBackend *blk, int64_t offset, | |
2002 | unsigned int *nr_zones, | |
2003 | BlockZoneDescriptor *zones) | |
2004 | { | |
2005 | int ret; | |
2006 | IO_CODE(); | |
2007 | ||
2008 | blk_inc_in_flight(blk); /* increase before waiting */ | |
2009 | blk_wait_while_drained(blk); | |
2010 | GRAPH_RDLOCK_GUARD(); | |
2011 | if (!blk_is_available(blk)) { | |
2012 | blk_dec_in_flight(blk); | |
2013 | return -ENOMEDIUM; | |
2014 | } | |
2015 | ret = bdrv_co_zone_report(blk_bs(blk), offset, nr_zones, zones); | |
2016 | blk_dec_in_flight(blk); | |
2017 | return ret; | |
2018 | } | |
2019 | ||
2020 | /* | |
2021 | * Send a zone_management command. | |
2022 | * op is the zone operation; | |
2023 | * offset is the byte offset from the start of the zoned device; | |
2024 | * len is the maximum number of bytes the command should operate on. It | |
2025 | * should be aligned with the device zone size. | |
2026 | */ | |
2027 | int coroutine_fn blk_co_zone_mgmt(BlockBackend *blk, BlockZoneOp op, | |
2028 | int64_t offset, int64_t len) | |
2029 | { | |
2030 | int ret; | |
2031 | IO_CODE(); | |
2032 | ||
2033 | blk_inc_in_flight(blk); | |
2034 | blk_wait_while_drained(blk); | |
2035 | GRAPH_RDLOCK_GUARD(); | |
2036 | ||
2037 | ret = blk_check_byte_request(blk, offset, len); | |
2038 | if (ret < 0) { | |
2039 | blk_dec_in_flight(blk); | |
2040 | return ret; | |
2041 | } | |
2042 | ||
2043 | ret = bdrv_co_zone_mgmt(blk_bs(blk), op, offset, len); | |
2044 | blk_dec_in_flight(blk); | |
2045 | return ret; | |
2046 | } | |
2047 | ||
4751d09a SL |
2048 | /* |
2049 | * Send a zone_append command. | |
2050 | */ | |
2051 | int coroutine_fn blk_co_zone_append(BlockBackend *blk, int64_t *offset, | |
2052 | QEMUIOVector *qiov, BdrvRequestFlags flags) | |
2053 | { | |
2054 | int ret; | |
2055 | IO_CODE(); | |
2056 | ||
2057 | blk_inc_in_flight(blk); | |
2058 | blk_wait_while_drained(blk); | |
2059 | GRAPH_RDLOCK_GUARD(); | |
2060 | if (!blk_is_available(blk)) { | |
2061 | blk_dec_in_flight(blk); | |
2062 | return -ENOMEDIUM; | |
2063 | } | |
2064 | ||
2065 | ret = bdrv_co_zone_append(blk_bs(blk), offset, qiov, flags); | |
2066 | blk_dec_in_flight(blk); | |
2067 | return ret; | |
2068 | } | |
2069 | ||
97b0385a AY |
2070 | void blk_drain(BlockBackend *blk) |
2071 | { | |
33f2a757 | 2072 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2073 | GLOBAL_STATE_CODE(); |
33f2a757 SH |
2074 | |
2075 | if (bs) { | |
1e3552db | 2076 | bdrv_ref(bs); |
33f2a757 SH |
2077 | bdrv_drained_begin(bs); |
2078 | } | |
2079 | ||
2080 | /* We may have -ENOMEDIUM completions in flight */ | |
cfe29d82 | 2081 | AIO_WAIT_WHILE(blk_get_aio_context(blk), |
6a8a98a0 | 2082 | qatomic_read(&blk->in_flight) > 0); |
33f2a757 SH |
2083 | |
2084 | if (bs) { | |
2085 | bdrv_drained_end(bs); | |
1e3552db | 2086 | bdrv_unref(bs); |
a46fc9c9 | 2087 | } |
97b0385a AY |
2088 | } |
2089 | ||
4be74634 MA |
2090 | void blk_drain_all(void) |
2091 | { | |
33f2a757 SH |
2092 | BlockBackend *blk = NULL; |
2093 | ||
0439c5a4 EGE |
2094 | GLOBAL_STATE_CODE(); |
2095 | ||
33f2a757 SH |
2096 | bdrv_drain_all_begin(); |
2097 | ||
2098 | while ((blk = blk_all_next(blk)) != NULL) { | |
33f2a757 | 2099 | /* We may have -ENOMEDIUM completions in flight */ |
d5eab432 | 2100 | AIO_WAIT_WHILE_UNLOCKED(NULL, qatomic_read(&blk->in_flight) > 0); |
33f2a757 SH |
2101 | } |
2102 | ||
2103 | bdrv_drain_all_end(); | |
4be74634 MA |
2104 | } |
2105 | ||
373340b2 HR |
2106 | void blk_set_on_error(BlockBackend *blk, BlockdevOnError on_read_error, |
2107 | BlockdevOnError on_write_error) | |
2108 | { | |
0439c5a4 | 2109 | GLOBAL_STATE_CODE(); |
373340b2 HR |
2110 | blk->on_read_error = on_read_error; |
2111 | blk->on_write_error = on_write_error; | |
2112 | } | |
2113 | ||
4be74634 MA |
2114 | BlockdevOnError blk_get_on_error(BlockBackend *blk, bool is_read) |
2115 | { | |
37868b2a | 2116 | IO_CODE(); |
373340b2 | 2117 | return is_read ? blk->on_read_error : blk->on_write_error; |
4be74634 MA |
2118 | } |
2119 | ||
2120 | BlockErrorAction blk_get_error_action(BlockBackend *blk, bool is_read, | |
2121 | int error) | |
2122 | { | |
373340b2 | 2123 | BlockdevOnError on_err = blk_get_on_error(blk, is_read); |
37868b2a | 2124 | IO_CODE(); |
373340b2 HR |
2125 | |
2126 | switch (on_err) { | |
2127 | case BLOCKDEV_ON_ERROR_ENOSPC: | |
2128 | return (error == ENOSPC) ? | |
2129 | BLOCK_ERROR_ACTION_STOP : BLOCK_ERROR_ACTION_REPORT; | |
2130 | case BLOCKDEV_ON_ERROR_STOP: | |
2131 | return BLOCK_ERROR_ACTION_STOP; | |
2132 | case BLOCKDEV_ON_ERROR_REPORT: | |
2133 | return BLOCK_ERROR_ACTION_REPORT; | |
2134 | case BLOCKDEV_ON_ERROR_IGNORE: | |
2135 | return BLOCK_ERROR_ACTION_IGNORE; | |
8c398252 | 2136 | case BLOCKDEV_ON_ERROR_AUTO: |
373340b2 HR |
2137 | default: |
2138 | abort(); | |
2139 | } | |
4be74634 MA |
2140 | } |
2141 | ||
373340b2 HR |
2142 | static void send_qmp_error_event(BlockBackend *blk, |
2143 | BlockErrorAction action, | |
2144 | bool is_read, int error) | |
2145 | { | |
2146 | IoOperationType optype; | |
bfe1a14c | 2147 | BlockDriverState *bs = blk_bs(blk); |
373340b2 HR |
2148 | |
2149 | optype = is_read ? IO_OPERATION_TYPE_READ : IO_OPERATION_TYPE_WRITE; | |
54fde4ff | 2150 | qapi_event_send_block_io_error(blk_name(blk), |
bfe1a14c | 2151 | bs ? bdrv_get_node_name(bs) : NULL, optype, |
2bf7e10f | 2152 | action, blk_iostatus_is_enabled(blk), |
3ab72385 | 2153 | error == ENOSPC, strerror(error)); |
373340b2 HR |
2154 | } |
2155 | ||
2156 | /* This is done by device models because, while the block layer knows | |
2157 | * about the error, it does not know whether an operation comes from | |
2158 | * the device or the block layer (from a job, for example). | |
2159 | */ | |
4be74634 MA |
2160 | void blk_error_action(BlockBackend *blk, BlockErrorAction action, |
2161 | bool is_read, int error) | |
2162 | { | |
373340b2 | 2163 | assert(error >= 0); |
37868b2a | 2164 | IO_CODE(); |
373340b2 HR |
2165 | |
2166 | if (action == BLOCK_ERROR_ACTION_STOP) { | |
2167 | /* First set the iostatus, so that "info block" returns an iostatus | |
2168 | * that matches the events raised so far (an additional error iostatus | |
2169 | * is fine, but not a lost one). | |
2170 | */ | |
2171 | blk_iostatus_set_err(blk, error); | |
2172 | ||
2173 | /* Then raise the request to stop the VM and the event. | |
2174 | * qemu_system_vmstop_request_prepare has two effects. First, | |
2175 | * it ensures that the STOP event always comes after the | |
2176 | * BLOCK_IO_ERROR event. Second, it ensures that even if management | |
2177 | * can observe the STOP event and do a "cont" before the STOP | |
2178 | * event is issued, the VM will not stop. In this case, vm_start() | |
2179 | * also ensures that the STOP/RESUME pair of events is emitted. | |
2180 | */ | |
2181 | qemu_system_vmstop_request_prepare(); | |
2182 | send_qmp_error_event(blk, action, is_read, error); | |
2183 | qemu_system_vmstop_request(RUN_STATE_IO_ERROR); | |
2184 | } else { | |
2185 | send_qmp_error_event(blk, action, is_read, error); | |
2186 | } | |
4be74634 MA |
2187 | } |
2188 | ||
86b1cf32 KW |
2189 | /* |
2190 | * Returns true if the BlockBackend can support taking write permissions | |
2191 | * (because its root node is not read-only). | |
2192 | */ | |
2193 | bool blk_supports_write_perm(BlockBackend *blk) | |
4be74634 | 2194 | { |
f21d96d0 | 2195 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2196 | GLOBAL_STATE_CODE(); |
f21d96d0 KW |
2197 | |
2198 | if (bs) { | |
86b1cf32 | 2199 | return !bdrv_is_read_only(bs); |
061959e8 | 2200 | } else { |
260242a8 | 2201 | return blk->root_state.open_flags & BDRV_O_RDWR; |
061959e8 | 2202 | } |
4be74634 MA |
2203 | } |
2204 | ||
86b1cf32 KW |
2205 | /* |
2206 | * Returns true if the BlockBackend can be written to in its current | |
2207 | * configuration (i.e. if write permission have been requested) | |
2208 | */ | |
2209 | bool blk_is_writable(BlockBackend *blk) | |
2210 | { | |
37868b2a | 2211 | IO_CODE(); |
86b1cf32 KW |
2212 | return blk->perm & BLK_PERM_WRITE; |
2213 | } | |
2214 | ||
96710565 | 2215 | bool blk_is_sg(BlockBackend *blk) |
4be74634 | 2216 | { |
f21d96d0 | 2217 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2218 | GLOBAL_STATE_CODE(); |
f21d96d0 KW |
2219 | |
2220 | if (!bs) { | |
96710565 | 2221 | return false; |
a46fc9c9 HR |
2222 | } |
2223 | ||
f21d96d0 | 2224 | return bdrv_is_sg(bs); |
4be74634 MA |
2225 | } |
2226 | ||
96710565 | 2227 | bool blk_enable_write_cache(BlockBackend *blk) |
4be74634 | 2228 | { |
37868b2a | 2229 | IO_CODE(); |
bfd18d1e | 2230 | return blk->enable_write_cache; |
4be74634 MA |
2231 | } |
2232 | ||
2233 | void blk_set_enable_write_cache(BlockBackend *blk, bool wce) | |
2234 | { | |
be8da05b | 2235 | IO_CODE(); |
bfd18d1e | 2236 | blk->enable_write_cache = wce; |
4be74634 MA |
2237 | } |
2238 | ||
3b717194 | 2239 | void blk_activate(BlockBackend *blk, Error **errp) |
2bb0dce7 | 2240 | { |
f21d96d0 | 2241 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2242 | GLOBAL_STATE_CODE(); |
f21d96d0 KW |
2243 | |
2244 | if (!bs) { | |
c09ba36c HR |
2245 | error_setg(errp, "Device '%s' has no medium", blk->name); |
2246 | return; | |
2247 | } | |
2248 | ||
da4afaff KW |
2249 | /* |
2250 | * Migration code can call this function in coroutine context, so leave | |
2251 | * coroutine context if necessary. | |
2252 | */ | |
2253 | if (qemu_in_coroutine()) { | |
2254 | bdrv_co_activate(bs, errp); | |
2255 | } else { | |
2256 | bdrv_activate(bs, errp); | |
2257 | } | |
2bb0dce7 HR |
2258 | } |
2259 | ||
1e97be91 | 2260 | bool coroutine_fn blk_co_is_inserted(BlockBackend *blk) |
4be74634 | 2261 | { |
f21d96d0 | 2262 | BlockDriverState *bs = blk_bs(blk); |
37868b2a | 2263 | IO_CODE(); |
c73ff92c | 2264 | assert_bdrv_graph_readable(); |
f21d96d0 | 2265 | |
1e97be91 | 2266 | return bs && bdrv_co_is_inserted(bs); |
db0284f8 HR |
2267 | } |
2268 | ||
c73ff92c | 2269 | bool coroutine_fn blk_co_is_available(BlockBackend *blk) |
db0284f8 | 2270 | { |
37868b2a | 2271 | IO_CODE(); |
c73ff92c | 2272 | return blk_co_is_inserted(blk) && !blk_dev_is_tray_open(blk); |
4be74634 MA |
2273 | } |
2274 | ||
2c75261c | 2275 | void coroutine_fn blk_co_lock_medium(BlockBackend *blk, bool locked) |
4be74634 | 2276 | { |
f21d96d0 | 2277 | BlockDriverState *bs = blk_bs(blk); |
37868b2a | 2278 | IO_CODE(); |
79a292e5 | 2279 | GRAPH_RDLOCK_GUARD(); |
f21d96d0 KW |
2280 | |
2281 | if (bs) { | |
2c75261c | 2282 | bdrv_co_lock_medium(bs, locked); |
a46fc9c9 | 2283 | } |
4be74634 MA |
2284 | } |
2285 | ||
2531b390 | 2286 | void coroutine_fn blk_co_eject(BlockBackend *blk, bool eject_flag) |
4be74634 | 2287 | { |
f21d96d0 | 2288 | BlockDriverState *bs = blk_bs(blk); |
2d76e724 | 2289 | char *id; |
37868b2a | 2290 | IO_CODE(); |
79a292e5 | 2291 | GRAPH_RDLOCK_GUARD(); |
2d76e724 | 2292 | |
f21d96d0 | 2293 | if (bs) { |
2531b390 | 2294 | bdrv_co_eject(bs, eject_flag); |
a46fc9c9 | 2295 | } |
c47ee043 JS |
2296 | |
2297 | /* Whether or not we ejected on the backend, | |
2298 | * the frontend experienced a tray event. */ | |
2299 | id = blk_get_attached_dev_id(blk); | |
2300 | qapi_event_send_device_tray_moved(blk_name(blk), id, | |
3ab72385 | 2301 | eject_flag); |
c47ee043 | 2302 | g_free(id); |
4be74634 MA |
2303 | } |
2304 | ||
2305 | int blk_get_flags(BlockBackend *blk) | |
2306 | { | |
f21d96d0 | 2307 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2308 | GLOBAL_STATE_CODE(); |
f21d96d0 KW |
2309 | |
2310 | if (bs) { | |
2311 | return bdrv_get_flags(bs); | |
061959e8 HR |
2312 | } else { |
2313 | return blk->root_state.open_flags; | |
2314 | } | |
4be74634 MA |
2315 | } |
2316 | ||
4841211e EB |
2317 | /* Returns the minimum request alignment, in bytes; guaranteed nonzero */ |
2318 | uint32_t blk_get_request_alignment(BlockBackend *blk) | |
2319 | { | |
2320 | BlockDriverState *bs = blk_bs(blk); | |
37868b2a | 2321 | IO_CODE(); |
4841211e EB |
2322 | return bs ? bs->bl.request_alignment : BDRV_SECTOR_SIZE; |
2323 | } | |
2324 | ||
24b36e98 PB |
2325 | /* Returns the maximum hardware transfer length, in bytes; guaranteed nonzero */ |
2326 | uint64_t blk_get_max_hw_transfer(BlockBackend *blk) | |
2327 | { | |
2328 | BlockDriverState *bs = blk_bs(blk); | |
2329 | uint64_t max = INT_MAX; | |
37868b2a | 2330 | IO_CODE(); |
24b36e98 PB |
2331 | |
2332 | if (bs) { | |
2333 | max = MIN_NON_ZERO(max, bs->bl.max_hw_transfer); | |
2334 | max = MIN_NON_ZERO(max, bs->bl.max_transfer); | |
2335 | } | |
2336 | return ROUND_DOWN(max, blk_get_request_alignment(blk)); | |
2337 | } | |
2338 | ||
5def6b80 EB |
2339 | /* Returns the maximum transfer length, in bytes; guaranteed nonzero */ |
2340 | uint32_t blk_get_max_transfer(BlockBackend *blk) | |
454057b7 | 2341 | { |
f21d96d0 | 2342 | BlockDriverState *bs = blk_bs(blk); |
b99f7fa0 | 2343 | uint32_t max = INT_MAX; |
37868b2a | 2344 | IO_CODE(); |
f21d96d0 KW |
2345 | |
2346 | if (bs) { | |
b99f7fa0 | 2347 | max = MIN_NON_ZERO(max, bs->bl.max_transfer); |
a46fc9c9 | 2348 | } |
b99f7fa0 | 2349 | return ROUND_DOWN(max, blk_get_request_alignment(blk)); |
454057b7 PL |
2350 | } |
2351 | ||
cc071629 PB |
2352 | int blk_get_max_hw_iov(BlockBackend *blk) |
2353 | { | |
37868b2a | 2354 | IO_CODE(); |
cc071629 PB |
2355 | return MIN_NON_ZERO(blk->root->bs->bl.max_hw_iov, |
2356 | blk->root->bs->bl.max_iov); | |
2357 | } | |
2358 | ||
648296e0 SH |
2359 | int blk_get_max_iov(BlockBackend *blk) |
2360 | { | |
37868b2a | 2361 | IO_CODE(); |
f21d96d0 | 2362 | return blk->root->bs->bl.max_iov; |
648296e0 SH |
2363 | } |
2364 | ||
f1c17521 PB |
2365 | void *blk_try_blockalign(BlockBackend *blk, size_t size) |
2366 | { | |
37868b2a | 2367 | IO_CODE(); |
f21d96d0 | 2368 | return qemu_try_blockalign(blk ? blk_bs(blk) : NULL, size); |
f1c17521 PB |
2369 | } |
2370 | ||
4be74634 MA |
2371 | void *blk_blockalign(BlockBackend *blk, size_t size) |
2372 | { | |
37868b2a | 2373 | IO_CODE(); |
f21d96d0 | 2374 | return qemu_blockalign(blk ? blk_bs(blk) : NULL, size); |
4be74634 MA |
2375 | } |
2376 | ||
2377 | bool blk_op_is_blocked(BlockBackend *blk, BlockOpType op, Error **errp) | |
2378 | { | |
f21d96d0 | 2379 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2380 | GLOBAL_STATE_CODE(); |
f21d96d0 KW |
2381 | |
2382 | if (!bs) { | |
a46fc9c9 HR |
2383 | return false; |
2384 | } | |
2385 | ||
f21d96d0 | 2386 | return bdrv_op_is_blocked(bs, op, errp); |
4be74634 MA |
2387 | } |
2388 | ||
2389 | void blk_op_unblock(BlockBackend *blk, BlockOpType op, Error *reason) | |
2390 | { | |
f21d96d0 | 2391 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2392 | GLOBAL_STATE_CODE(); |
f21d96d0 KW |
2393 | |
2394 | if (bs) { | |
2395 | bdrv_op_unblock(bs, op, reason); | |
a46fc9c9 | 2396 | } |
4be74634 MA |
2397 | } |
2398 | ||
2399 | void blk_op_block_all(BlockBackend *blk, Error *reason) | |
2400 | { | |
f21d96d0 | 2401 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2402 | GLOBAL_STATE_CODE(); |
f21d96d0 KW |
2403 | |
2404 | if (bs) { | |
2405 | bdrv_op_block_all(bs, reason); | |
a46fc9c9 | 2406 | } |
4be74634 MA |
2407 | } |
2408 | ||
2409 | void blk_op_unblock_all(BlockBackend *blk, Error *reason) | |
2410 | { | |
f21d96d0 | 2411 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2412 | GLOBAL_STATE_CODE(); |
f21d96d0 KW |
2413 | |
2414 | if (bs) { | |
2415 | bdrv_op_unblock_all(bs, reason); | |
a46fc9c9 | 2416 | } |
4be74634 MA |
2417 | } |
2418 | ||
2419 | AioContext *blk_get_aio_context(BlockBackend *blk) | |
2420 | { | |
dea97c1f | 2421 | BlockDriverState *bs; |
37868b2a | 2422 | IO_CODE(); |
d861ab3a | 2423 | |
dea97c1f KW |
2424 | if (!blk) { |
2425 | return qemu_get_aio_context(); | |
2426 | } | |
2427 | ||
2428 | bs = blk_bs(blk); | |
d861ab3a | 2429 | if (bs) { |
132ada80 KW |
2430 | AioContext *ctx = bdrv_get_aio_context(blk_bs(blk)); |
2431 | assert(ctx == blk->ctx); | |
d861ab3a KW |
2432 | } |
2433 | ||
2434 | return blk->ctx; | |
4981bdec HR |
2435 | } |
2436 | ||
2437 | static AioContext *blk_aiocb_get_aio_context(BlockAIOCB *acb) | |
2438 | { | |
2439 | BlockBackendAIOCB *blk_acb = DO_UPCAST(BlockBackendAIOCB, common, acb); | |
2440 | return blk_get_aio_context(blk_acb->blk); | |
4be74634 MA |
2441 | } |
2442 | ||
2d196295 SH |
2443 | int blk_set_aio_context(BlockBackend *blk, AioContext *new_context, |
2444 | Error **errp) | |
4be74634 | 2445 | { |
2d196295 | 2446 | bool old_allow_change; |
f21d96d0 | 2447 | BlockDriverState *bs = blk_bs(blk); |
97896a48 | 2448 | int ret; |
f21d96d0 | 2449 | |
2d196295 | 2450 | GLOBAL_STATE_CODE(); |
1e3552db | 2451 | |
2d196295 | 2452 | if (!bs) { |
af5b6ebe | 2453 | blk->ctx = new_context; |
2d196295 | 2454 | return 0; |
a46fc9c9 | 2455 | } |
97896a48 | 2456 | |
2d196295 | 2457 | bdrv_ref(bs); |
4be74634 | 2458 | |
2d196295 SH |
2459 | old_allow_change = blk->allow_aio_context_change; |
2460 | blk->allow_aio_context_change = true; | |
2461 | ||
2462 | ret = bdrv_try_change_aio_context(bs, new_context, NULL, errp); | |
2463 | ||
2464 | blk->allow_aio_context_change = old_allow_change; | |
2465 | ||
2466 | bdrv_unref(bs); | |
2467 | return ret; | |
38475269 KW |
2468 | } |
2469 | ||
33949396 EGE |
2470 | typedef struct BdrvStateBlkRootContext { |
2471 | AioContext *new_ctx; | |
2472 | BlockBackend *blk; | |
2473 | } BdrvStateBlkRootContext; | |
2474 | ||
2475 | static void blk_root_set_aio_ctx_commit(void *opaque) | |
2476 | { | |
2477 | BdrvStateBlkRootContext *s = opaque; | |
2478 | BlockBackend *blk = s->blk; | |
2d196295 SH |
2479 | AioContext *new_context = s->new_ctx; |
2480 | ThrottleGroupMember *tgm = &blk->public.throttle_group_member; | |
33949396 | 2481 | |
2d196295 SH |
2482 | blk->ctx = new_context; |
2483 | if (tgm->throttle_state) { | |
2484 | throttle_group_detach_aio_context(tgm); | |
2485 | throttle_group_attach_aio_context(tgm, new_context); | |
2486 | } | |
33949396 EGE |
2487 | } |
2488 | ||
2489 | static TransactionActionDrv set_blk_root_context = { | |
2490 | .commit = blk_root_set_aio_ctx_commit, | |
2491 | .clean = g_free, | |
2492 | }; | |
2493 | ||
2494 | static bool blk_root_change_aio_ctx(BdrvChild *child, AioContext *ctx, | |
2495 | GHashTable *visited, Transaction *tran, | |
2496 | Error **errp) | |
38475269 KW |
2497 | { |
2498 | BlockBackend *blk = child->opaque; | |
33949396 | 2499 | BdrvStateBlkRootContext *s; |
38475269 | 2500 | |
33949396 EGE |
2501 | if (!blk->allow_aio_context_change) { |
2502 | /* | |
2503 | * Manually created BlockBackends (those with a name) that are not | |
2504 | * attached to anything can change their AioContext without updating | |
2505 | * their user; return an error for others. | |
2506 | */ | |
2507 | if (!blk->name || blk->dev) { | |
2508 | /* TODO Add BB name/QOM path */ | |
2509 | error_setg(errp, "Cannot change iothread of active block backend"); | |
2510 | return false; | |
2511 | } | |
980b0f94 KW |
2512 | } |
2513 | ||
33949396 EGE |
2514 | s = g_new(BdrvStateBlkRootContext, 1); |
2515 | *s = (BdrvStateBlkRootContext) { | |
2516 | .new_ctx = ctx, | |
2517 | .blk = blk, | |
2518 | }; | |
38475269 | 2519 | |
33949396 | 2520 | tran_add(tran, &set_blk_root_context, s); |
38475269 KW |
2521 | return true; |
2522 | } | |
2523 | ||
2019ba0a HR |
2524 | void blk_add_aio_context_notifier(BlockBackend *blk, |
2525 | void (*attached_aio_context)(AioContext *new_context, void *opaque), | |
2526 | void (*detach_aio_context)(void *opaque), void *opaque) | |
2527 | { | |
d03654ea | 2528 | BlockBackendAioNotifier *notifier; |
f21d96d0 | 2529 | BlockDriverState *bs = blk_bs(blk); |
0439c5a4 | 2530 | GLOBAL_STATE_CODE(); |
f21d96d0 | 2531 | |
d03654ea SH |
2532 | notifier = g_new(BlockBackendAioNotifier, 1); |
2533 | notifier->attached_aio_context = attached_aio_context; | |
2534 | notifier->detach_aio_context = detach_aio_context; | |
2535 | notifier->opaque = opaque; | |
2536 | QLIST_INSERT_HEAD(&blk->aio_notifiers, notifier, list); | |
2537 | ||
f21d96d0 KW |
2538 | if (bs) { |
2539 | bdrv_add_aio_context_notifier(bs, attached_aio_context, | |
a46fc9c9 HR |
2540 | detach_aio_context, opaque); |
2541 | } | |
2019ba0a HR |
2542 | } |
2543 | ||
2544 | void blk_remove_aio_context_notifier(BlockBackend *blk, | |
2545 | void (*attached_aio_context)(AioContext *, | |
2546 | void *), | |
2547 | void (*detach_aio_context)(void *), | |
2548 | void *opaque) | |
2549 | { | |
d03654ea | 2550 | BlockBackendAioNotifier *notifier; |
f21d96d0 KW |
2551 | BlockDriverState *bs = blk_bs(blk); |
2552 | ||
0439c5a4 EGE |
2553 | GLOBAL_STATE_CODE(); |
2554 | ||
f21d96d0 KW |
2555 | if (bs) { |
2556 | bdrv_remove_aio_context_notifier(bs, attached_aio_context, | |
a46fc9c9 HR |
2557 | detach_aio_context, opaque); |
2558 | } | |
d03654ea SH |
2559 | |
2560 | QLIST_FOREACH(notifier, &blk->aio_notifiers, list) { | |
2561 | if (notifier->attached_aio_context == attached_aio_context && | |
2562 | notifier->detach_aio_context == detach_aio_context && | |
2563 | notifier->opaque == opaque) { | |
2564 | QLIST_REMOVE(notifier, list); | |
2565 | g_free(notifier); | |
2566 | return; | |
2567 | } | |
2568 | } | |
2569 | ||
2570 | abort(); | |
2019ba0a HR |
2571 | } |
2572 | ||
3301f6c6 HR |
2573 | void blk_add_remove_bs_notifier(BlockBackend *blk, Notifier *notify) |
2574 | { | |
0439c5a4 | 2575 | GLOBAL_STATE_CODE(); |
3301f6c6 HR |
2576 | notifier_list_add(&blk->remove_bs_notifiers, notify); |
2577 | } | |
2578 | ||
2579 | void blk_add_insert_bs_notifier(BlockBackend *blk, Notifier *notify) | |
2580 | { | |
0439c5a4 | 2581 | GLOBAL_STATE_CODE(); |
3301f6c6 HR |
2582 | notifier_list_add(&blk->insert_bs_notifiers, notify); |
2583 | } | |
2584 | ||
4be74634 MA |
2585 | BlockAcctStats *blk_get_stats(BlockBackend *blk) |
2586 | { | |
37868b2a | 2587 | IO_CODE(); |
7f0e9da6 | 2588 | return &blk->stats; |
4be74634 MA |
2589 | } |
2590 | ||
2591 | void *blk_aio_get(const AIOCBInfo *aiocb_info, BlockBackend *blk, | |
2592 | BlockCompletionFunc *cb, void *opaque) | |
2593 | { | |
37868b2a | 2594 | IO_CODE(); |
4be74634 MA |
2595 | return qemu_aio_get(aiocb_info, blk_bs(blk), cb, opaque); |
2596 | } | |
1ef01253 | 2597 | |
d004bd52 | 2598 | int coroutine_fn blk_co_pwrite_zeroes(BlockBackend *blk, int64_t offset, |
34460feb | 2599 | int64_t bytes, BdrvRequestFlags flags) |
1ef01253 | 2600 | { |
37868b2a | 2601 | IO_OR_GS_CODE(); |
f5a5ca79 | 2602 | return blk_co_pwritev(blk, offset, bytes, NULL, |
16aaf975 | 2603 | flags | BDRV_REQ_ZERO_WRITE); |
1ef01253 HR |
2604 | } |
2605 | ||
2c9715fa AF |
2606 | int coroutine_fn blk_co_pwrite_compressed(BlockBackend *blk, int64_t offset, |
2607 | int64_t bytes, const void *buf) | |
1ef01253 | 2608 | { |
06f0325c | 2609 | QEMUIOVector qiov = QEMU_IOVEC_INIT_BUF(qiov, buf, bytes); |
37868b2a | 2610 | IO_OR_GS_CODE(); |
2c9715fa AF |
2611 | return blk_co_pwritev_part(blk, offset, bytes, &qiov, 0, |
2612 | BDRV_REQ_WRITE_COMPRESSED); | |
1ef01253 HR |
2613 | } |
2614 | ||
015ed252 AF |
2615 | int coroutine_fn blk_co_truncate(BlockBackend *blk, int64_t offset, bool exact, |
2616 | PreallocMode prealloc, BdrvRequestFlags flags, | |
2617 | Error **errp) | |
1ef01253 | 2618 | { |
37868b2a | 2619 | IO_OR_GS_CODE(); |
c2b8e315 | 2620 | GRAPH_RDLOCK_GUARD(); |
c73ff92c | 2621 | if (!blk_co_is_available(blk)) { |
ed3d2ec9 | 2622 | error_setg(errp, "No medium inserted"); |
c09ba36c HR |
2623 | return -ENOMEDIUM; |
2624 | } | |
2625 | ||
015ed252 | 2626 | return bdrv_co_truncate(blk->root, offset, exact, prealloc, flags, errp); |
1ef01253 HR |
2627 | } |
2628 | ||
1ef01253 HR |
2629 | int blk_save_vmstate(BlockBackend *blk, const uint8_t *buf, |
2630 | int64_t pos, int size) | |
2631 | { | |
bfd18d1e | 2632 | int ret; |
0439c5a4 | 2633 | GLOBAL_STATE_CODE(); |
bfd18d1e | 2634 | |
c09ba36c HR |
2635 | if (!blk_is_available(blk)) { |
2636 | return -ENOMEDIUM; | |
2637 | } | |
2638 | ||
bfd18d1e KW |
2639 | ret = bdrv_save_vmstate(blk_bs(blk), buf, pos, size); |
2640 | if (ret < 0) { | |
2641 | return ret; | |
2642 | } | |
2643 | ||
2644 | if (ret == size && !blk->enable_write_cache) { | |
2645 | ret = bdrv_flush(blk_bs(blk)); | |
2646 | } | |
2647 | ||
2648 | return ret < 0 ? ret : size; | |
1ef01253 HR |
2649 | } |
2650 | ||
2651 | int blk_load_vmstate(BlockBackend *blk, uint8_t *buf, int64_t pos, int size) | |
2652 | { | |
0439c5a4 | 2653 | GLOBAL_STATE_CODE(); |
c09ba36c HR |
2654 | if (!blk_is_available(blk)) { |
2655 | return -ENOMEDIUM; | |
2656 | } | |
2657 | ||
f21d96d0 | 2658 | return bdrv_load_vmstate(blk_bs(blk), buf, pos, size); |
1ef01253 | 2659 | } |
f0272c4d ET |
2660 | |
2661 | int blk_probe_blocksizes(BlockBackend *blk, BlockSizes *bsz) | |
2662 | { | |
0439c5a4 | 2663 | GLOBAL_STATE_CODE(); |
c09ba36c HR |
2664 | if (!blk_is_available(blk)) { |
2665 | return -ENOMEDIUM; | |
2666 | } | |
2667 | ||
f21d96d0 | 2668 | return bdrv_probe_blocksizes(blk_bs(blk), bsz); |
f0272c4d ET |
2669 | } |
2670 | ||
2671 | int blk_probe_geometry(BlockBackend *blk, HDGeometry *geo) | |
2672 | { | |
0439c5a4 | 2673 | GLOBAL_STATE_CODE(); |
c09ba36c HR |
2674 | if (!blk_is_available(blk)) { |
2675 | return -ENOMEDIUM; | |
2676 | } | |
2677 | ||
f21d96d0 | 2678 | return bdrv_probe_geometry(blk_bs(blk), geo); |
f0272c4d | 2679 | } |
281d22d8 HR |
2680 | |
2681 | /* | |
2682 | * Updates the BlockBackendRootState object with data from the currently | |
2683 | * attached BlockDriverState. | |
2684 | */ | |
2685 | void blk_update_root_state(BlockBackend *blk) | |
2686 | { | |
0439c5a4 | 2687 | GLOBAL_STATE_CODE(); |
f21d96d0 | 2688 | assert(blk->root); |
281d22d8 | 2689 | |
f21d96d0 | 2690 | blk->root_state.open_flags = blk->root->bs->open_flags; |
f21d96d0 | 2691 | blk->root_state.detect_zeroes = blk->root->bs->detect_zeroes; |
281d22d8 HR |
2692 | } |
2693 | ||
38cb18f5 | 2694 | /* |
b85114f8 KW |
2695 | * Returns the detect-zeroes setting to be used for bdrv_open() of a |
2696 | * BlockDriverState which is supposed to inherit the root state. | |
38cb18f5 | 2697 | */ |
b85114f8 | 2698 | bool blk_get_detect_zeroes_from_root_state(BlockBackend *blk) |
38cb18f5 | 2699 | { |
0439c5a4 | 2700 | GLOBAL_STATE_CODE(); |
b85114f8 | 2701 | return blk->root_state.detect_zeroes; |
38cb18f5 HR |
2702 | } |
2703 | ||
2704 | /* | |
2705 | * Returns the flags to be used for bdrv_open() of a BlockDriverState which is | |
2706 | * supposed to inherit the root state. | |
2707 | */ | |
2708 | int blk_get_open_flags_from_root_state(BlockBackend *blk) | |
2709 | { | |
0439c5a4 | 2710 | GLOBAL_STATE_CODE(); |
260242a8 | 2711 | return blk->root_state.open_flags; |
38cb18f5 HR |
2712 | } |
2713 | ||
281d22d8 HR |
2714 | BlockBackendRootState *blk_get_root_state(BlockBackend *blk) |
2715 | { | |
0439c5a4 | 2716 | GLOBAL_STATE_CODE(); |
281d22d8 HR |
2717 | return &blk->root_state; |
2718 | } | |
1393f212 HR |
2719 | |
2720 | int blk_commit_all(void) | |
2721 | { | |
fe1a9cbc | 2722 | BlockBackend *blk = NULL; |
0439c5a4 | 2723 | GLOBAL_STATE_CODE(); |
fe1a9cbc HR |
2724 | |
2725 | while ((blk = blk_all_next(blk)) != NULL) { | |
2726 | AioContext *aio_context = blk_get_aio_context(blk); | |
9a71b9de | 2727 | BlockDriverState *unfiltered_bs = bdrv_skip_filters(blk_bs(blk)); |
fe1a9cbc HR |
2728 | |
2729 | aio_context_acquire(aio_context); | |
9a71b9de HR |
2730 | if (blk_is_inserted(blk) && bdrv_cow_child(unfiltered_bs)) { |
2731 | int ret; | |
2732 | ||
2733 | ret = bdrv_commit(unfiltered_bs); | |
fe1a9cbc HR |
2734 | if (ret < 0) { |
2735 | aio_context_release(aio_context); | |
2736 | return ret; | |
2737 | } | |
2738 | } | |
2739 | aio_context_release(aio_context); | |
2740 | } | |
2741 | return 0; | |
2742 | } | |
2743 | ||
97148076 KW |
2744 | |
2745 | /* throttling disk I/O limits */ | |
2746 | void blk_set_io_limits(BlockBackend *blk, ThrottleConfig *cfg) | |
2747 | { | |
0439c5a4 | 2748 | GLOBAL_STATE_CODE(); |
022cdc9f | 2749 | throttle_group_config(&blk->public.throttle_group_member, cfg); |
97148076 KW |
2750 | } |
2751 | ||
2752 | void blk_io_limits_disable(BlockBackend *blk) | |
2753 | { | |
48bf7ea8 AG |
2754 | BlockDriverState *bs = blk_bs(blk); |
2755 | ThrottleGroupMember *tgm = &blk->public.throttle_group_member; | |
2756 | assert(tgm->throttle_state); | |
0439c5a4 | 2757 | GLOBAL_STATE_CODE(); |
48bf7ea8 | 2758 | if (bs) { |
1e3552db | 2759 | bdrv_ref(bs); |
48bf7ea8 AG |
2760 | bdrv_drained_begin(bs); |
2761 | } | |
2762 | throttle_group_unregister_tgm(tgm); | |
2763 | if (bs) { | |
2764 | bdrv_drained_end(bs); | |
1e3552db | 2765 | bdrv_unref(bs); |
48bf7ea8 | 2766 | } |
97148076 KW |
2767 | } |
2768 | ||
2769 | /* should be called before blk_set_io_limits if a limit is set */ | |
2770 | void blk_io_limits_enable(BlockBackend *blk, const char *group) | |
2771 | { | |
022cdc9f | 2772 | assert(!blk->public.throttle_group_member.throttle_state); |
0439c5a4 | 2773 | GLOBAL_STATE_CODE(); |
c61791fc MP |
2774 | throttle_group_register_tgm(&blk->public.throttle_group_member, |
2775 | group, blk_get_aio_context(blk)); | |
97148076 KW |
2776 | } |
2777 | ||
2778 | void blk_io_limits_update_group(BlockBackend *blk, const char *group) | |
2779 | { | |
0439c5a4 | 2780 | GLOBAL_STATE_CODE(); |
97148076 | 2781 | /* this BB is not part of any group */ |
022cdc9f | 2782 | if (!blk->public.throttle_group_member.throttle_state) { |
97148076 KW |
2783 | return; |
2784 | } | |
2785 | ||
2786 | /* this BB is a part of the same group than the one we want */ | |
022cdc9f MP |
2787 | if (!g_strcmp0(throttle_group_get_name(&blk->public.throttle_group_member), |
2788 | group)) { | |
97148076 KW |
2789 | return; |
2790 | } | |
2791 | ||
2792 | /* need to change the group this bs belong to */ | |
2793 | blk_io_limits_disable(blk); | |
2794 | blk_io_limits_enable(blk, group); | |
2795 | } | |
c2066af0 KW |
2796 | |
2797 | static void blk_root_drained_begin(BdrvChild *child) | |
2798 | { | |
2799 | BlockBackend *blk = child->opaque; | |
d73415a3 | 2800 | ThrottleGroupMember *tgm = &blk->public.throttle_group_member; |
c2066af0 | 2801 | |
c4d5bf99 | 2802 | if (qatomic_fetch_inc(&blk->quiesce_counter) == 0) { |
f4d9cc88 JS |
2803 | if (blk->dev_ops && blk->dev_ops->drained_begin) { |
2804 | blk->dev_ops->drained_begin(blk->dev_opaque); | |
2805 | } | |
2806 | } | |
2807 | ||
36fe1331 KW |
2808 | /* Note that blk->root may not be accessible here yet if we are just |
2809 | * attaching to a BlockDriverState that is drained. Use child instead. */ | |
2810 | ||
d73415a3 SH |
2811 | if (qatomic_fetch_inc(&tgm->io_limits_disabled) == 0) { |
2812 | throttle_group_restart_tgm(tgm); | |
c2066af0 KW |
2813 | } |
2814 | } | |
2815 | ||
fe5258a5 KW |
2816 | static bool blk_root_drained_poll(BdrvChild *child) |
2817 | { | |
2818 | BlockBackend *blk = child->opaque; | |
095cc4d0 | 2819 | bool busy = false; |
c4d5bf99 | 2820 | assert(qatomic_read(&blk->quiesce_counter)); |
095cc4d0 SL |
2821 | |
2822 | if (blk->dev_ops && blk->dev_ops->drained_poll) { | |
2823 | busy = blk->dev_ops->drained_poll(blk->dev_opaque); | |
2824 | } | |
2825 | return busy || !!blk->in_flight; | |
fe5258a5 KW |
2826 | } |
2827 | ||
2f65df6e | 2828 | static void blk_root_drained_end(BdrvChild *child) |
c2066af0 KW |
2829 | { |
2830 | BlockBackend *blk = child->opaque; | |
c4d5bf99 | 2831 | assert(qatomic_read(&blk->quiesce_counter)); |
c2066af0 | 2832 | |
022cdc9f | 2833 | assert(blk->public.throttle_group_member.io_limits_disabled); |
d73415a3 | 2834 | qatomic_dec(&blk->public.throttle_group_member.io_limits_disabled); |
f4d9cc88 | 2835 | |
c4d5bf99 | 2836 | if (qatomic_fetch_dec(&blk->quiesce_counter) == 1) { |
f4d9cc88 JS |
2837 | if (blk->dev_ops && blk->dev_ops->drained_end) { |
2838 | blk->dev_ops->drained_end(blk->dev_opaque); | |
2839 | } | |
407ae2ae SH |
2840 | qemu_mutex_lock(&blk->queued_requests_lock); |
2841 | while (qemu_co_enter_next(&blk->queued_requests, | |
2842 | &blk->queued_requests_lock)) { | |
cf312932 KW |
2843 | /* Resume all queued requests */ |
2844 | } | |
407ae2ae | 2845 | qemu_mutex_unlock(&blk->queued_requests_lock); |
f4d9cc88 | 2846 | } |
c2066af0 | 2847 | } |
23d0ba93 | 2848 | |
f4ec04ba | 2849 | bool blk_register_buf(BlockBackend *blk, void *host, size_t size, Error **errp) |
23d0ba93 | 2850 | { |
71038951 SH |
2851 | BlockDriverState *bs = blk_bs(blk); |
2852 | ||
0439c5a4 | 2853 | GLOBAL_STATE_CODE(); |
71038951 SH |
2854 | |
2855 | if (bs) { | |
2856 | return bdrv_register_buf(bs, host, size, errp); | |
2857 | } | |
2858 | return true; | |
23d0ba93 FZ |
2859 | } |
2860 | ||
4f384011 | 2861 | void blk_unregister_buf(BlockBackend *blk, void *host, size_t size) |
23d0ba93 | 2862 | { |
71038951 SH |
2863 | BlockDriverState *bs = blk_bs(blk); |
2864 | ||
0439c5a4 | 2865 | GLOBAL_STATE_CODE(); |
71038951 SH |
2866 | |
2867 | if (bs) { | |
2868 | bdrv_unregister_buf(bs, host, size); | |
2869 | } | |
23d0ba93 | 2870 | } |
b5679fa4 FZ |
2871 | |
2872 | int coroutine_fn blk_co_copy_range(BlockBackend *blk_in, int64_t off_in, | |
2873 | BlockBackend *blk_out, int64_t off_out, | |
e192179b | 2874 | int64_t bytes, BdrvRequestFlags read_flags, |
67b51fb9 | 2875 | BdrvRequestFlags write_flags) |
b5679fa4 FZ |
2876 | { |
2877 | int r; | |
37868b2a | 2878 | IO_CODE(); |
c73ff92c | 2879 | GRAPH_RDLOCK_GUARD(); |
37868b2a | 2880 | |
b5679fa4 FZ |
2881 | r = blk_check_byte_request(blk_in, off_in, bytes); |
2882 | if (r) { | |
2883 | return r; | |
2884 | } | |
2885 | r = blk_check_byte_request(blk_out, off_out, bytes); | |
2886 | if (r) { | |
2887 | return r; | |
2888 | } | |
742bf09b | 2889 | |
b5679fa4 FZ |
2890 | return bdrv_co_copy_range(blk_in->root, off_in, |
2891 | blk_out->root, off_out, | |
67b51fb9 | 2892 | bytes, read_flags, write_flags); |
b5679fa4 | 2893 | } |
5d3b4e99 VSO |
2894 | |
2895 | const BdrvChild *blk_root(BlockBackend *blk) | |
2896 | { | |
0439c5a4 | 2897 | GLOBAL_STATE_CODE(); |
5d3b4e99 VSO |
2898 | return blk->root; |
2899 | } | |
2b7bbdbd HR |
2900 | |
2901 | int blk_make_empty(BlockBackend *blk, Error **errp) | |
2902 | { | |
0439c5a4 | 2903 | GLOBAL_STATE_CODE(); |
2b7bbdbd HR |
2904 | if (!blk_is_available(blk)) { |
2905 | error_setg(errp, "No medium inserted"); | |
2906 | return -ENOMEDIUM; | |
2907 | } | |
2908 | ||
2909 | return bdrv_make_empty(blk->root, errp); | |
2910 | } |