2 * QEMU Block driver for RADOS (Ceph)
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 "qapi/error.h"
17 #include "qemu/error-report.h"
18 #include "block/block_int.h"
19 #include "crypto/secret.h"
20 #include "qemu/cutils.h"
22 #include <rbd/librbd.h>
25 * When specifying the image filename use:
27 * rbd:poolname/devicename[@snapshotname][:option1=value1[:option2=value2...]]
29 * poolname must be the name of an existing rados pool.
31 * devicename is the name of the rbd image.
33 * Each option given is used to configure rados, and may be any valid
34 * Ceph option, "id", or "conf".
36 * The "id" option indicates what user we should authenticate as to
37 * the Ceph cluster. If it is excluded we will use the Ceph default
40 * The "conf" option specifies a Ceph configuration file to read. If
41 * it is not specified, we will read from the default Ceph locations
42 * (e.g., /etc/ceph/ceph.conf). To avoid reading _any_ configuration
43 * file, specify conf=/dev/null.
45 * Configuration values containing :, @, or = can be escaped with a
49 /* rbd_aio_discard added in 0.1.2 */
50 #if LIBRBD_VERSION_CODE >= LIBRBD_VERSION(0, 1, 2)
51 #define LIBRBD_SUPPORTS_DISCARD
53 #undef LIBRBD_SUPPORTS_DISCARD
56 #define OBJ_MAX_SIZE (1UL << OBJ_DEFAULT_OBJ_ORDER)
58 #define RBD_MAX_CONF_NAME_SIZE 128
59 #define RBD_MAX_CONF_VAL_SIZE 512
60 #define RBD_MAX_CONF_SIZE 1024
61 #define RBD_MAX_POOL_NAME_SIZE 128
62 #define RBD_MAX_SNAP_NAME_SIZE 128
63 #define RBD_MAX_SNAPS 100
72 typedef struct RBDAIOCB {
79 struct BDRVRBDState *s;
82 typedef struct RADOSCB {
84 struct BDRVRBDState *s;
90 typedef struct BDRVRBDState {
94 char name[RBD_MAX_IMAGE_NAME_SIZE];
98 static int qemu_rbd_next_tok(char *dst, int dst_len,
99 char *src, char delim,
101 char **p, Error **errp)
109 for (end = src; *end; ++end) {
113 if (*end == '\\' && end[1] != '\0') {
124 error_setg(errp, "%s too long", name);
127 error_setg(errp, "%s too short", name);
131 pstrcpy(dst, dst_len, src);
136 static void qemu_rbd_unescape(char *src)
140 for (p = src; *src; ++src, ++p) {
141 if (*src == '\\' && src[1] != '\0') {
149 static int qemu_rbd_parsename(const char *filename,
150 char *pool, int pool_len,
151 char *snap, int snap_len,
152 char *name, int name_len,
153 char *conf, int conf_len,
160 if (!strstart(filename, "rbd:", &start)) {
161 error_setg(errp, "File name must start with 'rbd:'");
165 buf = g_strdup(start);
170 ret = qemu_rbd_next_tok(pool, pool_len, p,
171 '/', "pool name", &p, errp);
176 qemu_rbd_unescape(pool);
178 if (strchr(p, '@')) {
179 ret = qemu_rbd_next_tok(name, name_len, p,
180 '@', "object name", &p, errp);
184 ret = qemu_rbd_next_tok(snap, snap_len, p,
185 ':', "snap name", &p, errp);
186 qemu_rbd_unescape(snap);
188 ret = qemu_rbd_next_tok(name, name_len, p,
189 ':', "object name", &p, errp);
191 qemu_rbd_unescape(name);
196 ret = qemu_rbd_next_tok(conf, conf_len, p,
197 '\0', "configuration", &p, errp);
204 static char *qemu_rbd_parse_clientname(const char *conf, char *clientname)
206 const char *p = conf;
210 const char *end = strchr(p, ':');
218 if (strncmp(p, "id=", 3) == 0) {
220 strncpy(clientname, p + 3, len);
221 clientname[len] = '\0';
233 static int qemu_rbd_set_auth(rados_t cluster, const char *secretid,
240 gchar *secret = qcrypto_secret_lookup_as_base64(secretid,
246 rados_conf_set(cluster, "key", secret);
253 static int qemu_rbd_set_conf(rados_t cluster, const char *conf,
254 bool only_read_conf_file,
258 char name[RBD_MAX_CONF_NAME_SIZE];
259 char value[RBD_MAX_CONF_VAL_SIZE];
262 buf = g_strdup(conf);
266 ret = qemu_rbd_next_tok(name, sizeof(name), p,
267 '=', "conf option name", &p, errp);
271 qemu_rbd_unescape(name);
274 error_setg(errp, "conf option %s has no value", name);
279 ret = qemu_rbd_next_tok(value, sizeof(value), p,
280 ':', "conf option value", &p, errp);
284 qemu_rbd_unescape(value);
286 if (strcmp(name, "conf") == 0) {
287 /* read the conf file alone, so it doesn't override more
288 specific settings for a particular device */
289 if (only_read_conf_file) {
290 ret = rados_conf_read_file(cluster, value);
292 error_setg_errno(errp, -ret, "error reading conf file %s",
297 } else if (strcmp(name, "id") == 0) {
298 /* ignore, this is parsed by qemu_rbd_parse_clientname() */
299 } else if (!only_read_conf_file) {
300 ret = rados_conf_set(cluster, name, value);
302 error_setg_errno(errp, -ret, "invalid conf option %s", name);
313 static int qemu_rbd_create(const char *filename, QemuOpts *opts, Error **errp)
315 Error *local_err = NULL;
319 char pool[RBD_MAX_POOL_NAME_SIZE];
320 char name[RBD_MAX_IMAGE_NAME_SIZE];
321 char snap_buf[RBD_MAX_SNAP_NAME_SIZE];
322 char conf[RBD_MAX_CONF_SIZE];
323 char clientname_buf[RBD_MAX_CONF_SIZE];
325 const char *secretid;
327 rados_ioctx_t io_ctx;
330 secretid = qemu_opt_get(opts, "password-secret");
332 if (qemu_rbd_parsename(filename, pool, sizeof(pool),
333 snap_buf, sizeof(snap_buf),
335 conf, sizeof(conf), &local_err) < 0) {
336 error_propagate(errp, local_err);
340 /* Read out options */
341 bytes = ROUND_UP(qemu_opt_get_size_del(opts, BLOCK_OPT_SIZE, 0),
343 objsize = qemu_opt_get_size_del(opts, BLOCK_OPT_CLUSTER_SIZE, 0);
345 if ((objsize - 1) & objsize) { /* not a power of 2? */
346 error_setg(errp, "obj size needs to be power of 2");
349 if (objsize < 4096) {
350 error_setg(errp, "obj size too small");
353 obj_order = ctz32(objsize);
356 clientname = qemu_rbd_parse_clientname(conf, clientname_buf);
357 ret = rados_create(&cluster, clientname);
359 error_setg_errno(errp, -ret, "error initializing");
363 if (strstr(conf, "conf=") == NULL) {
364 /* try default location, but ignore failure */
365 rados_conf_read_file(cluster, NULL);
366 } else if (conf[0] != '\0' &&
367 qemu_rbd_set_conf(cluster, conf, true, &local_err) < 0) {
368 rados_shutdown(cluster);
369 error_propagate(errp, local_err);
373 if (conf[0] != '\0' &&
374 qemu_rbd_set_conf(cluster, conf, false, &local_err) < 0) {
375 rados_shutdown(cluster);
376 error_propagate(errp, local_err);
380 if (qemu_rbd_set_auth(cluster, secretid, errp) < 0) {
381 rados_shutdown(cluster);
385 ret = rados_connect(cluster);
387 error_setg_errno(errp, -ret, "error connecting");
388 rados_shutdown(cluster);
392 ret = rados_ioctx_create(cluster, pool, &io_ctx);
394 error_setg_errno(errp, -ret, "error opening pool %s", pool);
395 rados_shutdown(cluster);
399 ret = rbd_create(io_ctx, name, bytes, &obj_order);
400 rados_ioctx_destroy(io_ctx);
401 rados_shutdown(cluster);
403 error_setg_errno(errp, -ret, "error rbd create");
411 * This aio completion is being called from rbd_finish_bh() and runs in qemu
414 static void qemu_rbd_complete_aio(RADOSCB *rcb)
416 RBDAIOCB *acb = rcb->acb;
421 if (acb->cmd != RBD_AIO_READ) {
425 } else if (!acb->error) {
426 acb->ret = rcb->size;
430 memset(rcb->buf, 0, rcb->size);
433 } else if (r < rcb->size) {
434 memset(rcb->buf + r, 0, rcb->size - r);
436 acb->ret = rcb->size;
438 } else if (!acb->error) {
445 if (acb->cmd == RBD_AIO_READ) {
446 qemu_iovec_from_buf(acb->qiov, 0, acb->bounce, acb->qiov->size);
448 qemu_vfree(acb->bounce);
449 acb->common.cb(acb->common.opaque, (acb->ret > 0 ? 0 : acb->ret));
454 /* TODO Convert to fine grained options */
455 static QemuOptsList runtime_opts = {
457 .head = QTAILQ_HEAD_INITIALIZER(runtime_opts.head),
461 .type = QEMU_OPT_STRING,
462 .help = "Specification of the rbd image",
465 .name = "password-secret",
466 .type = QEMU_OPT_STRING,
467 .help = "ID of secret providing the password",
469 { /* end of list */ }
473 static int qemu_rbd_open(BlockDriverState *bs, QDict *options, int flags,
476 BDRVRBDState *s = bs->opaque;
477 char pool[RBD_MAX_POOL_NAME_SIZE];
478 char snap_buf[RBD_MAX_SNAP_NAME_SIZE];
479 char conf[RBD_MAX_CONF_SIZE];
480 char clientname_buf[RBD_MAX_CONF_SIZE];
482 const char *secretid;
484 Error *local_err = NULL;
485 const char *filename;
488 opts = qemu_opts_create(&runtime_opts, NULL, 0, &error_abort);
489 qemu_opts_absorb_qdict(opts, options, &local_err);
491 error_propagate(errp, local_err);
496 filename = qemu_opt_get(opts, "filename");
497 secretid = qemu_opt_get(opts, "password-secret");
499 if (qemu_rbd_parsename(filename, pool, sizeof(pool),
500 snap_buf, sizeof(snap_buf),
501 s->name, sizeof(s->name),
502 conf, sizeof(conf), errp) < 0) {
507 clientname = qemu_rbd_parse_clientname(conf, clientname_buf);
508 r = rados_create(&s->cluster, clientname);
510 error_setg_errno(errp, -r, "error initializing");
515 if (snap_buf[0] != '\0') {
516 s->snap = g_strdup(snap_buf);
519 if (strstr(conf, "conf=") == NULL) {
520 /* try default location, but ignore failure */
521 rados_conf_read_file(s->cluster, NULL);
522 } else if (conf[0] != '\0') {
523 r = qemu_rbd_set_conf(s->cluster, conf, true, errp);
525 goto failed_shutdown;
529 if (conf[0] != '\0') {
530 r = qemu_rbd_set_conf(s->cluster, conf, false, errp);
532 goto failed_shutdown;
536 if (qemu_rbd_set_auth(s->cluster, secretid, errp) < 0) {
538 goto failed_shutdown;
542 * Fallback to more conservative semantics if setting cache
543 * options fails. Ignore errors from setting rbd_cache because the
544 * only possible error is that the option does not exist, and
545 * librbd defaults to no caching. If write through caching cannot
546 * be set up, fall back to no caching.
548 if (flags & BDRV_O_NOCACHE) {
549 rados_conf_set(s->cluster, "rbd_cache", "false");
551 rados_conf_set(s->cluster, "rbd_cache", "true");
554 r = rados_connect(s->cluster);
556 error_setg_errno(errp, -r, "error connecting");
557 goto failed_shutdown;
560 r = rados_ioctx_create(s->cluster, pool, &s->io_ctx);
562 error_setg_errno(errp, -r, "error opening pool %s", pool);
563 goto failed_shutdown;
566 r = rbd_open(s->io_ctx, s->name, &s->image, s->snap);
568 error_setg_errno(errp, -r, "error reading header from %s", s->name);
572 bs->read_only = (s->snap != NULL);
578 rados_ioctx_destroy(s->io_ctx);
580 rados_shutdown(s->cluster);
587 static void qemu_rbd_close(BlockDriverState *bs)
589 BDRVRBDState *s = bs->opaque;
592 rados_ioctx_destroy(s->io_ctx);
594 rados_shutdown(s->cluster);
597 static const AIOCBInfo rbd_aiocb_info = {
598 .aiocb_size = sizeof(RBDAIOCB),
601 static void rbd_finish_bh(void *opaque)
603 RADOSCB *rcb = opaque;
604 qemu_rbd_complete_aio(rcb);
608 * This is the callback function for rbd_aio_read and _write
610 * Note: this function is being called from a non qemu thread so
611 * we need to be careful about what we do here. Generally we only
612 * schedule a BH, and do the rest of the io completion handling
613 * from rbd_finish_bh() which runs in a qemu context.
615 static void rbd_finish_aiocb(rbd_completion_t c, RADOSCB *rcb)
617 RBDAIOCB *acb = rcb->acb;
619 rcb->ret = rbd_aio_get_return_value(c);
622 aio_bh_schedule_oneshot(bdrv_get_aio_context(acb->common.bs),
626 static int rbd_aio_discard_wrapper(rbd_image_t image,
629 rbd_completion_t comp)
631 #ifdef LIBRBD_SUPPORTS_DISCARD
632 return rbd_aio_discard(image, off, len, comp);
638 static int rbd_aio_flush_wrapper(rbd_image_t image,
639 rbd_completion_t comp)
641 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH
642 return rbd_aio_flush(image, comp);
648 static BlockAIOCB *rbd_start_aio(BlockDriverState *bs,
652 BlockCompletionFunc *cb,
662 BDRVRBDState *s = bs->opaque;
664 acb = qemu_aio_get(&rbd_aiocb_info, bs, cb, opaque);
667 assert(!qiov || qiov->size == size);
668 if (cmd == RBD_AIO_DISCARD || cmd == RBD_AIO_FLUSH) {
671 acb->bounce = qemu_try_blockalign(bs, qiov->size);
672 if (acb->bounce == NULL) {
680 if (cmd == RBD_AIO_WRITE) {
681 qemu_iovec_to_buf(acb->qiov, 0, acb->bounce, qiov->size);
686 rcb = g_new(RADOSCB, 1);
691 r = rbd_aio_create_completion(rcb, (rbd_callback_t) rbd_finish_aiocb, &c);
698 r = rbd_aio_write(s->image, off, size, buf, c);
701 r = rbd_aio_read(s->image, off, size, buf, c);
703 case RBD_AIO_DISCARD:
704 r = rbd_aio_discard_wrapper(s->image, off, size, c);
707 r = rbd_aio_flush_wrapper(s->image, c);
714 goto failed_completion;
723 qemu_vfree(acb->bounce);
728 static BlockAIOCB *qemu_rbd_aio_readv(BlockDriverState *bs,
732 BlockCompletionFunc *cb,
735 return rbd_start_aio(bs, sector_num << BDRV_SECTOR_BITS, qiov,
736 (int64_t) nb_sectors << BDRV_SECTOR_BITS, cb, opaque,
740 static BlockAIOCB *qemu_rbd_aio_writev(BlockDriverState *bs,
744 BlockCompletionFunc *cb,
747 return rbd_start_aio(bs, sector_num << BDRV_SECTOR_BITS, qiov,
748 (int64_t) nb_sectors << BDRV_SECTOR_BITS, cb, opaque,
752 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH
753 static BlockAIOCB *qemu_rbd_aio_flush(BlockDriverState *bs,
754 BlockCompletionFunc *cb,
757 return rbd_start_aio(bs, 0, NULL, 0, cb, opaque, RBD_AIO_FLUSH);
762 static int qemu_rbd_co_flush(BlockDriverState *bs)
764 #if LIBRBD_VERSION_CODE >= LIBRBD_VERSION(0, 1, 1)
765 /* rbd_flush added in 0.1.1 */
766 BDRVRBDState *s = bs->opaque;
767 return rbd_flush(s->image);
774 static int qemu_rbd_getinfo(BlockDriverState *bs, BlockDriverInfo *bdi)
776 BDRVRBDState *s = bs->opaque;
777 rbd_image_info_t info;
780 r = rbd_stat(s->image, &info, sizeof(info));
785 bdi->cluster_size = info.obj_size;
789 static int64_t qemu_rbd_getlength(BlockDriverState *bs)
791 BDRVRBDState *s = bs->opaque;
792 rbd_image_info_t info;
795 r = rbd_stat(s->image, &info, sizeof(info));
803 static int qemu_rbd_truncate(BlockDriverState *bs, int64_t offset)
805 BDRVRBDState *s = bs->opaque;
808 r = rbd_resize(s->image, offset);
816 static int qemu_rbd_snap_create(BlockDriverState *bs,
817 QEMUSnapshotInfo *sn_info)
819 BDRVRBDState *s = bs->opaque;
822 if (sn_info->name[0] == '\0') {
823 return -EINVAL; /* we need a name for rbd snapshots */
827 * rbd snapshots are using the name as the user controlled unique identifier
828 * we can't use the rbd snapid for that purpose, as it can't be set
830 if (sn_info->id_str[0] != '\0' &&
831 strcmp(sn_info->id_str, sn_info->name) != 0) {
835 if (strlen(sn_info->name) >= sizeof(sn_info->id_str)) {
839 r = rbd_snap_create(s->image, sn_info->name);
841 error_report("failed to create snap: %s", strerror(-r));
848 static int qemu_rbd_snap_remove(BlockDriverState *bs,
849 const char *snapshot_id,
850 const char *snapshot_name,
853 BDRVRBDState *s = bs->opaque;
856 if (!snapshot_name) {
857 error_setg(errp, "rbd need a valid snapshot name");
861 /* If snapshot_id is specified, it must be equal to name, see
862 qemu_rbd_snap_list() */
863 if (snapshot_id && strcmp(snapshot_id, snapshot_name)) {
865 "rbd do not support snapshot id, it should be NULL or "
866 "equal to snapshot name");
870 r = rbd_snap_remove(s->image, snapshot_name);
872 error_setg_errno(errp, -r, "Failed to remove the snapshot");
877 static int qemu_rbd_snap_rollback(BlockDriverState *bs,
878 const char *snapshot_name)
880 BDRVRBDState *s = bs->opaque;
882 return rbd_snap_rollback(s->image, snapshot_name);
885 static int qemu_rbd_snap_list(BlockDriverState *bs,
886 QEMUSnapshotInfo **psn_tab)
888 BDRVRBDState *s = bs->opaque;
889 QEMUSnapshotInfo *sn_info, *sn_tab = NULL;
891 rbd_snap_info_t *snaps;
892 int max_snaps = RBD_MAX_SNAPS;
895 snaps = g_new(rbd_snap_info_t, max_snaps);
896 snap_count = rbd_snap_list(s->image, snaps, &max_snaps);
897 if (snap_count <= 0) {
900 } while (snap_count == -ERANGE);
902 if (snap_count <= 0) {
906 sn_tab = g_new0(QEMUSnapshotInfo, snap_count);
908 for (i = 0; i < snap_count; i++) {
909 const char *snap_name = snaps[i].name;
911 sn_info = sn_tab + i;
912 pstrcpy(sn_info->id_str, sizeof(sn_info->id_str), snap_name);
913 pstrcpy(sn_info->name, sizeof(sn_info->name), snap_name);
915 sn_info->vm_state_size = snaps[i].size;
916 sn_info->date_sec = 0;
917 sn_info->date_nsec = 0;
918 sn_info->vm_clock_nsec = 0;
920 rbd_snap_list_end(snaps);
928 #ifdef LIBRBD_SUPPORTS_DISCARD
929 static BlockAIOCB *qemu_rbd_aio_pdiscard(BlockDriverState *bs,
932 BlockCompletionFunc *cb,
935 return rbd_start_aio(bs, offset, NULL, count, cb, opaque,
940 #ifdef LIBRBD_SUPPORTS_INVALIDATE
941 static void qemu_rbd_invalidate_cache(BlockDriverState *bs,
944 BDRVRBDState *s = bs->opaque;
945 int r = rbd_invalidate_cache(s->image);
947 error_setg_errno(errp, -r, "Failed to invalidate the cache");
952 static QemuOptsList qemu_rbd_create_opts = {
953 .name = "rbd-create-opts",
954 .head = QTAILQ_HEAD_INITIALIZER(qemu_rbd_create_opts.head),
957 .name = BLOCK_OPT_SIZE,
958 .type = QEMU_OPT_SIZE,
959 .help = "Virtual disk size"
962 .name = BLOCK_OPT_CLUSTER_SIZE,
963 .type = QEMU_OPT_SIZE,
964 .help = "RBD object size"
967 .name = "password-secret",
968 .type = QEMU_OPT_STRING,
969 .help = "ID of secret providing the password",
971 { /* end of list */ }
975 static BlockDriver bdrv_rbd = {
976 .format_name = "rbd",
977 .instance_size = sizeof(BDRVRBDState),
978 .bdrv_needs_filename = true,
979 .bdrv_file_open = qemu_rbd_open,
980 .bdrv_close = qemu_rbd_close,
981 .bdrv_create = qemu_rbd_create,
982 .bdrv_has_zero_init = bdrv_has_zero_init_1,
983 .bdrv_get_info = qemu_rbd_getinfo,
984 .create_opts = &qemu_rbd_create_opts,
985 .bdrv_getlength = qemu_rbd_getlength,
986 .bdrv_truncate = qemu_rbd_truncate,
987 .protocol_name = "rbd",
989 .bdrv_aio_readv = qemu_rbd_aio_readv,
990 .bdrv_aio_writev = qemu_rbd_aio_writev,
992 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH
993 .bdrv_aio_flush = qemu_rbd_aio_flush,
995 .bdrv_co_flush_to_disk = qemu_rbd_co_flush,
998 #ifdef LIBRBD_SUPPORTS_DISCARD
999 .bdrv_aio_pdiscard = qemu_rbd_aio_pdiscard,
1002 .bdrv_snapshot_create = qemu_rbd_snap_create,
1003 .bdrv_snapshot_delete = qemu_rbd_snap_remove,
1004 .bdrv_snapshot_list = qemu_rbd_snap_list,
1005 .bdrv_snapshot_goto = qemu_rbd_snap_rollback,
1006 #ifdef LIBRBD_SUPPORTS_INVALIDATE
1007 .bdrv_invalidate_cache = qemu_rbd_invalidate_cache,
1011 static void bdrv_rbd_init(void)
1013 bdrv_register(&bdrv_rbd);
1016 block_init(bdrv_rbd_init);