tests/vm: avoid image presence check and removal
[qemu/ar7.git] / block / rbd.c
blob59757b312022ed1008d34ae0808e9a090e423d8e
1 /*
2 * QEMU Block driver for RADOS (Ceph)
4 * Copyright (C) 2010-2011 Christian Brunner <chb@muc.de>,
5 * Josh Durgin <josh.durgin@dreamhost.com>
7 * This work is licensed under the terms of the GNU GPL, version 2. See
8 * the COPYING file in the top-level directory.
10 * Contributions after 2012-01-13 are licensed under the terms of the
11 * GNU GPL, version 2 or (at your option) any later version.
14 #include "qemu/osdep.h"
16 #include <rbd/librbd.h>
17 #include "qapi/error.h"
18 #include "qemu/error-report.h"
19 #include "qemu/module.h"
20 #include "qemu/option.h"
21 #include "block/block_int.h"
22 #include "block/qdict.h"
23 #include "crypto/secret.h"
24 #include "qemu/cutils.h"
25 #include "qapi/qmp/qstring.h"
26 #include "qapi/qmp/qdict.h"
27 #include "qapi/qmp/qjson.h"
28 #include "qapi/qmp/qlist.h"
29 #include "qapi/qobject-input-visitor.h"
30 #include "qapi/qapi-visit-block-core.h"
33 * When specifying the image filename use:
35 * rbd:poolname/devicename[@snapshotname][:option1=value1[:option2=value2...]]
37 * poolname must be the name of an existing rados pool.
39 * devicename is the name of the rbd image.
41 * Each option given is used to configure rados, and may be any valid
42 * Ceph option, "id", or "conf".
44 * The "id" option indicates what user we should authenticate as to
45 * the Ceph cluster. If it is excluded we will use the Ceph default
46 * (normally 'admin').
48 * The "conf" option specifies a Ceph configuration file to read. If
49 * it is not specified, we will read from the default Ceph locations
50 * (e.g., /etc/ceph/ceph.conf). To avoid reading _any_ configuration
51 * file, specify conf=/dev/null.
53 * Configuration values containing :, @, or = can be escaped with a
54 * leading "\".
57 /* rbd_aio_discard added in 0.1.2 */
58 #if LIBRBD_VERSION_CODE >= LIBRBD_VERSION(0, 1, 2)
59 #define LIBRBD_SUPPORTS_DISCARD
60 #else
61 #undef LIBRBD_SUPPORTS_DISCARD
62 #endif
64 #define OBJ_MAX_SIZE (1UL << OBJ_DEFAULT_OBJ_ORDER)
66 #define RBD_MAX_SNAPS 100
68 /* The LIBRBD_SUPPORTS_IOVEC is defined in librbd.h */
69 #ifdef LIBRBD_SUPPORTS_IOVEC
70 #define LIBRBD_USE_IOVEC 1
71 #else
72 #define LIBRBD_USE_IOVEC 0
73 #endif
75 typedef enum {
76 RBD_AIO_READ,
77 RBD_AIO_WRITE,
78 RBD_AIO_DISCARD,
79 RBD_AIO_FLUSH
80 } RBDAIOCmd;
82 typedef struct RBDAIOCB {
83 BlockAIOCB common;
84 int64_t ret;
85 QEMUIOVector *qiov;
86 char *bounce;
87 RBDAIOCmd cmd;
88 int error;
89 struct BDRVRBDState *s;
90 } RBDAIOCB;
92 typedef struct RADOSCB {
93 RBDAIOCB *acb;
94 struct BDRVRBDState *s;
95 int64_t size;
96 char *buf;
97 int64_t ret;
98 } RADOSCB;
100 typedef struct BDRVRBDState {
101 rados_t cluster;
102 rados_ioctx_t io_ctx;
103 rbd_image_t image;
104 char *image_name;
105 char *snap;
106 uint64_t image_size;
107 } BDRVRBDState;
109 static int qemu_rbd_connect(rados_t *cluster, rados_ioctx_t *io_ctx,
110 BlockdevOptionsRbd *opts, bool cache,
111 const char *keypairs, const char *secretid,
112 Error **errp);
114 static char *qemu_rbd_next_tok(char *src, char delim, char **p)
116 char *end;
118 *p = NULL;
120 for (end = src; *end; ++end) {
121 if (*end == delim) {
122 break;
124 if (*end == '\\' && end[1] != '\0') {
125 end++;
128 if (*end == delim) {
129 *p = end + 1;
130 *end = '\0';
132 return src;
135 static void qemu_rbd_unescape(char *src)
137 char *p;
139 for (p = src; *src; ++src, ++p) {
140 if (*src == '\\' && src[1] != '\0') {
141 src++;
143 *p = *src;
145 *p = '\0';
148 static void qemu_rbd_parse_filename(const char *filename, QDict *options,
149 Error **errp)
151 const char *start;
152 char *p, *buf;
153 QList *keypairs = NULL;
154 char *found_str;
156 if (!strstart(filename, "rbd:", &start)) {
157 error_setg(errp, "File name must start with 'rbd:'");
158 return;
161 buf = g_strdup(start);
162 p = buf;
164 found_str = qemu_rbd_next_tok(p, '/', &p);
165 if (!p) {
166 error_setg(errp, "Pool name is required");
167 goto done;
169 qemu_rbd_unescape(found_str);
170 qdict_put_str(options, "pool", found_str);
172 if (strchr(p, '@')) {
173 found_str = qemu_rbd_next_tok(p, '@', &p);
174 qemu_rbd_unescape(found_str);
175 qdict_put_str(options, "image", found_str);
177 found_str = qemu_rbd_next_tok(p, ':', &p);
178 qemu_rbd_unescape(found_str);
179 qdict_put_str(options, "snapshot", found_str);
180 } else {
181 found_str = qemu_rbd_next_tok(p, ':', &p);
182 qemu_rbd_unescape(found_str);
183 qdict_put_str(options, "image", found_str);
185 if (!p) {
186 goto done;
189 /* The following are essentially all key/value pairs, and we treat
190 * 'id' and 'conf' a bit special. Key/value pairs may be in any order. */
191 while (p) {
192 char *name, *value;
193 name = qemu_rbd_next_tok(p, '=', &p);
194 if (!p) {
195 error_setg(errp, "conf option %s has no value", name);
196 break;
199 qemu_rbd_unescape(name);
201 value = qemu_rbd_next_tok(p, ':', &p);
202 qemu_rbd_unescape(value);
204 if (!strcmp(name, "conf")) {
205 qdict_put_str(options, "conf", value);
206 } else if (!strcmp(name, "id")) {
207 qdict_put_str(options, "user", value);
208 } else {
210 * We pass these internally to qemu_rbd_set_keypairs(), so
211 * we can get away with the simpler list of [ "key1",
212 * "value1", "key2", "value2" ] rather than a raw dict
213 * { "key1": "value1", "key2": "value2" } where we can't
214 * guarantee order, or even a more correct but complex
215 * [ { "key1": "value1" }, { "key2": "value2" } ]
217 if (!keypairs) {
218 keypairs = qlist_new();
220 qlist_append_str(keypairs, name);
221 qlist_append_str(keypairs, value);
225 if (keypairs) {
226 qdict_put(options, "=keyvalue-pairs",
227 qobject_to_json(QOBJECT(keypairs)));
230 done:
231 g_free(buf);
232 qobject_unref(keypairs);
233 return;
237 static void qemu_rbd_refresh_limits(BlockDriverState *bs, Error **errp)
239 /* XXX Does RBD support AIO on less than 512-byte alignment? */
240 bs->bl.request_alignment = 512;
244 static int qemu_rbd_set_auth(rados_t cluster, BlockdevOptionsRbd *opts,
245 Error **errp)
247 char *key, *acr;
248 int r;
249 GString *accu;
250 RbdAuthModeList *auth;
252 if (opts->key_secret) {
253 key = qcrypto_secret_lookup_as_base64(opts->key_secret, errp);
254 if (!key) {
255 return -EIO;
257 r = rados_conf_set(cluster, "key", key);
258 g_free(key);
259 if (r < 0) {
260 error_setg_errno(errp, -r, "Could not set 'key'");
261 return r;
265 if (opts->has_auth_client_required) {
266 accu = g_string_new("");
267 for (auth = opts->auth_client_required; auth; auth = auth->next) {
268 if (accu->str[0]) {
269 g_string_append_c(accu, ';');
271 g_string_append(accu, RbdAuthMode_str(auth->value));
273 acr = g_string_free(accu, FALSE);
274 r = rados_conf_set(cluster, "auth_client_required", acr);
275 g_free(acr);
276 if (r < 0) {
277 error_setg_errno(errp, -r,
278 "Could not set 'auth_client_required'");
279 return r;
283 return 0;
286 static int qemu_rbd_set_keypairs(rados_t cluster, const char *keypairs_json,
287 Error **errp)
289 QList *keypairs;
290 QString *name;
291 QString *value;
292 const char *key;
293 size_t remaining;
294 int ret = 0;
296 if (!keypairs_json) {
297 return ret;
299 keypairs = qobject_to(QList,
300 qobject_from_json(keypairs_json, &error_abort));
301 remaining = qlist_size(keypairs) / 2;
302 assert(remaining);
304 while (remaining--) {
305 name = qobject_to(QString, qlist_pop(keypairs));
306 value = qobject_to(QString, qlist_pop(keypairs));
307 assert(name && value);
308 key = qstring_get_str(name);
310 ret = rados_conf_set(cluster, key, qstring_get_str(value));
311 qobject_unref(value);
312 if (ret < 0) {
313 error_setg_errno(errp, -ret, "invalid conf option %s", key);
314 qobject_unref(name);
315 ret = -EINVAL;
316 break;
318 qobject_unref(name);
321 qobject_unref(keypairs);
322 return ret;
325 static void qemu_rbd_memset(RADOSCB *rcb, int64_t offs)
327 if (LIBRBD_USE_IOVEC) {
328 RBDAIOCB *acb = rcb->acb;
329 iov_memset(acb->qiov->iov, acb->qiov->niov, offs, 0,
330 acb->qiov->size - offs);
331 } else {
332 memset(rcb->buf + offs, 0, rcb->size - offs);
336 static QemuOptsList runtime_opts = {
337 .name = "rbd",
338 .head = QTAILQ_HEAD_INITIALIZER(runtime_opts.head),
339 .desc = {
341 .name = "pool",
342 .type = QEMU_OPT_STRING,
343 .help = "Rados pool name",
346 .name = "image",
347 .type = QEMU_OPT_STRING,
348 .help = "Image name in the pool",
351 .name = "conf",
352 .type = QEMU_OPT_STRING,
353 .help = "Rados config file location",
356 .name = "snapshot",
357 .type = QEMU_OPT_STRING,
358 .help = "Ceph snapshot name",
361 /* maps to 'id' in rados_create() */
362 .name = "user",
363 .type = QEMU_OPT_STRING,
364 .help = "Rados id name",
367 * server.* extracted manually, see qemu_rbd_mon_host()
369 { /* end of list */ }
373 /* FIXME Deprecate and remove keypairs or make it available in QMP. */
374 static int qemu_rbd_do_create(BlockdevCreateOptions *options,
375 const char *keypairs, const char *password_secret,
376 Error **errp)
378 BlockdevCreateOptionsRbd *opts = &options->u.rbd;
379 rados_t cluster;
380 rados_ioctx_t io_ctx;
381 int obj_order = 0;
382 int ret;
384 assert(options->driver == BLOCKDEV_DRIVER_RBD);
385 if (opts->location->has_snapshot) {
386 error_setg(errp, "Can't use snapshot name for image creation");
387 return -EINVAL;
390 if (opts->has_cluster_size) {
391 int64_t objsize = opts->cluster_size;
392 if ((objsize - 1) & objsize) { /* not a power of 2? */
393 error_setg(errp, "obj size needs to be power of 2");
394 return -EINVAL;
396 if (objsize < 4096) {
397 error_setg(errp, "obj size too small");
398 return -EINVAL;
400 obj_order = ctz32(objsize);
403 ret = qemu_rbd_connect(&cluster, &io_ctx, opts->location, false, keypairs,
404 password_secret, errp);
405 if (ret < 0) {
406 return ret;
409 ret = rbd_create(io_ctx, opts->location->image, opts->size, &obj_order);
410 if (ret < 0) {
411 error_setg_errno(errp, -ret, "error rbd create");
412 goto out;
415 ret = 0;
416 out:
417 rados_ioctx_destroy(io_ctx);
418 rados_shutdown(cluster);
419 return ret;
422 static int qemu_rbd_co_create(BlockdevCreateOptions *options, Error **errp)
424 return qemu_rbd_do_create(options, NULL, NULL, errp);
427 static int coroutine_fn qemu_rbd_co_create_opts(const char *filename,
428 QemuOpts *opts,
429 Error **errp)
431 BlockdevCreateOptions *create_options;
432 BlockdevCreateOptionsRbd *rbd_opts;
433 BlockdevOptionsRbd *loc;
434 Error *local_err = NULL;
435 const char *keypairs, *password_secret;
436 QDict *options = NULL;
437 int ret = 0;
439 create_options = g_new0(BlockdevCreateOptions, 1);
440 create_options->driver = BLOCKDEV_DRIVER_RBD;
441 rbd_opts = &create_options->u.rbd;
443 rbd_opts->location = g_new0(BlockdevOptionsRbd, 1);
445 password_secret = qemu_opt_get(opts, "password-secret");
447 /* Read out options */
448 rbd_opts->size = ROUND_UP(qemu_opt_get_size_del(opts, BLOCK_OPT_SIZE, 0),
449 BDRV_SECTOR_SIZE);
450 rbd_opts->cluster_size = qemu_opt_get_size_del(opts,
451 BLOCK_OPT_CLUSTER_SIZE, 0);
452 rbd_opts->has_cluster_size = (rbd_opts->cluster_size != 0);
454 options = qdict_new();
455 qemu_rbd_parse_filename(filename, options, &local_err);
456 if (local_err) {
457 ret = -EINVAL;
458 error_propagate(errp, local_err);
459 goto exit;
463 * Caution: while qdict_get_try_str() is fine, getting non-string
464 * types would require more care. When @options come from -blockdev
465 * or blockdev_add, its members are typed according to the QAPI
466 * schema, but when they come from -drive, they're all QString.
468 loc = rbd_opts->location;
469 loc->pool = g_strdup(qdict_get_try_str(options, "pool"));
470 loc->conf = g_strdup(qdict_get_try_str(options, "conf"));
471 loc->has_conf = !!loc->conf;
472 loc->user = g_strdup(qdict_get_try_str(options, "user"));
473 loc->has_user = !!loc->user;
474 loc->image = g_strdup(qdict_get_try_str(options, "image"));
475 keypairs = qdict_get_try_str(options, "=keyvalue-pairs");
477 ret = qemu_rbd_do_create(create_options, keypairs, password_secret, errp);
478 if (ret < 0) {
479 goto exit;
482 exit:
483 qobject_unref(options);
484 qapi_free_BlockdevCreateOptions(create_options);
485 return ret;
489 * This aio completion is being called from rbd_finish_bh() and runs in qemu
490 * BH context.
492 static void qemu_rbd_complete_aio(RADOSCB *rcb)
494 RBDAIOCB *acb = rcb->acb;
495 int64_t r;
497 r = rcb->ret;
499 if (acb->cmd != RBD_AIO_READ) {
500 if (r < 0) {
501 acb->ret = r;
502 acb->error = 1;
503 } else if (!acb->error) {
504 acb->ret = rcb->size;
506 } else {
507 if (r < 0) {
508 qemu_rbd_memset(rcb, 0);
509 acb->ret = r;
510 acb->error = 1;
511 } else if (r < rcb->size) {
512 qemu_rbd_memset(rcb, r);
513 if (!acb->error) {
514 acb->ret = rcb->size;
516 } else if (!acb->error) {
517 acb->ret = r;
521 g_free(rcb);
523 if (!LIBRBD_USE_IOVEC) {
524 if (acb->cmd == RBD_AIO_READ) {
525 qemu_iovec_from_buf(acb->qiov, 0, acb->bounce, acb->qiov->size);
527 qemu_vfree(acb->bounce);
530 acb->common.cb(acb->common.opaque, (acb->ret > 0 ? 0 : acb->ret));
532 qemu_aio_unref(acb);
535 static char *qemu_rbd_mon_host(BlockdevOptionsRbd *opts, Error **errp)
537 const char **vals;
538 const char *host, *port;
539 char *rados_str;
540 InetSocketAddressBaseList *p;
541 int i, cnt;
543 if (!opts->has_server) {
544 return NULL;
547 for (cnt = 0, p = opts->server; p; p = p->next) {
548 cnt++;
551 vals = g_new(const char *, cnt + 1);
553 for (i = 0, p = opts->server; p; p = p->next, i++) {
554 host = p->value->host;
555 port = p->value->port;
557 if (strchr(host, ':')) {
558 vals[i] = g_strdup_printf("[%s]:%s", host, port);
559 } else {
560 vals[i] = g_strdup_printf("%s:%s", host, port);
563 vals[i] = NULL;
565 rados_str = i ? g_strjoinv(";", (char **)vals) : NULL;
566 g_strfreev((char **)vals);
567 return rados_str;
570 static int qemu_rbd_connect(rados_t *cluster, rados_ioctx_t *io_ctx,
571 BlockdevOptionsRbd *opts, bool cache,
572 const char *keypairs, const char *secretid,
573 Error **errp)
575 char *mon_host = NULL;
576 Error *local_err = NULL;
577 int r;
579 if (secretid) {
580 if (opts->key_secret) {
581 error_setg(errp,
582 "Legacy 'password-secret' clashes with 'key-secret'");
583 return -EINVAL;
585 opts->key_secret = g_strdup(secretid);
586 opts->has_key_secret = true;
589 mon_host = qemu_rbd_mon_host(opts, &local_err);
590 if (local_err) {
591 error_propagate(errp, local_err);
592 r = -EINVAL;
593 goto failed_opts;
596 r = rados_create(cluster, opts->user);
597 if (r < 0) {
598 error_setg_errno(errp, -r, "error initializing");
599 goto failed_opts;
602 /* try default location when conf=NULL, but ignore failure */
603 r = rados_conf_read_file(*cluster, opts->conf);
604 if (opts->has_conf && r < 0) {
605 error_setg_errno(errp, -r, "error reading conf file %s", opts->conf);
606 goto failed_shutdown;
609 r = qemu_rbd_set_keypairs(*cluster, keypairs, errp);
610 if (r < 0) {
611 goto failed_shutdown;
614 if (mon_host) {
615 r = rados_conf_set(*cluster, "mon_host", mon_host);
616 if (r < 0) {
617 goto failed_shutdown;
621 r = qemu_rbd_set_auth(*cluster, opts, errp);
622 if (r < 0) {
623 goto failed_shutdown;
627 * Fallback to more conservative semantics if setting cache
628 * options fails. Ignore errors from setting rbd_cache because the
629 * only possible error is that the option does not exist, and
630 * librbd defaults to no caching. If write through caching cannot
631 * be set up, fall back to no caching.
633 if (cache) {
634 rados_conf_set(*cluster, "rbd_cache", "true");
635 } else {
636 rados_conf_set(*cluster, "rbd_cache", "false");
639 r = rados_connect(*cluster);
640 if (r < 0) {
641 error_setg_errno(errp, -r, "error connecting");
642 goto failed_shutdown;
645 r = rados_ioctx_create(*cluster, opts->pool, io_ctx);
646 if (r < 0) {
647 error_setg_errno(errp, -r, "error opening pool %s", opts->pool);
648 goto failed_shutdown;
651 return 0;
653 failed_shutdown:
654 rados_shutdown(*cluster);
655 failed_opts:
656 g_free(mon_host);
657 return r;
660 static int qemu_rbd_convert_options(QDict *options, BlockdevOptionsRbd **opts,
661 Error **errp)
663 Visitor *v;
664 Error *local_err = NULL;
666 /* Convert the remaining options into a QAPI object */
667 v = qobject_input_visitor_new_flat_confused(options, errp);
668 if (!v) {
669 return -EINVAL;
672 visit_type_BlockdevOptionsRbd(v, NULL, opts, &local_err);
673 visit_free(v);
675 if (local_err) {
676 error_propagate(errp, local_err);
677 return -EINVAL;
680 return 0;
683 static int qemu_rbd_attempt_legacy_options(QDict *options,
684 BlockdevOptionsRbd **opts,
685 char **keypairs)
687 char *filename;
688 int r;
690 filename = g_strdup(qdict_get_try_str(options, "filename"));
691 if (!filename) {
692 return -EINVAL;
694 qdict_del(options, "filename");
696 qemu_rbd_parse_filename(filename, options, NULL);
698 /* keypairs freed by caller */
699 *keypairs = g_strdup(qdict_get_try_str(options, "=keyvalue-pairs"));
700 if (*keypairs) {
701 qdict_del(options, "=keyvalue-pairs");
704 r = qemu_rbd_convert_options(options, opts, NULL);
706 g_free(filename);
707 return r;
710 static int qemu_rbd_open(BlockDriverState *bs, QDict *options, int flags,
711 Error **errp)
713 BDRVRBDState *s = bs->opaque;
714 BlockdevOptionsRbd *opts = NULL;
715 const QDictEntry *e;
716 Error *local_err = NULL;
717 char *keypairs, *secretid;
718 int r;
720 keypairs = g_strdup(qdict_get_try_str(options, "=keyvalue-pairs"));
721 if (keypairs) {
722 qdict_del(options, "=keyvalue-pairs");
725 secretid = g_strdup(qdict_get_try_str(options, "password-secret"));
726 if (secretid) {
727 qdict_del(options, "password-secret");
730 r = qemu_rbd_convert_options(options, &opts, &local_err);
731 if (local_err) {
732 /* If keypairs are present, that means some options are present in
733 * the modern option format. Don't attempt to parse legacy option
734 * formats, as we won't support mixed usage. */
735 if (keypairs) {
736 error_propagate(errp, local_err);
737 goto out;
740 /* If the initial attempt to convert and process the options failed,
741 * we may be attempting to open an image file that has the rbd options
742 * specified in the older format consisting of all key/value pairs
743 * encoded in the filename. Go ahead and attempt to parse the
744 * filename, and see if we can pull out the required options. */
745 r = qemu_rbd_attempt_legacy_options(options, &opts, &keypairs);
746 if (r < 0) {
747 /* Propagate the original error, not the legacy parsing fallback
748 * error, as the latter was just a best-effort attempt. */
749 error_propagate(errp, local_err);
750 goto out;
752 /* Take care whenever deciding to actually deprecate; once this ability
753 * is removed, we will not be able to open any images with legacy-styled
754 * backing image strings. */
755 warn_report("RBD options encoded in the filename as keyvalue pairs "
756 "is deprecated");
759 /* Remove the processed options from the QDict (the visitor processes
760 * _all_ options in the QDict) */
761 while ((e = qdict_first(options))) {
762 qdict_del(options, e->key);
765 r = qemu_rbd_connect(&s->cluster, &s->io_ctx, opts,
766 !(flags & BDRV_O_NOCACHE), keypairs, secretid, errp);
767 if (r < 0) {
768 goto out;
771 s->snap = g_strdup(opts->snapshot);
772 s->image_name = g_strdup(opts->image);
774 /* rbd_open is always r/w */
775 r = rbd_open(s->io_ctx, s->image_name, &s->image, s->snap);
776 if (r < 0) {
777 error_setg_errno(errp, -r, "error reading header from %s",
778 s->image_name);
779 goto failed_open;
782 r = rbd_get_size(s->image, &s->image_size);
783 if (r < 0) {
784 error_setg_errno(errp, -r, "error getting image size from %s",
785 s->image_name);
786 rbd_close(s->image);
787 goto failed_open;
790 /* If we are using an rbd snapshot, we must be r/o, otherwise
791 * leave as-is */
792 if (s->snap != NULL) {
793 r = bdrv_apply_auto_read_only(bs, "rbd snapshots are read-only", errp);
794 if (r < 0) {
795 rbd_close(s->image);
796 goto failed_open;
800 r = 0;
801 goto out;
803 failed_open:
804 rados_ioctx_destroy(s->io_ctx);
805 g_free(s->snap);
806 g_free(s->image_name);
807 rados_shutdown(s->cluster);
808 out:
809 qapi_free_BlockdevOptionsRbd(opts);
810 g_free(keypairs);
811 g_free(secretid);
812 return r;
816 /* Since RBD is currently always opened R/W via the API,
817 * we just need to check if we are using a snapshot or not, in
818 * order to determine if we will allow it to be R/W */
819 static int qemu_rbd_reopen_prepare(BDRVReopenState *state,
820 BlockReopenQueue *queue, Error **errp)
822 BDRVRBDState *s = state->bs->opaque;
823 int ret = 0;
825 if (s->snap && state->flags & BDRV_O_RDWR) {
826 error_setg(errp,
827 "Cannot change node '%s' to r/w when using RBD snapshot",
828 bdrv_get_device_or_node_name(state->bs));
829 ret = -EINVAL;
832 return ret;
835 static void qemu_rbd_close(BlockDriverState *bs)
837 BDRVRBDState *s = bs->opaque;
839 rbd_close(s->image);
840 rados_ioctx_destroy(s->io_ctx);
841 g_free(s->snap);
842 g_free(s->image_name);
843 rados_shutdown(s->cluster);
846 /* Resize the RBD image and update the 'image_size' with the current size */
847 static int qemu_rbd_resize(BlockDriverState *bs, uint64_t size)
849 BDRVRBDState *s = bs->opaque;
850 int r;
852 r = rbd_resize(s->image, size);
853 if (r < 0) {
854 return r;
857 s->image_size = size;
859 return 0;
862 static const AIOCBInfo rbd_aiocb_info = {
863 .aiocb_size = sizeof(RBDAIOCB),
866 static void rbd_finish_bh(void *opaque)
868 RADOSCB *rcb = opaque;
869 qemu_rbd_complete_aio(rcb);
873 * This is the callback function for rbd_aio_read and _write
875 * Note: this function is being called from a non qemu thread so
876 * we need to be careful about what we do here. Generally we only
877 * schedule a BH, and do the rest of the io completion handling
878 * from rbd_finish_bh() which runs in a qemu context.
880 static void rbd_finish_aiocb(rbd_completion_t c, RADOSCB *rcb)
882 RBDAIOCB *acb = rcb->acb;
884 rcb->ret = rbd_aio_get_return_value(c);
885 rbd_aio_release(c);
887 aio_bh_schedule_oneshot(bdrv_get_aio_context(acb->common.bs),
888 rbd_finish_bh, rcb);
891 static int rbd_aio_discard_wrapper(rbd_image_t image,
892 uint64_t off,
893 uint64_t len,
894 rbd_completion_t comp)
896 #ifdef LIBRBD_SUPPORTS_DISCARD
897 return rbd_aio_discard(image, off, len, comp);
898 #else
899 return -ENOTSUP;
900 #endif
903 static int rbd_aio_flush_wrapper(rbd_image_t image,
904 rbd_completion_t comp)
906 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH
907 return rbd_aio_flush(image, comp);
908 #else
909 return -ENOTSUP;
910 #endif
913 static BlockAIOCB *rbd_start_aio(BlockDriverState *bs,
914 int64_t off,
915 QEMUIOVector *qiov,
916 int64_t size,
917 BlockCompletionFunc *cb,
918 void *opaque,
919 RBDAIOCmd cmd)
921 RBDAIOCB *acb;
922 RADOSCB *rcb = NULL;
923 rbd_completion_t c;
924 int r;
926 BDRVRBDState *s = bs->opaque;
928 acb = qemu_aio_get(&rbd_aiocb_info, bs, cb, opaque);
929 acb->cmd = cmd;
930 acb->qiov = qiov;
931 assert(!qiov || qiov->size == size);
933 rcb = g_new(RADOSCB, 1);
935 if (!LIBRBD_USE_IOVEC) {
936 if (cmd == RBD_AIO_DISCARD || cmd == RBD_AIO_FLUSH) {
937 acb->bounce = NULL;
938 } else {
939 acb->bounce = qemu_try_blockalign(bs, qiov->size);
940 if (acb->bounce == NULL) {
941 goto failed;
944 if (cmd == RBD_AIO_WRITE) {
945 qemu_iovec_to_buf(acb->qiov, 0, acb->bounce, qiov->size);
947 rcb->buf = acb->bounce;
950 acb->ret = 0;
951 acb->error = 0;
952 acb->s = s;
954 rcb->acb = acb;
955 rcb->s = acb->s;
956 rcb->size = size;
957 r = rbd_aio_create_completion(rcb, (rbd_callback_t) rbd_finish_aiocb, &c);
958 if (r < 0) {
959 goto failed;
962 switch (cmd) {
963 case RBD_AIO_WRITE: {
965 * RBD APIs don't allow us to write more than actual size, so in order
966 * to support growing images, we resize the image before write
967 * operations that exceed the current size.
969 if (off + size > s->image_size) {
970 r = qemu_rbd_resize(bs, off + size);
971 if (r < 0) {
972 goto failed_completion;
975 #ifdef LIBRBD_SUPPORTS_IOVEC
976 r = rbd_aio_writev(s->image, qiov->iov, qiov->niov, off, c);
977 #else
978 r = rbd_aio_write(s->image, off, size, rcb->buf, c);
979 #endif
980 break;
982 case RBD_AIO_READ:
983 #ifdef LIBRBD_SUPPORTS_IOVEC
984 r = rbd_aio_readv(s->image, qiov->iov, qiov->niov, off, c);
985 #else
986 r = rbd_aio_read(s->image, off, size, rcb->buf, c);
987 #endif
988 break;
989 case RBD_AIO_DISCARD:
990 r = rbd_aio_discard_wrapper(s->image, off, size, c);
991 break;
992 case RBD_AIO_FLUSH:
993 r = rbd_aio_flush_wrapper(s->image, c);
994 break;
995 default:
996 r = -EINVAL;
999 if (r < 0) {
1000 goto failed_completion;
1002 return &acb->common;
1004 failed_completion:
1005 rbd_aio_release(c);
1006 failed:
1007 g_free(rcb);
1008 if (!LIBRBD_USE_IOVEC) {
1009 qemu_vfree(acb->bounce);
1012 qemu_aio_unref(acb);
1013 return NULL;
1016 static BlockAIOCB *qemu_rbd_aio_preadv(BlockDriverState *bs,
1017 uint64_t offset, uint64_t bytes,
1018 QEMUIOVector *qiov, int flags,
1019 BlockCompletionFunc *cb,
1020 void *opaque)
1022 return rbd_start_aio(bs, offset, qiov, bytes, cb, opaque,
1023 RBD_AIO_READ);
1026 static BlockAIOCB *qemu_rbd_aio_pwritev(BlockDriverState *bs,
1027 uint64_t offset, uint64_t bytes,
1028 QEMUIOVector *qiov, int flags,
1029 BlockCompletionFunc *cb,
1030 void *opaque)
1032 return rbd_start_aio(bs, offset, qiov, bytes, cb, opaque,
1033 RBD_AIO_WRITE);
1036 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH
1037 static BlockAIOCB *qemu_rbd_aio_flush(BlockDriverState *bs,
1038 BlockCompletionFunc *cb,
1039 void *opaque)
1041 return rbd_start_aio(bs, 0, NULL, 0, cb, opaque, RBD_AIO_FLUSH);
1044 #else
1046 static int qemu_rbd_co_flush(BlockDriverState *bs)
1048 #if LIBRBD_VERSION_CODE >= LIBRBD_VERSION(0, 1, 1)
1049 /* rbd_flush added in 0.1.1 */
1050 BDRVRBDState *s = bs->opaque;
1051 return rbd_flush(s->image);
1052 #else
1053 return 0;
1054 #endif
1056 #endif
1058 static int qemu_rbd_getinfo(BlockDriverState *bs, BlockDriverInfo *bdi)
1060 BDRVRBDState *s = bs->opaque;
1061 rbd_image_info_t info;
1062 int r;
1064 r = rbd_stat(s->image, &info, sizeof(info));
1065 if (r < 0) {
1066 return r;
1069 bdi->cluster_size = info.obj_size;
1070 return 0;
1073 static int64_t qemu_rbd_getlength(BlockDriverState *bs)
1075 BDRVRBDState *s = bs->opaque;
1076 rbd_image_info_t info;
1077 int r;
1079 r = rbd_stat(s->image, &info, sizeof(info));
1080 if (r < 0) {
1081 return r;
1084 return info.size;
1087 static int coroutine_fn qemu_rbd_co_truncate(BlockDriverState *bs,
1088 int64_t offset,
1089 PreallocMode prealloc,
1090 Error **errp)
1092 int r;
1094 if (prealloc != PREALLOC_MODE_OFF) {
1095 error_setg(errp, "Unsupported preallocation mode '%s'",
1096 PreallocMode_str(prealloc));
1097 return -ENOTSUP;
1100 r = qemu_rbd_resize(bs, offset);
1101 if (r < 0) {
1102 error_setg_errno(errp, -r, "Failed to resize file");
1103 return r;
1106 return 0;
1109 static int qemu_rbd_snap_create(BlockDriverState *bs,
1110 QEMUSnapshotInfo *sn_info)
1112 BDRVRBDState *s = bs->opaque;
1113 int r;
1115 if (sn_info->name[0] == '\0') {
1116 return -EINVAL; /* we need a name for rbd snapshots */
1120 * rbd snapshots are using the name as the user controlled unique identifier
1121 * we can't use the rbd snapid for that purpose, as it can't be set
1123 if (sn_info->id_str[0] != '\0' &&
1124 strcmp(sn_info->id_str, sn_info->name) != 0) {
1125 return -EINVAL;
1128 if (strlen(sn_info->name) >= sizeof(sn_info->id_str)) {
1129 return -ERANGE;
1132 r = rbd_snap_create(s->image, sn_info->name);
1133 if (r < 0) {
1134 error_report("failed to create snap: %s", strerror(-r));
1135 return r;
1138 return 0;
1141 static int qemu_rbd_snap_remove(BlockDriverState *bs,
1142 const char *snapshot_id,
1143 const char *snapshot_name,
1144 Error **errp)
1146 BDRVRBDState *s = bs->opaque;
1147 int r;
1149 if (!snapshot_name) {
1150 error_setg(errp, "rbd need a valid snapshot name");
1151 return -EINVAL;
1154 /* If snapshot_id is specified, it must be equal to name, see
1155 qemu_rbd_snap_list() */
1156 if (snapshot_id && strcmp(snapshot_id, snapshot_name)) {
1157 error_setg(errp,
1158 "rbd do not support snapshot id, it should be NULL or "
1159 "equal to snapshot name");
1160 return -EINVAL;
1163 r = rbd_snap_remove(s->image, snapshot_name);
1164 if (r < 0) {
1165 error_setg_errno(errp, -r, "Failed to remove the snapshot");
1167 return r;
1170 static int qemu_rbd_snap_rollback(BlockDriverState *bs,
1171 const char *snapshot_name)
1173 BDRVRBDState *s = bs->opaque;
1175 return rbd_snap_rollback(s->image, snapshot_name);
1178 static int qemu_rbd_snap_list(BlockDriverState *bs,
1179 QEMUSnapshotInfo **psn_tab)
1181 BDRVRBDState *s = bs->opaque;
1182 QEMUSnapshotInfo *sn_info, *sn_tab = NULL;
1183 int i, snap_count;
1184 rbd_snap_info_t *snaps;
1185 int max_snaps = RBD_MAX_SNAPS;
1187 do {
1188 snaps = g_new(rbd_snap_info_t, max_snaps);
1189 snap_count = rbd_snap_list(s->image, snaps, &max_snaps);
1190 if (snap_count <= 0) {
1191 g_free(snaps);
1193 } while (snap_count == -ERANGE);
1195 if (snap_count <= 0) {
1196 goto done;
1199 sn_tab = g_new0(QEMUSnapshotInfo, snap_count);
1201 for (i = 0; i < snap_count; i++) {
1202 const char *snap_name = snaps[i].name;
1204 sn_info = sn_tab + i;
1205 pstrcpy(sn_info->id_str, sizeof(sn_info->id_str), snap_name);
1206 pstrcpy(sn_info->name, sizeof(sn_info->name), snap_name);
1208 sn_info->vm_state_size = snaps[i].size;
1209 sn_info->date_sec = 0;
1210 sn_info->date_nsec = 0;
1211 sn_info->vm_clock_nsec = 0;
1213 rbd_snap_list_end(snaps);
1214 g_free(snaps);
1216 done:
1217 *psn_tab = sn_tab;
1218 return snap_count;
1221 #ifdef LIBRBD_SUPPORTS_DISCARD
1222 static BlockAIOCB *qemu_rbd_aio_pdiscard(BlockDriverState *bs,
1223 int64_t offset,
1224 int bytes,
1225 BlockCompletionFunc *cb,
1226 void *opaque)
1228 return rbd_start_aio(bs, offset, NULL, bytes, cb, opaque,
1229 RBD_AIO_DISCARD);
1231 #endif
1233 #ifdef LIBRBD_SUPPORTS_INVALIDATE
1234 static void coroutine_fn qemu_rbd_co_invalidate_cache(BlockDriverState *bs,
1235 Error **errp)
1237 BDRVRBDState *s = bs->opaque;
1238 int r = rbd_invalidate_cache(s->image);
1239 if (r < 0) {
1240 error_setg_errno(errp, -r, "Failed to invalidate the cache");
1243 #endif
1245 static QemuOptsList qemu_rbd_create_opts = {
1246 .name = "rbd-create-opts",
1247 .head = QTAILQ_HEAD_INITIALIZER(qemu_rbd_create_opts.head),
1248 .desc = {
1250 .name = BLOCK_OPT_SIZE,
1251 .type = QEMU_OPT_SIZE,
1252 .help = "Virtual disk size"
1255 .name = BLOCK_OPT_CLUSTER_SIZE,
1256 .type = QEMU_OPT_SIZE,
1257 .help = "RBD object size"
1260 .name = "password-secret",
1261 .type = QEMU_OPT_STRING,
1262 .help = "ID of secret providing the password",
1264 { /* end of list */ }
1268 static const char *const qemu_rbd_strong_runtime_opts[] = {
1269 "pool",
1270 "image",
1271 "conf",
1272 "snapshot",
1273 "user",
1274 "server.",
1275 "password-secret",
1277 NULL
1280 static BlockDriver bdrv_rbd = {
1281 .format_name = "rbd",
1282 .instance_size = sizeof(BDRVRBDState),
1283 .bdrv_parse_filename = qemu_rbd_parse_filename,
1284 .bdrv_refresh_limits = qemu_rbd_refresh_limits,
1285 .bdrv_file_open = qemu_rbd_open,
1286 .bdrv_close = qemu_rbd_close,
1287 .bdrv_reopen_prepare = qemu_rbd_reopen_prepare,
1288 .bdrv_co_create = qemu_rbd_co_create,
1289 .bdrv_co_create_opts = qemu_rbd_co_create_opts,
1290 .bdrv_has_zero_init = bdrv_has_zero_init_1,
1291 .bdrv_get_info = qemu_rbd_getinfo,
1292 .create_opts = &qemu_rbd_create_opts,
1293 .bdrv_getlength = qemu_rbd_getlength,
1294 .bdrv_co_truncate = qemu_rbd_co_truncate,
1295 .protocol_name = "rbd",
1297 .bdrv_aio_preadv = qemu_rbd_aio_preadv,
1298 .bdrv_aio_pwritev = qemu_rbd_aio_pwritev,
1300 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH
1301 .bdrv_aio_flush = qemu_rbd_aio_flush,
1302 #else
1303 .bdrv_co_flush_to_disk = qemu_rbd_co_flush,
1304 #endif
1306 #ifdef LIBRBD_SUPPORTS_DISCARD
1307 .bdrv_aio_pdiscard = qemu_rbd_aio_pdiscard,
1308 #endif
1310 .bdrv_snapshot_create = qemu_rbd_snap_create,
1311 .bdrv_snapshot_delete = qemu_rbd_snap_remove,
1312 .bdrv_snapshot_list = qemu_rbd_snap_list,
1313 .bdrv_snapshot_goto = qemu_rbd_snap_rollback,
1314 #ifdef LIBRBD_SUPPORTS_INVALIDATE
1315 .bdrv_co_invalidate_cache = qemu_rbd_co_invalidate_cache,
1316 #endif
1318 .strong_runtime_opts = qemu_rbd_strong_runtime_opts,
1321 static void bdrv_rbd_init(void)
1323 bdrv_register(&bdrv_rbd);
1326 block_init(bdrv_rbd_init);