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