2 * QEMU System Emulator block driver
4 * Copyright (c) 2011 IBM Corp.
5 * Copyright (c) 2012 Red Hat, Inc.
7 * Permission is hereby granted, free of charge, to any person obtaining a copy
8 * of this software and associated documentation files (the "Software"), to deal
9 * in the Software without restriction, including without limitation the rights
10 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 * copies of the Software, and to permit persons to whom the Software is
12 * furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included in
15 * all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
26 #include "config-host.h"
27 #include "qemu-common.h"
29 #include "block/block.h"
30 #include "block/blockjob.h"
31 #include "block/block_int.h"
32 #include "sysemu/block-backend.h"
33 #include "qapi/qmp/qerror.h"
34 #include "qapi/qmp/qjson.h"
35 #include "qemu/coroutine.h"
36 #include "qmp-commands.h"
37 #include "qemu/timer.h"
38 #include "qapi-event.h"
40 void *block_job_create(const BlockJobDriver
*driver
, BlockDriverState
*bs
,
41 int64_t speed
, BlockCompletionFunc
*cb
,
42 void *opaque
, Error
**errp
)
47 error_setg(errp
, QERR_DEVICE_IN_USE
, bdrv_get_device_name(bs
));
51 job
= g_malloc0(driver
->instance_size
);
52 error_setg(&job
->blocker
, "block device is in use by block job: %s",
53 BlockJobType_lookup
[driver
->job_type
]);
54 bdrv_op_block_all(bs
, job
->blocker
);
55 bdrv_op_unblock(bs
, BLOCK_OP_TYPE_DATAPLANE
, job
->blocker
);
58 job
->id
= g_strdup(bdrv_get_device_name(bs
));
66 /* Only set speed when necessary to avoid NotSupported error */
68 Error
*local_err
= NULL
;
70 block_job_set_speed(job
, speed
, &local_err
);
73 error_propagate(errp
, local_err
);
80 void block_job_ref(BlockJob
*job
)
85 void block_job_unref(BlockJob
*job
)
87 if (--job
->refcnt
== 0) {
89 bdrv_op_unblock_all(job
->bs
, job
->blocker
);
91 error_free(job
->blocker
);
97 void block_job_completed(BlockJob
*job
, int ret
)
99 BlockDriverState
*bs
= job
->bs
;
101 assert(bs
->job
== job
);
102 assert(!job
->completed
);
103 job
->completed
= true;
105 job
->cb(job
->opaque
, ret
);
106 block_job_unref(job
);
109 void block_job_set_speed(BlockJob
*job
, int64_t speed
, Error
**errp
)
111 Error
*local_err
= NULL
;
113 if (!job
->driver
->set_speed
) {
114 error_setg(errp
, QERR_UNSUPPORTED
);
117 job
->driver
->set_speed(job
, speed
, &local_err
);
119 error_propagate(errp
, local_err
);
126 void block_job_complete(BlockJob
*job
, Error
**errp
)
128 if (job
->pause_count
|| job
->cancelled
|| !job
->driver
->complete
) {
129 error_setg(errp
, QERR_BLOCK_JOB_NOT_READY
, job
->id
);
133 job
->driver
->complete(job
, errp
);
136 void block_job_pause(BlockJob
*job
)
141 bool block_job_is_paused(BlockJob
*job
)
143 return job
->pause_count
> 0;
146 void block_job_resume(BlockJob
*job
)
148 assert(job
->pause_count
> 0);
150 if (job
->pause_count
) {
153 block_job_enter(job
);
156 void block_job_enter(BlockJob
*job
)
158 block_job_iostatus_reset(job
);
159 if (job
->co
&& !job
->busy
) {
160 qemu_coroutine_enter(job
->co
, NULL
);
164 void block_job_cancel(BlockJob
*job
)
166 job
->cancelled
= true;
167 block_job_enter(job
);
170 bool block_job_is_cancelled(BlockJob
*job
)
172 return job
->cancelled
;
175 void block_job_iostatus_reset(BlockJob
*job
)
177 job
->iostatus
= BLOCK_DEVICE_IO_STATUS_OK
;
178 if (job
->driver
->iostatus_reset
) {
179 job
->driver
->iostatus_reset(job
);
183 struct BlockFinishData
{
185 BlockCompletionFunc
*cb
;
191 static void block_job_finish_cb(void *opaque
, int ret
)
193 struct BlockFinishData
*data
= opaque
;
195 data
->cancelled
= block_job_is_cancelled(data
->job
);
197 data
->cb(data
->opaque
, ret
);
200 static int block_job_finish_sync(BlockJob
*job
,
201 void (*finish
)(BlockJob
*, Error
**errp
),
204 struct BlockFinishData data
;
205 BlockDriverState
*bs
= job
->bs
;
206 Error
*local_err
= NULL
;
208 assert(bs
->job
== job
);
210 /* Set up our own callback to store the result and chain to
211 * the original callback.
215 data
.opaque
= job
->opaque
;
216 data
.ret
= -EINPROGRESS
;
217 job
->cb
= block_job_finish_cb
;
219 finish(job
, &local_err
);
221 error_propagate(errp
, local_err
);
224 while (data
.ret
== -EINPROGRESS
) {
225 aio_poll(bdrv_get_aio_context(bs
), true);
227 return (data
.cancelled
&& data
.ret
== 0) ? -ECANCELED
: data
.ret
;
230 /* A wrapper around block_job_cancel() taking an Error ** parameter so it may be
231 * used with block_job_finish_sync() without the need for (rather nasty)
232 * function pointer casts there. */
233 static void block_job_cancel_err(BlockJob
*job
, Error
**errp
)
235 block_job_cancel(job
);
238 int block_job_cancel_sync(BlockJob
*job
)
240 return block_job_finish_sync(job
, &block_job_cancel_err
, NULL
);
243 int block_job_complete_sync(BlockJob
*job
, Error
**errp
)
245 return block_job_finish_sync(job
, &block_job_complete
, errp
);
248 void block_job_sleep_ns(BlockJob
*job
, QEMUClockType type
, int64_t ns
)
252 /* Check cancellation *before* setting busy = false, too! */
253 if (block_job_is_cancelled(job
)) {
258 if (block_job_is_paused(job
)) {
259 qemu_coroutine_yield();
261 co_aio_sleep_ns(bdrv_get_aio_context(job
->bs
), type
, ns
);
266 void block_job_yield(BlockJob
*job
)
270 /* Check cancellation *before* setting busy = false, too! */
271 if (block_job_is_cancelled(job
)) {
276 qemu_coroutine_yield();
280 BlockJobInfo
*block_job_query(BlockJob
*job
)
282 BlockJobInfo
*info
= g_new0(BlockJobInfo
, 1);
283 info
->type
= g_strdup(BlockJobType_lookup
[job
->driver
->job_type
]);
284 info
->device
= g_strdup(job
->id
);
285 info
->len
= job
->len
;
286 info
->busy
= job
->busy
;
287 info
->paused
= job
->pause_count
> 0;
288 info
->offset
= job
->offset
;
289 info
->speed
= job
->speed
;
290 info
->io_status
= job
->iostatus
;
291 info
->ready
= job
->ready
;
295 static void block_job_iostatus_set_err(BlockJob
*job
, int error
)
297 if (job
->iostatus
== BLOCK_DEVICE_IO_STATUS_OK
) {
298 job
->iostatus
= error
== ENOSPC
? BLOCK_DEVICE_IO_STATUS_NOSPACE
:
299 BLOCK_DEVICE_IO_STATUS_FAILED
;
303 void block_job_event_cancelled(BlockJob
*job
)
305 qapi_event_send_block_job_cancelled(job
->driver
->job_type
,
313 void block_job_event_completed(BlockJob
*job
, const char *msg
)
315 qapi_event_send_block_job_completed(job
->driver
->job_type
,
325 void block_job_event_ready(BlockJob
*job
)
329 qapi_event_send_block_job_ready(job
->driver
->job_type
,
333 job
->speed
, &error_abort
);
336 BlockErrorAction
block_job_error_action(BlockJob
*job
, BlockDriverState
*bs
,
337 BlockdevOnError on_err
,
338 int is_read
, int error
)
340 BlockErrorAction action
;
343 case BLOCKDEV_ON_ERROR_ENOSPC
:
344 action
= (error
== ENOSPC
) ?
345 BLOCK_ERROR_ACTION_STOP
: BLOCK_ERROR_ACTION_REPORT
;
347 case BLOCKDEV_ON_ERROR_STOP
:
348 action
= BLOCK_ERROR_ACTION_STOP
;
350 case BLOCKDEV_ON_ERROR_REPORT
:
351 action
= BLOCK_ERROR_ACTION_REPORT
;
353 case BLOCKDEV_ON_ERROR_IGNORE
:
354 action
= BLOCK_ERROR_ACTION_IGNORE
;
359 qapi_event_send_block_job_error(job
->id
,
360 is_read
? IO_OPERATION_TYPE_READ
:
361 IO_OPERATION_TYPE_WRITE
,
362 action
, &error_abort
);
363 if (action
== BLOCK_ERROR_ACTION_STOP
) {
364 /* make the pause user visible, which will be resumed from QMP. */
365 job
->user_paused
= true;
366 block_job_pause(job
);
367 block_job_iostatus_set_err(job
, error
);
368 if (bs
->blk
&& bs
!= job
->bs
) {
369 blk_iostatus_set_err(bs
->blk
, error
);
378 AioContext
*aio_context
;
379 BlockJobDeferToMainLoopFn
*fn
;
381 } BlockJobDeferToMainLoopData
;
383 static void block_job_defer_to_main_loop_bh(void *opaque
)
385 BlockJobDeferToMainLoopData
*data
= opaque
;
386 AioContext
*aio_context
;
388 qemu_bh_delete(data
->bh
);
390 /* Prevent race with block_job_defer_to_main_loop() */
391 aio_context_acquire(data
->aio_context
);
393 /* Fetch BDS AioContext again, in case it has changed */
394 aio_context
= bdrv_get_aio_context(data
->job
->bs
);
395 aio_context_acquire(aio_context
);
397 data
->fn(data
->job
, data
->opaque
);
399 aio_context_release(aio_context
);
401 aio_context_release(data
->aio_context
);
406 void block_job_defer_to_main_loop(BlockJob
*job
,
407 BlockJobDeferToMainLoopFn
*fn
,
410 BlockJobDeferToMainLoopData
*data
= g_malloc(sizeof(*data
));
412 data
->bh
= qemu_bh_new(block_job_defer_to_main_loop_bh
, data
);
413 data
->aio_context
= bdrv_get_aio_context(job
->bs
);
415 data
->opaque
= opaque
;
417 qemu_bh_schedule(data
->bh
);