docs: convert README, CODING_STYLE and HACKING to RST syntax
[qemu/ar7.git] / block / create.c
blob1bd00ed5f8c93dfd315d637f8c6b74f001e533c2
1 /*
2 * Block layer code related to image creation
4 * Copyright (c) 2018 Kevin Wolf <kwolf@redhat.com>
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
25 #include "qemu/osdep.h"
26 #include "block/block_int.h"
27 #include "qemu/job.h"
28 #include "qemu/main-loop.h"
29 #include "qapi/qapi-commands-block-core.h"
30 #include "qapi/qapi-visit-block-core.h"
31 #include "qapi/clone-visitor.h"
32 #include "qapi/error.h"
34 typedef struct BlockdevCreateJob {
35 Job common;
36 BlockDriver *drv;
37 BlockdevCreateOptions *opts;
38 } BlockdevCreateJob;
40 static int coroutine_fn blockdev_create_run(Job *job, Error **errp)
42 BlockdevCreateJob *s = container_of(job, BlockdevCreateJob, common);
43 int ret;
45 job_progress_set_remaining(&s->common, 1);
46 ret = s->drv->bdrv_co_create(s->opts, errp);
47 job_progress_update(&s->common, 1);
49 qapi_free_BlockdevCreateOptions(s->opts);
51 return ret;
54 static const JobDriver blockdev_create_job_driver = {
55 .instance_size = sizeof(BlockdevCreateJob),
56 .job_type = JOB_TYPE_CREATE,
57 .run = blockdev_create_run,
60 void qmp_blockdev_create(const char *job_id, BlockdevCreateOptions *options,
61 Error **errp)
63 BlockdevCreateJob *s;
64 const char *fmt = BlockdevDriver_str(options->driver);
65 BlockDriver *drv = bdrv_find_format(fmt);
67 /* If the driver is in the schema, we know that it exists. But it may not
68 * be whitelisted. */
69 assert(drv);
70 if (bdrv_uses_whitelist() && !bdrv_is_whitelisted(drv, false)) {
71 error_setg(errp, "Driver is not whitelisted");
72 return;
75 /* Error out if the driver doesn't support .bdrv_co_create */
76 if (!drv->bdrv_co_create) {
77 error_setg(errp, "Driver does not support blockdev-create");
78 return;
81 /* Create the block job */
82 /* TODO Running in the main context. Block drivers need to error out or add
83 * locking when they use a BDS in a different AioContext. */
84 s = job_create(job_id, &blockdev_create_job_driver, NULL,
85 qemu_get_aio_context(), JOB_DEFAULT | JOB_MANUAL_DISMISS,
86 NULL, NULL, errp);
87 if (!s) {
88 return;
91 s->drv = drv,
92 s->opts = QAPI_CLONE(BlockdevCreateOptions, options),
94 job_start(&s->common);