1 /* 2 * QEMU Block driver for RADOS (Ceph) 3 * 4 * Copyright (C) 2010-2011 Christian Brunner <chb@muc.de>, 5 * Josh Durgin <josh.durgin@dreamhost.com> 6 * 7 * This work is licensed under the terms of the GNU GPL, version 2. See 8 * the COPYING file in the top-level directory. 9 * 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. 12 */ 13 14 #include "qemu/osdep.h" 15 16 #include <rbd/librbd.h> 17 #include "qapi/error.h" 18 #include "qemu/error-report.h" 19 #include "qemu/option.h" 20 #include "block/block_int.h" 21 #include "crypto/secret.h" 22 #include "qemu/cutils.h" 23 #include "qapi/qmp/qstring.h" 24 #include "qapi/qmp/qdict.h" 25 #include "qapi/qmp/qjson.h" 26 #include "qapi/qmp/qlist.h" 27 #include "qapi/qobject-input-visitor.h" 28 #include "qapi/qapi-visit-block-core.h" 29 30 /* 31 * When specifying the image filename use: 32 * 33 * rbd:poolname/devicename[@snapshotname][:option1=value1[:option2=value2...]] 34 * 35 * poolname must be the name of an existing rados pool. 36 * 37 * devicename is the name of the rbd image. 38 * 39 * Each option given is used to configure rados, and may be any valid 40 * Ceph option, "id", or "conf". 41 * 42 * The "id" option indicates what user we should authenticate as to 43 * the Ceph cluster. If it is excluded we will use the Ceph default 44 * (normally 'admin'). 45 * 46 * The "conf" option specifies a Ceph configuration file to read. If 47 * it is not specified, we will read from the default Ceph locations 48 * (e.g., /etc/ceph/ceph.conf). To avoid reading _any_ configuration 49 * file, specify conf=/dev/null. 50 * 51 * Configuration values containing :, @, or = can be escaped with a 52 * leading "\". 53 */ 54 55 /* rbd_aio_discard added in 0.1.2 */ 56 #if LIBRBD_VERSION_CODE >= LIBRBD_VERSION(0, 1, 2) 57 #define LIBRBD_SUPPORTS_DISCARD 58 #else 59 #undef LIBRBD_SUPPORTS_DISCARD 60 #endif 61 62 #define OBJ_MAX_SIZE (1UL << OBJ_DEFAULT_OBJ_ORDER) 63 64 #define RBD_MAX_SNAPS 100 65 66 /* The LIBRBD_SUPPORTS_IOVEC is defined in librbd.h */ 67 #ifdef LIBRBD_SUPPORTS_IOVEC 68 #define LIBRBD_USE_IOVEC 1 69 #else 70 #define LIBRBD_USE_IOVEC 0 71 #endif 72 73 typedef enum { 74 RBD_AIO_READ, 75 RBD_AIO_WRITE, 76 RBD_AIO_DISCARD, 77 RBD_AIO_FLUSH 78 } RBDAIOCmd; 79 80 typedef struct RBDAIOCB { 81 BlockAIOCB common; 82 int64_t ret; 83 QEMUIOVector *qiov; 84 char *bounce; 85 RBDAIOCmd cmd; 86 int error; 87 struct BDRVRBDState *s; 88 } RBDAIOCB; 89 90 typedef struct RADOSCB { 91 RBDAIOCB *acb; 92 struct BDRVRBDState *s; 93 int64_t size; 94 char *buf; 95 int64_t ret; 96 } RADOSCB; 97 98 typedef struct BDRVRBDState { 99 rados_t cluster; 100 rados_ioctx_t io_ctx; 101 rbd_image_t image; 102 char *image_name; 103 char *snap; 104 } BDRVRBDState; 105 106 static int qemu_rbd_connect(rados_t *cluster, rados_ioctx_t *io_ctx, 107 BlockdevOptionsRbd *opts, bool cache, 108 const char *keypairs, const char *secretid, 109 Error **errp); 110 111 static char *qemu_rbd_next_tok(char *src, char delim, char **p) 112 { 113 char *end; 114 115 *p = NULL; 116 117 for (end = src; *end; ++end) { 118 if (*end == delim) { 119 break; 120 } 121 if (*end == '\\' && end[1] != '\0') { 122 end++; 123 } 124 } 125 if (*end == delim) { 126 *p = end + 1; 127 *end = '\0'; 128 } 129 return src; 130 } 131 132 static void qemu_rbd_unescape(char *src) 133 { 134 char *p; 135 136 for (p = src; *src; ++src, ++p) { 137 if (*src == '\\' && src[1] != '\0') { 138 src++; 139 } 140 *p = *src; 141 } 142 *p = '\0'; 143 } 144 145 static void qemu_rbd_parse_filename(const char *filename, QDict *options, 146 Error **errp) 147 { 148 const char *start; 149 char *p, *buf; 150 QList *keypairs = NULL; 151 char *found_str; 152 153 if (!strstart(filename, "rbd:", &start)) { 154 error_setg(errp, "File name must start with 'rbd:'"); 155 return; 156 } 157 158 buf = g_strdup(start); 159 p = buf; 160 161 found_str = qemu_rbd_next_tok(p, '/', &p); 162 if (!p) { 163 error_setg(errp, "Pool name is required"); 164 goto done; 165 } 166 qemu_rbd_unescape(found_str); 167 qdict_put_str(options, "pool", found_str); 168 169 if (strchr(p, '@')) { 170 found_str = qemu_rbd_next_tok(p, '@', &p); 171 qemu_rbd_unescape(found_str); 172 qdict_put_str(options, "image", found_str); 173 174 found_str = qemu_rbd_next_tok(p, ':', &p); 175 qemu_rbd_unescape(found_str); 176 qdict_put_str(options, "snapshot", found_str); 177 } else { 178 found_str = qemu_rbd_next_tok(p, ':', &p); 179 qemu_rbd_unescape(found_str); 180 qdict_put_str(options, "image", found_str); 181 } 182 if (!p) { 183 goto done; 184 } 185 186 /* The following are essentially all key/value pairs, and we treat 187 * 'id' and 'conf' a bit special. Key/value pairs may be in any order. */ 188 while (p) { 189 char *name, *value; 190 name = qemu_rbd_next_tok(p, '=', &p); 191 if (!p) { 192 error_setg(errp, "conf option %s has no value", name); 193 break; 194 } 195 196 qemu_rbd_unescape(name); 197 198 value = qemu_rbd_next_tok(p, ':', &p); 199 qemu_rbd_unescape(value); 200 201 if (!strcmp(name, "conf")) { 202 qdict_put_str(options, "conf", value); 203 } else if (!strcmp(name, "id")) { 204 qdict_put_str(options, "user", value); 205 } else { 206 /* 207 * We pass these internally to qemu_rbd_set_keypairs(), so 208 * we can get away with the simpler list of [ "key1", 209 * "value1", "key2", "value2" ] rather than a raw dict 210 * { "key1": "value1", "key2": "value2" } where we can't 211 * guarantee order, or even a more correct but complex 212 * [ { "key1": "value1" }, { "key2": "value2" } ] 213 */ 214 if (!keypairs) { 215 keypairs = qlist_new(); 216 } 217 qlist_append_str(keypairs, name); 218 qlist_append_str(keypairs, value); 219 } 220 } 221 222 if (keypairs) { 223 qdict_put(options, "=keyvalue-pairs", 224 qobject_to_json(QOBJECT(keypairs))); 225 } 226 227 done: 228 g_free(buf); 229 qobject_unref(keypairs); 230 return; 231 } 232 233 234 static int qemu_rbd_set_auth(rados_t cluster, const char *secretid, 235 Error **errp) 236 { 237 if (secretid == 0) { 238 return 0; 239 } 240 241 gchar *secret = qcrypto_secret_lookup_as_base64(secretid, 242 errp); 243 if (!secret) { 244 return -1; 245 } 246 247 rados_conf_set(cluster, "key", secret); 248 g_free(secret); 249 250 return 0; 251 } 252 253 static int qemu_rbd_set_keypairs(rados_t cluster, const char *keypairs_json, 254 Error **errp) 255 { 256 QList *keypairs; 257 QString *name; 258 QString *value; 259 const char *key; 260 size_t remaining; 261 int ret = 0; 262 263 if (!keypairs_json) { 264 return ret; 265 } 266 keypairs = qobject_to(QList, 267 qobject_from_json(keypairs_json, &error_abort)); 268 remaining = qlist_size(keypairs) / 2; 269 assert(remaining); 270 271 while (remaining--) { 272 name = qobject_to(QString, qlist_pop(keypairs)); 273 value = qobject_to(QString, qlist_pop(keypairs)); 274 assert(name && value); 275 key = qstring_get_str(name); 276 277 ret = rados_conf_set(cluster, key, qstring_get_str(value)); 278 qobject_unref(value); 279 if (ret < 0) { 280 error_setg_errno(errp, -ret, "invalid conf option %s", key); 281 qobject_unref(name); 282 ret = -EINVAL; 283 break; 284 } 285 qobject_unref(name); 286 } 287 288 qobject_unref(keypairs); 289 return ret; 290 } 291 292 static void qemu_rbd_memset(RADOSCB *rcb, int64_t offs) 293 { 294 if (LIBRBD_USE_IOVEC) { 295 RBDAIOCB *acb = rcb->acb; 296 iov_memset(acb->qiov->iov, acb->qiov->niov, offs, 0, 297 acb->qiov->size - offs); 298 } else { 299 memset(rcb->buf + offs, 0, rcb->size - offs); 300 } 301 } 302 303 static QemuOptsList runtime_opts = { 304 .name = "rbd", 305 .head = QTAILQ_HEAD_INITIALIZER(runtime_opts.head), 306 .desc = { 307 { 308 .name = "pool", 309 .type = QEMU_OPT_STRING, 310 .help = "Rados pool name", 311 }, 312 { 313 .name = "image", 314 .type = QEMU_OPT_STRING, 315 .help = "Image name in the pool", 316 }, 317 { 318 .name = "conf", 319 .type = QEMU_OPT_STRING, 320 .help = "Rados config file location", 321 }, 322 { 323 .name = "snapshot", 324 .type = QEMU_OPT_STRING, 325 .help = "Ceph snapshot name", 326 }, 327 { 328 /* maps to 'id' in rados_create() */ 329 .name = "user", 330 .type = QEMU_OPT_STRING, 331 .help = "Rados id name", 332 }, 333 /* 334 * server.* extracted manually, see qemu_rbd_mon_host() 335 */ 336 { /* end of list */ } 337 }, 338 }; 339 340 /* FIXME Deprecate and remove keypairs or make it available in QMP. 341 * password_secret should eventually be configurable in opts->location. Support 342 * for it in .bdrv_open will make it work here as well. */ 343 static int qemu_rbd_do_create(BlockdevCreateOptions *options, 344 const char *keypairs, const char *password_secret, 345 Error **errp) 346 { 347 BlockdevCreateOptionsRbd *opts = &options->u.rbd; 348 rados_t cluster; 349 rados_ioctx_t io_ctx; 350 int obj_order = 0; 351 int ret; 352 353 assert(options->driver == BLOCKDEV_DRIVER_RBD); 354 if (opts->location->has_snapshot) { 355 error_setg(errp, "Can't use snapshot name for image creation"); 356 return -EINVAL; 357 } 358 359 if (opts->has_cluster_size) { 360 int64_t objsize = opts->cluster_size; 361 if ((objsize - 1) & objsize) { /* not a power of 2? */ 362 error_setg(errp, "obj size needs to be power of 2"); 363 return -EINVAL; 364 } 365 if (objsize < 4096) { 366 error_setg(errp, "obj size too small"); 367 return -EINVAL; 368 } 369 obj_order = ctz32(objsize); 370 } 371 372 ret = qemu_rbd_connect(&cluster, &io_ctx, opts->location, false, keypairs, 373 password_secret, errp); 374 if (ret < 0) { 375 return ret; 376 } 377 378 ret = rbd_create(io_ctx, opts->location->image, opts->size, &obj_order); 379 if (ret < 0) { 380 error_setg_errno(errp, -ret, "error rbd create"); 381 goto out; 382 } 383 384 ret = 0; 385 out: 386 rados_ioctx_destroy(io_ctx); 387 rados_shutdown(cluster); 388 return ret; 389 } 390 391 static int qemu_rbd_co_create(BlockdevCreateOptions *options, Error **errp) 392 { 393 return qemu_rbd_do_create(options, NULL, NULL, errp); 394 } 395 396 static int coroutine_fn qemu_rbd_co_create_opts(const char *filename, 397 QemuOpts *opts, 398 Error **errp) 399 { 400 BlockdevCreateOptions *create_options; 401 BlockdevCreateOptionsRbd *rbd_opts; 402 BlockdevOptionsRbd *loc; 403 Error *local_err = NULL; 404 const char *keypairs, *password_secret; 405 QDict *options = NULL; 406 int ret = 0; 407 408 create_options = g_new0(BlockdevCreateOptions, 1); 409 create_options->driver = BLOCKDEV_DRIVER_RBD; 410 rbd_opts = &create_options->u.rbd; 411 412 rbd_opts->location = g_new0(BlockdevOptionsRbd, 1); 413 414 password_secret = qemu_opt_get(opts, "password-secret"); 415 416 /* Read out options */ 417 rbd_opts->size = ROUND_UP(qemu_opt_get_size_del(opts, BLOCK_OPT_SIZE, 0), 418 BDRV_SECTOR_SIZE); 419 rbd_opts->cluster_size = qemu_opt_get_size_del(opts, 420 BLOCK_OPT_CLUSTER_SIZE, 0); 421 rbd_opts->has_cluster_size = (rbd_opts->cluster_size != 0); 422 423 options = qdict_new(); 424 qemu_rbd_parse_filename(filename, options, &local_err); 425 if (local_err) { 426 ret = -EINVAL; 427 error_propagate(errp, local_err); 428 goto exit; 429 } 430 431 /* 432 * Caution: while qdict_get_try_str() is fine, getting non-string 433 * types would require more care. When @options come from -blockdev 434 * or blockdev_add, its members are typed according to the QAPI 435 * schema, but when they come from -drive, they're all QString. 436 */ 437 loc = rbd_opts->location; 438 loc->pool = g_strdup(qdict_get_try_str(options, "pool")); 439 loc->conf = g_strdup(qdict_get_try_str(options, "conf")); 440 loc->has_conf = !!loc->conf; 441 loc->user = g_strdup(qdict_get_try_str(options, "user")); 442 loc->has_user = !!loc->user; 443 loc->image = g_strdup(qdict_get_try_str(options, "image")); 444 keypairs = qdict_get_try_str(options, "=keyvalue-pairs"); 445 446 ret = qemu_rbd_do_create(create_options, keypairs, password_secret, errp); 447 if (ret < 0) { 448 goto exit; 449 } 450 451 exit: 452 qobject_unref(options); 453 qapi_free_BlockdevCreateOptions(create_options); 454 return ret; 455 } 456 457 /* 458 * This aio completion is being called from rbd_finish_bh() and runs in qemu 459 * BH context. 460 */ 461 static void qemu_rbd_complete_aio(RADOSCB *rcb) 462 { 463 RBDAIOCB *acb = rcb->acb; 464 int64_t r; 465 466 r = rcb->ret; 467 468 if (acb->cmd != RBD_AIO_READ) { 469 if (r < 0) { 470 acb->ret = r; 471 acb->error = 1; 472 } else if (!acb->error) { 473 acb->ret = rcb->size; 474 } 475 } else { 476 if (r < 0) { 477 qemu_rbd_memset(rcb, 0); 478 acb->ret = r; 479 acb->error = 1; 480 } else if (r < rcb->size) { 481 qemu_rbd_memset(rcb, r); 482 if (!acb->error) { 483 acb->ret = rcb->size; 484 } 485 } else if (!acb->error) { 486 acb->ret = r; 487 } 488 } 489 490 g_free(rcb); 491 492 if (!LIBRBD_USE_IOVEC) { 493 if (acb->cmd == RBD_AIO_READ) { 494 qemu_iovec_from_buf(acb->qiov, 0, acb->bounce, acb->qiov->size); 495 } 496 qemu_vfree(acb->bounce); 497 } 498 499 acb->common.cb(acb->common.opaque, (acb->ret > 0 ? 0 : acb->ret)); 500 501 qemu_aio_unref(acb); 502 } 503 504 static char *qemu_rbd_mon_host(BlockdevOptionsRbd *opts, Error **errp) 505 { 506 const char **vals; 507 const char *host, *port; 508 char *rados_str; 509 InetSocketAddressBaseList *p; 510 int i, cnt; 511 512 if (!opts->has_server) { 513 return NULL; 514 } 515 516 for (cnt = 0, p = opts->server; p; p = p->next) { 517 cnt++; 518 } 519 520 vals = g_new(const char *, cnt + 1); 521 522 for (i = 0, p = opts->server; p; p = p->next, i++) { 523 host = p->value->host; 524 port = p->value->port; 525 526 if (strchr(host, ':')) { 527 vals[i] = g_strdup_printf("[%s]:%s", host, port); 528 } else { 529 vals[i] = g_strdup_printf("%s:%s", host, port); 530 } 531 } 532 vals[i] = NULL; 533 534 rados_str = i ? g_strjoinv(";", (char **)vals) : NULL; 535 g_strfreev((char **)vals); 536 return rados_str; 537 } 538 539 static int qemu_rbd_connect(rados_t *cluster, rados_ioctx_t *io_ctx, 540 BlockdevOptionsRbd *opts, bool cache, 541 const char *keypairs, const char *secretid, 542 Error **errp) 543 { 544 char *mon_host = NULL; 545 Error *local_err = NULL; 546 int r; 547 548 mon_host = qemu_rbd_mon_host(opts, &local_err); 549 if (local_err) { 550 error_propagate(errp, local_err); 551 r = -EINVAL; 552 goto failed_opts; 553 } 554 555 r = rados_create(cluster, opts->user); 556 if (r < 0) { 557 error_setg_errno(errp, -r, "error initializing"); 558 goto failed_opts; 559 } 560 561 /* try default location when conf=NULL, but ignore failure */ 562 r = rados_conf_read_file(*cluster, opts->conf); 563 if (opts->has_conf && r < 0) { 564 error_setg_errno(errp, -r, "error reading conf file %s", opts->conf); 565 goto failed_shutdown; 566 } 567 568 r = qemu_rbd_set_keypairs(*cluster, keypairs, errp); 569 if (r < 0) { 570 goto failed_shutdown; 571 } 572 573 if (mon_host) { 574 r = rados_conf_set(*cluster, "mon_host", mon_host); 575 if (r < 0) { 576 goto failed_shutdown; 577 } 578 } 579 580 if (qemu_rbd_set_auth(*cluster, secretid, errp) < 0) { 581 r = -EIO; 582 goto failed_shutdown; 583 } 584 585 /* 586 * Fallback to more conservative semantics if setting cache 587 * options fails. Ignore errors from setting rbd_cache because the 588 * only possible error is that the option does not exist, and 589 * librbd defaults to no caching. If write through caching cannot 590 * be set up, fall back to no caching. 591 */ 592 if (cache) { 593 rados_conf_set(*cluster, "rbd_cache", "true"); 594 } else { 595 rados_conf_set(*cluster, "rbd_cache", "false"); 596 } 597 598 r = rados_connect(*cluster); 599 if (r < 0) { 600 error_setg_errno(errp, -r, "error connecting"); 601 goto failed_shutdown; 602 } 603 604 r = rados_ioctx_create(*cluster, opts->pool, io_ctx); 605 if (r < 0) { 606 error_setg_errno(errp, -r, "error opening pool %s", opts->pool); 607 goto failed_shutdown; 608 } 609 610 return 0; 611 612 failed_shutdown: 613 rados_shutdown(*cluster); 614 failed_opts: 615 g_free(mon_host); 616 return r; 617 } 618 619 static int qemu_rbd_open(BlockDriverState *bs, QDict *options, int flags, 620 Error **errp) 621 { 622 BDRVRBDState *s = bs->opaque; 623 BlockdevOptionsRbd *opts = NULL; 624 Visitor *v; 625 QObject *crumpled = NULL; 626 const QDictEntry *e; 627 Error *local_err = NULL; 628 const char *filename; 629 char *keypairs, *secretid; 630 int r; 631 632 /* If we are given a filename, parse the filename, with precedence given to 633 * filename encoded options */ 634 filename = qdict_get_try_str(options, "filename"); 635 if (filename) { 636 warn_report("'filename' option specified. " 637 "This is an unsupported option, and may be deprecated " 638 "in the future"); 639 qemu_rbd_parse_filename(filename, options, &local_err); 640 qdict_del(options, "filename"); 641 if (local_err) { 642 error_propagate(errp, local_err); 643 return -EINVAL; 644 } 645 } 646 647 keypairs = g_strdup(qdict_get_try_str(options, "=keyvalue-pairs")); 648 if (keypairs) { 649 qdict_del(options, "=keyvalue-pairs"); 650 } 651 652 secretid = g_strdup(qdict_get_try_str(options, "password-secret")); 653 if (secretid) { 654 qdict_del(options, "password-secret"); 655 } 656 657 /* Convert the remaining options into a QAPI object */ 658 crumpled = qdict_crumple(options, errp); 659 if (crumpled == NULL) { 660 r = -EINVAL; 661 goto out; 662 } 663 664 v = qobject_input_visitor_new_keyval(crumpled); 665 visit_type_BlockdevOptionsRbd(v, NULL, &opts, &local_err); 666 visit_free(v); 667 qobject_unref(crumpled); 668 669 if (local_err) { 670 error_propagate(errp, local_err); 671 r = -EINVAL; 672 goto out; 673 } 674 675 /* Remove the processed options from the QDict (the visitor processes 676 * _all_ options in the QDict) */ 677 while ((e = qdict_first(options))) { 678 qdict_del(options, e->key); 679 } 680 681 r = qemu_rbd_connect(&s->cluster, &s->io_ctx, opts, 682 !(flags & BDRV_O_NOCACHE), keypairs, secretid, errp); 683 if (r < 0) { 684 goto out; 685 } 686 687 s->snap = g_strdup(opts->snapshot); 688 s->image_name = g_strdup(opts->image); 689 690 /* rbd_open is always r/w */ 691 r = rbd_open(s->io_ctx, s->image_name, &s->image, s->snap); 692 if (r < 0) { 693 error_setg_errno(errp, -r, "error reading header from %s", 694 s->image_name); 695 goto failed_open; 696 } 697 698 /* If we are using an rbd snapshot, we must be r/o, otherwise 699 * leave as-is */ 700 if (s->snap != NULL) { 701 if (!bdrv_is_read_only(bs)) { 702 error_report("Opening rbd snapshots without an explicit " 703 "read-only=on option is deprecated. Future versions " 704 "will refuse to open the image instead of " 705 "automatically marking the image read-only."); 706 r = bdrv_set_read_only(bs, true, &local_err); 707 if (r < 0) { 708 error_propagate(errp, local_err); 709 goto failed_open; 710 } 711 } 712 } 713 714 r = 0; 715 goto out; 716 717 failed_open: 718 rados_ioctx_destroy(s->io_ctx); 719 g_free(s->snap); 720 g_free(s->image_name); 721 rados_shutdown(s->cluster); 722 out: 723 qapi_free_BlockdevOptionsRbd(opts); 724 g_free(keypairs); 725 g_free(secretid); 726 return r; 727 } 728 729 730 /* Since RBD is currently always opened R/W via the API, 731 * we just need to check if we are using a snapshot or not, in 732 * order to determine if we will allow it to be R/W */ 733 static int qemu_rbd_reopen_prepare(BDRVReopenState *state, 734 BlockReopenQueue *queue, Error **errp) 735 { 736 BDRVRBDState *s = state->bs->opaque; 737 int ret = 0; 738 739 if (s->snap && state->flags & BDRV_O_RDWR) { 740 error_setg(errp, 741 "Cannot change node '%s' to r/w when using RBD snapshot", 742 bdrv_get_device_or_node_name(state->bs)); 743 ret = -EINVAL; 744 } 745 746 return ret; 747 } 748 749 static void qemu_rbd_close(BlockDriverState *bs) 750 { 751 BDRVRBDState *s = bs->opaque; 752 753 rbd_close(s->image); 754 rados_ioctx_destroy(s->io_ctx); 755 g_free(s->snap); 756 g_free(s->image_name); 757 rados_shutdown(s->cluster); 758 } 759 760 static const AIOCBInfo rbd_aiocb_info = { 761 .aiocb_size = sizeof(RBDAIOCB), 762 }; 763 764 static void rbd_finish_bh(void *opaque) 765 { 766 RADOSCB *rcb = opaque; 767 qemu_rbd_complete_aio(rcb); 768 } 769 770 /* 771 * This is the callback function for rbd_aio_read and _write 772 * 773 * Note: this function is being called from a non qemu thread so 774 * we need to be careful about what we do here. Generally we only 775 * schedule a BH, and do the rest of the io completion handling 776 * from rbd_finish_bh() which runs in a qemu context. 777 */ 778 static void rbd_finish_aiocb(rbd_completion_t c, RADOSCB *rcb) 779 { 780 RBDAIOCB *acb = rcb->acb; 781 782 rcb->ret = rbd_aio_get_return_value(c); 783 rbd_aio_release(c); 784 785 aio_bh_schedule_oneshot(bdrv_get_aio_context(acb->common.bs), 786 rbd_finish_bh, rcb); 787 } 788 789 static int rbd_aio_discard_wrapper(rbd_image_t image, 790 uint64_t off, 791 uint64_t len, 792 rbd_completion_t comp) 793 { 794 #ifdef LIBRBD_SUPPORTS_DISCARD 795 return rbd_aio_discard(image, off, len, comp); 796 #else 797 return -ENOTSUP; 798 #endif 799 } 800 801 static int rbd_aio_flush_wrapper(rbd_image_t image, 802 rbd_completion_t comp) 803 { 804 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH 805 return rbd_aio_flush(image, comp); 806 #else 807 return -ENOTSUP; 808 #endif 809 } 810 811 static BlockAIOCB *rbd_start_aio(BlockDriverState *bs, 812 int64_t off, 813 QEMUIOVector *qiov, 814 int64_t size, 815 BlockCompletionFunc *cb, 816 void *opaque, 817 RBDAIOCmd cmd) 818 { 819 RBDAIOCB *acb; 820 RADOSCB *rcb = NULL; 821 rbd_completion_t c; 822 int r; 823 824 BDRVRBDState *s = bs->opaque; 825 826 acb = qemu_aio_get(&rbd_aiocb_info, bs, cb, opaque); 827 acb->cmd = cmd; 828 acb->qiov = qiov; 829 assert(!qiov || qiov->size == size); 830 831 rcb = g_new(RADOSCB, 1); 832 833 if (!LIBRBD_USE_IOVEC) { 834 if (cmd == RBD_AIO_DISCARD || cmd == RBD_AIO_FLUSH) { 835 acb->bounce = NULL; 836 } else { 837 acb->bounce = qemu_try_blockalign(bs, qiov->size); 838 if (acb->bounce == NULL) { 839 goto failed; 840 } 841 } 842 if (cmd == RBD_AIO_WRITE) { 843 qemu_iovec_to_buf(acb->qiov, 0, acb->bounce, qiov->size); 844 } 845 rcb->buf = acb->bounce; 846 } 847 848 acb->ret = 0; 849 acb->error = 0; 850 acb->s = s; 851 852 rcb->acb = acb; 853 rcb->s = acb->s; 854 rcb->size = size; 855 r = rbd_aio_create_completion(rcb, (rbd_callback_t) rbd_finish_aiocb, &c); 856 if (r < 0) { 857 goto failed; 858 } 859 860 switch (cmd) { 861 case RBD_AIO_WRITE: 862 #ifdef LIBRBD_SUPPORTS_IOVEC 863 r = rbd_aio_writev(s->image, qiov->iov, qiov->niov, off, c); 864 #else 865 r = rbd_aio_write(s->image, off, size, rcb->buf, c); 866 #endif 867 break; 868 case RBD_AIO_READ: 869 #ifdef LIBRBD_SUPPORTS_IOVEC 870 r = rbd_aio_readv(s->image, qiov->iov, qiov->niov, off, c); 871 #else 872 r = rbd_aio_read(s->image, off, size, rcb->buf, c); 873 #endif 874 break; 875 case RBD_AIO_DISCARD: 876 r = rbd_aio_discard_wrapper(s->image, off, size, c); 877 break; 878 case RBD_AIO_FLUSH: 879 r = rbd_aio_flush_wrapper(s->image, c); 880 break; 881 default: 882 r = -EINVAL; 883 } 884 885 if (r < 0) { 886 goto failed_completion; 887 } 888 return &acb->common; 889 890 failed_completion: 891 rbd_aio_release(c); 892 failed: 893 g_free(rcb); 894 if (!LIBRBD_USE_IOVEC) { 895 qemu_vfree(acb->bounce); 896 } 897 898 qemu_aio_unref(acb); 899 return NULL; 900 } 901 902 static BlockAIOCB *qemu_rbd_aio_readv(BlockDriverState *bs, 903 int64_t sector_num, 904 QEMUIOVector *qiov, 905 int nb_sectors, 906 BlockCompletionFunc *cb, 907 void *opaque) 908 { 909 return rbd_start_aio(bs, sector_num << BDRV_SECTOR_BITS, qiov, 910 (int64_t) nb_sectors << BDRV_SECTOR_BITS, cb, opaque, 911 RBD_AIO_READ); 912 } 913 914 static BlockAIOCB *qemu_rbd_aio_writev(BlockDriverState *bs, 915 int64_t sector_num, 916 QEMUIOVector *qiov, 917 int nb_sectors, 918 BlockCompletionFunc *cb, 919 void *opaque) 920 { 921 return rbd_start_aio(bs, sector_num << BDRV_SECTOR_BITS, qiov, 922 (int64_t) nb_sectors << BDRV_SECTOR_BITS, cb, opaque, 923 RBD_AIO_WRITE); 924 } 925 926 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH 927 static BlockAIOCB *qemu_rbd_aio_flush(BlockDriverState *bs, 928 BlockCompletionFunc *cb, 929 void *opaque) 930 { 931 return rbd_start_aio(bs, 0, NULL, 0, cb, opaque, RBD_AIO_FLUSH); 932 } 933 934 #else 935 936 static int qemu_rbd_co_flush(BlockDriverState *bs) 937 { 938 #if LIBRBD_VERSION_CODE >= LIBRBD_VERSION(0, 1, 1) 939 /* rbd_flush added in 0.1.1 */ 940 BDRVRBDState *s = bs->opaque; 941 return rbd_flush(s->image); 942 #else 943 return 0; 944 #endif 945 } 946 #endif 947 948 static int qemu_rbd_getinfo(BlockDriverState *bs, BlockDriverInfo *bdi) 949 { 950 BDRVRBDState *s = bs->opaque; 951 rbd_image_info_t info; 952 int r; 953 954 r = rbd_stat(s->image, &info, sizeof(info)); 955 if (r < 0) { 956 return r; 957 } 958 959 bdi->cluster_size = info.obj_size; 960 return 0; 961 } 962 963 static int64_t qemu_rbd_getlength(BlockDriverState *bs) 964 { 965 BDRVRBDState *s = bs->opaque; 966 rbd_image_info_t info; 967 int r; 968 969 r = rbd_stat(s->image, &info, sizeof(info)); 970 if (r < 0) { 971 return r; 972 } 973 974 return info.size; 975 } 976 977 static int qemu_rbd_truncate(BlockDriverState *bs, int64_t offset, 978 PreallocMode prealloc, Error **errp) 979 { 980 BDRVRBDState *s = bs->opaque; 981 int r; 982 983 if (prealloc != PREALLOC_MODE_OFF) { 984 error_setg(errp, "Unsupported preallocation mode '%s'", 985 PreallocMode_str(prealloc)); 986 return -ENOTSUP; 987 } 988 989 r = rbd_resize(s->image, offset); 990 if (r < 0) { 991 error_setg_errno(errp, -r, "Failed to resize file"); 992 return r; 993 } 994 995 return 0; 996 } 997 998 static int qemu_rbd_snap_create(BlockDriverState *bs, 999 QEMUSnapshotInfo *sn_info) 1000 { 1001 BDRVRBDState *s = bs->opaque; 1002 int r; 1003 1004 if (sn_info->name[0] == '\0') { 1005 return -EINVAL; /* we need a name for rbd snapshots */ 1006 } 1007 1008 /* 1009 * rbd snapshots are using the name as the user controlled unique identifier 1010 * we can't use the rbd snapid for that purpose, as it can't be set 1011 */ 1012 if (sn_info->id_str[0] != '\0' && 1013 strcmp(sn_info->id_str, sn_info->name) != 0) { 1014 return -EINVAL; 1015 } 1016 1017 if (strlen(sn_info->name) >= sizeof(sn_info->id_str)) { 1018 return -ERANGE; 1019 } 1020 1021 r = rbd_snap_create(s->image, sn_info->name); 1022 if (r < 0) { 1023 error_report("failed to create snap: %s", strerror(-r)); 1024 return r; 1025 } 1026 1027 return 0; 1028 } 1029 1030 static int qemu_rbd_snap_remove(BlockDriverState *bs, 1031 const char *snapshot_id, 1032 const char *snapshot_name, 1033 Error **errp) 1034 { 1035 BDRVRBDState *s = bs->opaque; 1036 int r; 1037 1038 if (!snapshot_name) { 1039 error_setg(errp, "rbd need a valid snapshot name"); 1040 return -EINVAL; 1041 } 1042 1043 /* If snapshot_id is specified, it must be equal to name, see 1044 qemu_rbd_snap_list() */ 1045 if (snapshot_id && strcmp(snapshot_id, snapshot_name)) { 1046 error_setg(errp, 1047 "rbd do not support snapshot id, it should be NULL or " 1048 "equal to snapshot name"); 1049 return -EINVAL; 1050 } 1051 1052 r = rbd_snap_remove(s->image, snapshot_name); 1053 if (r < 0) { 1054 error_setg_errno(errp, -r, "Failed to remove the snapshot"); 1055 } 1056 return r; 1057 } 1058 1059 static int qemu_rbd_snap_rollback(BlockDriverState *bs, 1060 const char *snapshot_name) 1061 { 1062 BDRVRBDState *s = bs->opaque; 1063 1064 return rbd_snap_rollback(s->image, snapshot_name); 1065 } 1066 1067 static int qemu_rbd_snap_list(BlockDriverState *bs, 1068 QEMUSnapshotInfo **psn_tab) 1069 { 1070 BDRVRBDState *s = bs->opaque; 1071 QEMUSnapshotInfo *sn_info, *sn_tab = NULL; 1072 int i, snap_count; 1073 rbd_snap_info_t *snaps; 1074 int max_snaps = RBD_MAX_SNAPS; 1075 1076 do { 1077 snaps = g_new(rbd_snap_info_t, max_snaps); 1078 snap_count = rbd_snap_list(s->image, snaps, &max_snaps); 1079 if (snap_count <= 0) { 1080 g_free(snaps); 1081 } 1082 } while (snap_count == -ERANGE); 1083 1084 if (snap_count <= 0) { 1085 goto done; 1086 } 1087 1088 sn_tab = g_new0(QEMUSnapshotInfo, snap_count); 1089 1090 for (i = 0; i < snap_count; i++) { 1091 const char *snap_name = snaps[i].name; 1092 1093 sn_info = sn_tab + i; 1094 pstrcpy(sn_info->id_str, sizeof(sn_info->id_str), snap_name); 1095 pstrcpy(sn_info->name, sizeof(sn_info->name), snap_name); 1096 1097 sn_info->vm_state_size = snaps[i].size; 1098 sn_info->date_sec = 0; 1099 sn_info->date_nsec = 0; 1100 sn_info->vm_clock_nsec = 0; 1101 } 1102 rbd_snap_list_end(snaps); 1103 g_free(snaps); 1104 1105 done: 1106 *psn_tab = sn_tab; 1107 return snap_count; 1108 } 1109 1110 #ifdef LIBRBD_SUPPORTS_DISCARD 1111 static BlockAIOCB *qemu_rbd_aio_pdiscard(BlockDriverState *bs, 1112 int64_t offset, 1113 int bytes, 1114 BlockCompletionFunc *cb, 1115 void *opaque) 1116 { 1117 return rbd_start_aio(bs, offset, NULL, bytes, cb, opaque, 1118 RBD_AIO_DISCARD); 1119 } 1120 #endif 1121 1122 #ifdef LIBRBD_SUPPORTS_INVALIDATE 1123 static void coroutine_fn qemu_rbd_co_invalidate_cache(BlockDriverState *bs, 1124 Error **errp) 1125 { 1126 BDRVRBDState *s = bs->opaque; 1127 int r = rbd_invalidate_cache(s->image); 1128 if (r < 0) { 1129 error_setg_errno(errp, -r, "Failed to invalidate the cache"); 1130 } 1131 } 1132 #endif 1133 1134 static QemuOptsList qemu_rbd_create_opts = { 1135 .name = "rbd-create-opts", 1136 .head = QTAILQ_HEAD_INITIALIZER(qemu_rbd_create_opts.head), 1137 .desc = { 1138 { 1139 .name = BLOCK_OPT_SIZE, 1140 .type = QEMU_OPT_SIZE, 1141 .help = "Virtual disk size" 1142 }, 1143 { 1144 .name = BLOCK_OPT_CLUSTER_SIZE, 1145 .type = QEMU_OPT_SIZE, 1146 .help = "RBD object size" 1147 }, 1148 { 1149 .name = "password-secret", 1150 .type = QEMU_OPT_STRING, 1151 .help = "ID of secret providing the password", 1152 }, 1153 { /* end of list */ } 1154 } 1155 }; 1156 1157 static BlockDriver bdrv_rbd = { 1158 .format_name = "rbd", 1159 .instance_size = sizeof(BDRVRBDState), 1160 .bdrv_parse_filename = qemu_rbd_parse_filename, 1161 .bdrv_file_open = qemu_rbd_open, 1162 .bdrv_close = qemu_rbd_close, 1163 .bdrv_reopen_prepare = qemu_rbd_reopen_prepare, 1164 .bdrv_co_create = qemu_rbd_co_create, 1165 .bdrv_co_create_opts = qemu_rbd_co_create_opts, 1166 .bdrv_has_zero_init = bdrv_has_zero_init_1, 1167 .bdrv_get_info = qemu_rbd_getinfo, 1168 .create_opts = &qemu_rbd_create_opts, 1169 .bdrv_getlength = qemu_rbd_getlength, 1170 .bdrv_truncate = qemu_rbd_truncate, 1171 .protocol_name = "rbd", 1172 1173 .bdrv_aio_readv = qemu_rbd_aio_readv, 1174 .bdrv_aio_writev = qemu_rbd_aio_writev, 1175 1176 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH 1177 .bdrv_aio_flush = qemu_rbd_aio_flush, 1178 #else 1179 .bdrv_co_flush_to_disk = qemu_rbd_co_flush, 1180 #endif 1181 1182 #ifdef LIBRBD_SUPPORTS_DISCARD 1183 .bdrv_aio_pdiscard = qemu_rbd_aio_pdiscard, 1184 #endif 1185 1186 .bdrv_snapshot_create = qemu_rbd_snap_create, 1187 .bdrv_snapshot_delete = qemu_rbd_snap_remove, 1188 .bdrv_snapshot_list = qemu_rbd_snap_list, 1189 .bdrv_snapshot_goto = qemu_rbd_snap_rollback, 1190 #ifdef LIBRBD_SUPPORTS_INVALIDATE 1191 .bdrv_co_invalidate_cache = qemu_rbd_co_invalidate_cache, 1192 #endif 1193 }; 1194 1195 static void bdrv_rbd_init(void) 1196 { 1197 bdrv_register(&bdrv_rbd); 1198 } 1199 1200 block_init(bdrv_rbd_init); 1201