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.
16 #include "qemu-common.h"
17 #include "qemu/error-report.h"
18 #include "block/block_int.h"
20 #include <rbd/librbd.h>
23 * When specifying the image filename use:
25 * rbd:poolname/devicename[@snapshotname][:option1=value1[:option2=value2...]]
27 * poolname must be the name of an existing rados pool.
29 * devicename is the name of the rbd image.
31 * Each option given is used to configure rados, and may be any valid
32 * Ceph option, "id", or "conf".
34 * The "id" option indicates what user we should authenticate as to
35 * the Ceph cluster. If it is excluded we will use the Ceph default
38 * The "conf" option specifies a Ceph configuration file to read. If
39 * it is not specified, we will read from the default Ceph locations
40 * (e.g., /etc/ceph/ceph.conf). To avoid reading _any_ configuration
41 * file, specify conf=/dev/null.
43 * Configuration values containing :, @, or = can be escaped with a
47 /* rbd_aio_discard added in 0.1.2 */
48 #if LIBRBD_VERSION_CODE >= LIBRBD_VERSION(0, 1, 2)
49 #define LIBRBD_SUPPORTS_DISCARD
51 #undef LIBRBD_SUPPORTS_DISCARD
54 #define OBJ_MAX_SIZE (1UL << OBJ_DEFAULT_OBJ_ORDER)
56 #define RBD_MAX_CONF_NAME_SIZE 128
57 #define RBD_MAX_CONF_VAL_SIZE 512
58 #define RBD_MAX_CONF_SIZE 1024
59 #define RBD_MAX_POOL_NAME_SIZE 128
60 #define RBD_MAX_SNAP_NAME_SIZE 128
61 #define RBD_MAX_SNAPS 100
70 typedef struct RBDAIOCB
{
71 BlockDriverAIOCB common
;
79 struct BDRVRBDState
*s
;
84 typedef struct RADOSCB
{
87 struct BDRVRBDState
*s
;
95 #define RBD_FD_WRITE 1
97 typedef struct BDRVRBDState
{
100 rados_ioctx_t io_ctx
;
102 char name
[RBD_MAX_IMAGE_NAME_SIZE
];
105 int event_reader_pos
;
109 static void rbd_aio_bh_cb(void *opaque
);
111 static int qemu_rbd_next_tok(char *dst
, int dst_len
,
112 char *src
, char delim
,
122 for (end
= src
; *end
; ++end
) {
126 if (*end
== '\\' && end
[1] != '\0') {
137 error_report("%s too long", name
);
140 error_report("%s too short", name
);
144 pstrcpy(dst
, dst_len
, src
);
149 static void qemu_rbd_unescape(char *src
)
153 for (p
= src
; *src
; ++src
, ++p
) {
154 if (*src
== '\\' && src
[1] != '\0') {
162 static int qemu_rbd_parsename(const char *filename
,
163 char *pool
, int pool_len
,
164 char *snap
, int snap_len
,
165 char *name
, int name_len
,
166 char *conf
, int conf_len
)
172 if (!strstart(filename
, "rbd:", &start
)) {
176 buf
= g_strdup(start
);
181 ret
= qemu_rbd_next_tok(pool
, pool_len
, p
, '/', "pool name", &p
);
186 qemu_rbd_unescape(pool
);
188 if (strchr(p
, '@')) {
189 ret
= qemu_rbd_next_tok(name
, name_len
, p
, '@', "object name", &p
);
193 ret
= qemu_rbd_next_tok(snap
, snap_len
, p
, ':', "snap name", &p
);
194 qemu_rbd_unescape(snap
);
196 ret
= qemu_rbd_next_tok(name
, name_len
, p
, ':', "object name", &p
);
198 qemu_rbd_unescape(name
);
203 ret
= qemu_rbd_next_tok(conf
, conf_len
, p
, '\0', "configuration", &p
);
210 static char *qemu_rbd_parse_clientname(const char *conf
, char *clientname
)
212 const char *p
= conf
;
216 const char *end
= strchr(p
, ':');
224 if (strncmp(p
, "id=", 3) == 0) {
226 strncpy(clientname
, p
+ 3, len
);
227 clientname
[len
] = '\0';
238 static int qemu_rbd_set_conf(rados_t cluster
, const char *conf
)
241 char name
[RBD_MAX_CONF_NAME_SIZE
];
242 char value
[RBD_MAX_CONF_VAL_SIZE
];
245 buf
= g_strdup(conf
);
249 ret
= qemu_rbd_next_tok(name
, sizeof(name
), p
,
250 '=', "conf option name", &p
);
254 qemu_rbd_unescape(name
);
257 error_report("conf option %s has no value", name
);
262 ret
= qemu_rbd_next_tok(value
, sizeof(value
), p
,
263 ':', "conf option value", &p
);
267 qemu_rbd_unescape(value
);
269 if (strcmp(name
, "conf") == 0) {
270 ret
= rados_conf_read_file(cluster
, value
);
272 error_report("error reading conf file %s", value
);
275 } else if (strcmp(name
, "id") == 0) {
276 /* ignore, this is parsed by qemu_rbd_parse_clientname() */
278 ret
= rados_conf_set(cluster
, name
, value
);
280 error_report("invalid conf option %s", name
);
291 static int qemu_rbd_create(const char *filename
, QEMUOptionParameter
*options
)
296 char pool
[RBD_MAX_POOL_NAME_SIZE
];
297 char name
[RBD_MAX_IMAGE_NAME_SIZE
];
298 char snap_buf
[RBD_MAX_SNAP_NAME_SIZE
];
299 char conf
[RBD_MAX_CONF_SIZE
];
300 char clientname_buf
[RBD_MAX_CONF_SIZE
];
303 rados_ioctx_t io_ctx
;
306 if (qemu_rbd_parsename(filename
, pool
, sizeof(pool
),
307 snap_buf
, sizeof(snap_buf
),
309 conf
, sizeof(conf
)) < 0) {
313 /* Read out options */
314 while (options
&& options
->name
) {
315 if (!strcmp(options
->name
, BLOCK_OPT_SIZE
)) {
316 bytes
= options
->value
.n
;
317 } else if (!strcmp(options
->name
, BLOCK_OPT_CLUSTER_SIZE
)) {
318 if (options
->value
.n
) {
319 objsize
= options
->value
.n
;
320 if ((objsize
- 1) & objsize
) { /* not a power of 2? */
321 error_report("obj size needs to be power of 2");
324 if (objsize
< 4096) {
325 error_report("obj size too small");
328 obj_order
= ffs(objsize
) - 1;
334 clientname
= qemu_rbd_parse_clientname(conf
, clientname_buf
);
335 if (rados_create(&cluster
, clientname
) < 0) {
336 error_report("error initializing");
340 if (strstr(conf
, "conf=") == NULL
) {
341 /* try default location, but ignore failure */
342 rados_conf_read_file(cluster
, NULL
);
345 if (conf
[0] != '\0' &&
346 qemu_rbd_set_conf(cluster
, conf
) < 0) {
347 error_report("error setting config options");
348 rados_shutdown(cluster
);
352 if (rados_connect(cluster
) < 0) {
353 error_report("error connecting");
354 rados_shutdown(cluster
);
358 if (rados_ioctx_create(cluster
, pool
, &io_ctx
) < 0) {
359 error_report("error opening pool %s", pool
);
360 rados_shutdown(cluster
);
364 ret
= rbd_create(io_ctx
, name
, bytes
, &obj_order
);
365 rados_ioctx_destroy(io_ctx
);
366 rados_shutdown(cluster
);
372 * This aio completion is being called from qemu_rbd_aio_event_reader()
373 * and runs in qemu context. It schedules a bh, but just in case the aio
374 * was not cancelled before.
376 static void qemu_rbd_complete_aio(RADOSCB
*rcb
)
378 RBDAIOCB
*acb
= rcb
->acb
;
383 if (acb
->cmd
!= RBD_AIO_READ
) {
387 } else if (!acb
->error
) {
388 acb
->ret
= rcb
->size
;
392 memset(rcb
->buf
, 0, rcb
->size
);
395 } else if (r
< rcb
->size
) {
396 memset(rcb
->buf
+ r
, 0, rcb
->size
- r
);
398 acb
->ret
= rcb
->size
;
400 } else if (!acb
->error
) {
404 /* Note that acb->bh can be NULL in case where the aio was cancelled */
405 acb
->bh
= qemu_bh_new(rbd_aio_bh_cb
, acb
);
406 qemu_bh_schedule(acb
->bh
);
411 * aio fd read handler. It runs in the qemu context and calls the
412 * completion handling of completed rados aio operations.
414 static void qemu_rbd_aio_event_reader(void *opaque
)
416 BDRVRBDState
*s
= opaque
;
421 char *p
= (char *)&s
->event_rcb
;
423 /* now read the rcb pointer that was sent from a non qemu thread */
424 ret
= read(s
->fds
[RBD_FD_READ
], p
+ s
->event_reader_pos
,
425 sizeof(s
->event_rcb
) - s
->event_reader_pos
);
427 s
->event_reader_pos
+= ret
;
428 if (s
->event_reader_pos
== sizeof(s
->event_rcb
)) {
429 s
->event_reader_pos
= 0;
430 qemu_rbd_complete_aio(s
->event_rcb
);
434 } while (ret
< 0 && errno
== EINTR
);
437 static int qemu_rbd_aio_flush_cb(void *opaque
)
439 BDRVRBDState
*s
= opaque
;
441 return (s
->qemu_aio_count
> 0);
444 static int qemu_rbd_open(BlockDriverState
*bs
, const char *filename
,
445 QDict
*options
, int flags
)
447 BDRVRBDState
*s
= bs
->opaque
;
448 char pool
[RBD_MAX_POOL_NAME_SIZE
];
449 char snap_buf
[RBD_MAX_SNAP_NAME_SIZE
];
450 char conf
[RBD_MAX_CONF_SIZE
];
451 char clientname_buf
[RBD_MAX_CONF_SIZE
];
455 if (qemu_rbd_parsename(filename
, pool
, sizeof(pool
),
456 snap_buf
, sizeof(snap_buf
),
457 s
->name
, sizeof(s
->name
),
458 conf
, sizeof(conf
)) < 0) {
462 clientname
= qemu_rbd_parse_clientname(conf
, clientname_buf
);
463 r
= rados_create(&s
->cluster
, clientname
);
465 error_report("error initializing");
470 if (snap_buf
[0] != '\0') {
471 s
->snap
= g_strdup(snap_buf
);
475 * Fallback to more conservative semantics if setting cache
476 * options fails. Ignore errors from setting rbd_cache because the
477 * only possible error is that the option does not exist, and
478 * librbd defaults to no caching. If write through caching cannot
479 * be set up, fall back to no caching.
481 if (flags
& BDRV_O_NOCACHE
) {
482 rados_conf_set(s
->cluster
, "rbd_cache", "false");
484 rados_conf_set(s
->cluster
, "rbd_cache", "true");
487 if (strstr(conf
, "conf=") == NULL
) {
488 /* try default location, but ignore failure */
489 rados_conf_read_file(s
->cluster
, NULL
);
492 if (conf
[0] != '\0') {
493 r
= qemu_rbd_set_conf(s
->cluster
, conf
);
495 error_report("error setting config options");
496 goto failed_shutdown
;
500 r
= rados_connect(s
->cluster
);
502 error_report("error connecting");
503 goto failed_shutdown
;
506 r
= rados_ioctx_create(s
->cluster
, pool
, &s
->io_ctx
);
508 error_report("error opening pool %s", pool
);
509 goto failed_shutdown
;
512 r
= rbd_open(s
->io_ctx
, s
->name
, &s
->image
, s
->snap
);
514 error_report("error reading header from %s", s
->name
);
518 bs
->read_only
= (s
->snap
!= NULL
);
520 s
->event_reader_pos
= 0;
521 r
= qemu_pipe(s
->fds
);
523 error_report("error opening eventfd");
526 fcntl(s
->fds
[0], F_SETFL
, O_NONBLOCK
);
527 fcntl(s
->fds
[1], F_SETFL
, O_NONBLOCK
);
528 qemu_aio_set_fd_handler(s
->fds
[RBD_FD_READ
], qemu_rbd_aio_event_reader
,
529 NULL
, qemu_rbd_aio_flush_cb
, s
);
537 rados_ioctx_destroy(s
->io_ctx
);
539 rados_shutdown(s
->cluster
);
544 static void qemu_rbd_close(BlockDriverState
*bs
)
546 BDRVRBDState
*s
= bs
->opaque
;
550 qemu_aio_set_fd_handler(s
->fds
[RBD_FD_READ
], NULL
, NULL
, NULL
, NULL
);
553 rados_ioctx_destroy(s
->io_ctx
);
555 rados_shutdown(s
->cluster
);
559 * Cancel aio. Since we don't reference acb in a non qemu threads,
560 * it is safe to access it here.
562 static void qemu_rbd_aio_cancel(BlockDriverAIOCB
*blockacb
)
564 RBDAIOCB
*acb
= (RBDAIOCB
*) blockacb
;
567 while (acb
->status
== -EINPROGRESS
) {
571 qemu_aio_release(acb
);
574 static const AIOCBInfo rbd_aiocb_info
= {
575 .aiocb_size
= sizeof(RBDAIOCB
),
576 .cancel
= qemu_rbd_aio_cancel
,
579 static int qemu_rbd_send_pipe(BDRVRBDState
*s
, RADOSCB
*rcb
)
584 int fd
= s
->fds
[RBD_FD_WRITE
];
586 /* send the op pointer to the qemu thread that is responsible
587 for the aio/op completion. Must do it in a qemu thread context */
588 ret
= write(fd
, (void *)&rcb
, sizeof(rcb
));
592 if (errno
== EINTR
) {
595 if (errno
!= EAGAIN
) {
602 ret
= select(fd
+ 1, NULL
, &wfd
, NULL
, NULL
);
603 } while (ret
< 0 && errno
== EINTR
);
610 * This is the callback function for rbd_aio_read and _write
612 * Note: this function is being called from a non qemu thread so
613 * we need to be careful about what we do here. Generally we only
614 * write to the block notification pipe, and do the rest of the
615 * io completion handling from qemu_rbd_aio_event_reader() which
616 * runs in a qemu context.
618 static void rbd_finish_aiocb(rbd_completion_t c
, RADOSCB
*rcb
)
621 rcb
->ret
= rbd_aio_get_return_value(c
);
623 ret
= qemu_rbd_send_pipe(rcb
->s
, rcb
);
625 error_report("failed writing to acb->s->fds");
630 /* Callback when all queued rbd_aio requests are complete */
632 static void rbd_aio_bh_cb(void *opaque
)
634 RBDAIOCB
*acb
= opaque
;
636 if (acb
->cmd
== RBD_AIO_READ
) {
637 qemu_iovec_from_buf(acb
->qiov
, 0, acb
->bounce
, acb
->qiov
->size
);
639 qemu_vfree(acb
->bounce
);
640 acb
->common
.cb(acb
->common
.opaque
, (acb
->ret
> 0 ? 0 : acb
->ret
));
641 qemu_bh_delete(acb
->bh
);
645 if (!acb
->cancelled
) {
646 qemu_aio_release(acb
);
650 static int rbd_aio_discard_wrapper(rbd_image_t image
,
653 rbd_completion_t comp
)
655 #ifdef LIBRBD_SUPPORTS_DISCARD
656 return rbd_aio_discard(image
, off
, len
, comp
);
662 static int rbd_aio_flush_wrapper(rbd_image_t image
,
663 rbd_completion_t comp
)
665 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH
666 return rbd_aio_flush(image
, comp
);
672 static BlockDriverAIOCB
*rbd_start_aio(BlockDriverState
*bs
,
676 BlockDriverCompletionFunc
*cb
,
687 BDRVRBDState
*s
= bs
->opaque
;
689 acb
= qemu_aio_get(&rbd_aiocb_info
, bs
, cb
, opaque
);
692 if (cmd
== RBD_AIO_DISCARD
|| cmd
== RBD_AIO_FLUSH
) {
695 acb
->bounce
= qemu_blockalign(bs
, qiov
->size
);
702 acb
->status
= -EINPROGRESS
;
704 if (cmd
== RBD_AIO_WRITE
) {
705 qemu_iovec_to_buf(acb
->qiov
, 0, acb
->bounce
, qiov
->size
);
710 off
= sector_num
* BDRV_SECTOR_SIZE
;
711 size
= nb_sectors
* BDRV_SECTOR_SIZE
;
713 s
->qemu_aio_count
++; /* All the RADOSCB */
715 rcb
= g_malloc(sizeof(RADOSCB
));
721 r
= rbd_aio_create_completion(rcb
, (rbd_callback_t
) rbd_finish_aiocb
, &c
);
728 r
= rbd_aio_write(s
->image
, off
, size
, buf
, c
);
731 r
= rbd_aio_read(s
->image
, off
, size
, buf
, c
);
733 case RBD_AIO_DISCARD
:
734 r
= rbd_aio_discard_wrapper(s
->image
, off
, size
, c
);
737 r
= rbd_aio_flush_wrapper(s
->image
, c
);
752 qemu_aio_release(acb
);
756 static BlockDriverAIOCB
*qemu_rbd_aio_readv(BlockDriverState
*bs
,
760 BlockDriverCompletionFunc
*cb
,
763 return rbd_start_aio(bs
, sector_num
, qiov
, nb_sectors
, cb
, opaque
,
767 static BlockDriverAIOCB
*qemu_rbd_aio_writev(BlockDriverState
*bs
,
771 BlockDriverCompletionFunc
*cb
,
774 return rbd_start_aio(bs
, sector_num
, qiov
, nb_sectors
, cb
, opaque
,
778 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH
779 static BlockDriverAIOCB
*qemu_rbd_aio_flush(BlockDriverState
*bs
,
780 BlockDriverCompletionFunc
*cb
,
783 return rbd_start_aio(bs
, 0, NULL
, 0, cb
, opaque
, RBD_AIO_FLUSH
);
788 static int qemu_rbd_co_flush(BlockDriverState
*bs
)
790 #if LIBRBD_VERSION_CODE >= LIBRBD_VERSION(0, 1, 1)
791 /* rbd_flush added in 0.1.1 */
792 BDRVRBDState
*s
= bs
->opaque
;
793 return rbd_flush(s
->image
);
800 static int qemu_rbd_getinfo(BlockDriverState
*bs
, BlockDriverInfo
*bdi
)
802 BDRVRBDState
*s
= bs
->opaque
;
803 rbd_image_info_t info
;
806 r
= rbd_stat(s
->image
, &info
, sizeof(info
));
811 bdi
->cluster_size
= info
.obj_size
;
815 static int64_t qemu_rbd_getlength(BlockDriverState
*bs
)
817 BDRVRBDState
*s
= bs
->opaque
;
818 rbd_image_info_t info
;
821 r
= rbd_stat(s
->image
, &info
, sizeof(info
));
829 static int qemu_rbd_truncate(BlockDriverState
*bs
, int64_t offset
)
831 BDRVRBDState
*s
= bs
->opaque
;
834 r
= rbd_resize(s
->image
, offset
);
842 static int qemu_rbd_snap_create(BlockDriverState
*bs
,
843 QEMUSnapshotInfo
*sn_info
)
845 BDRVRBDState
*s
= bs
->opaque
;
848 if (sn_info
->name
[0] == '\0') {
849 return -EINVAL
; /* we need a name for rbd snapshots */
853 * rbd snapshots are using the name as the user controlled unique identifier
854 * we can't use the rbd snapid for that purpose, as it can't be set
856 if (sn_info
->id_str
[0] != '\0' &&
857 strcmp(sn_info
->id_str
, sn_info
->name
) != 0) {
861 if (strlen(sn_info
->name
) >= sizeof(sn_info
->id_str
)) {
865 r
= rbd_snap_create(s
->image
, sn_info
->name
);
867 error_report("failed to create snap: %s", strerror(-r
));
874 static int qemu_rbd_snap_remove(BlockDriverState
*bs
,
875 const char *snapshot_name
)
877 BDRVRBDState
*s
= bs
->opaque
;
880 r
= rbd_snap_remove(s
->image
, snapshot_name
);
884 static int qemu_rbd_snap_rollback(BlockDriverState
*bs
,
885 const char *snapshot_name
)
887 BDRVRBDState
*s
= bs
->opaque
;
890 r
= rbd_snap_rollback(s
->image
, snapshot_name
);
894 static int qemu_rbd_snap_list(BlockDriverState
*bs
,
895 QEMUSnapshotInfo
**psn_tab
)
897 BDRVRBDState
*s
= bs
->opaque
;
898 QEMUSnapshotInfo
*sn_info
, *sn_tab
= NULL
;
900 rbd_snap_info_t
*snaps
;
901 int max_snaps
= RBD_MAX_SNAPS
;
904 snaps
= g_malloc(sizeof(*snaps
) * max_snaps
);
905 snap_count
= rbd_snap_list(s
->image
, snaps
, &max_snaps
);
906 if (snap_count
< 0) {
909 } while (snap_count
== -ERANGE
);
911 if (snap_count
<= 0) {
915 sn_tab
= g_malloc0(snap_count
* sizeof(QEMUSnapshotInfo
));
917 for (i
= 0; i
< snap_count
; i
++) {
918 const char *snap_name
= snaps
[i
].name
;
920 sn_info
= sn_tab
+ i
;
921 pstrcpy(sn_info
->id_str
, sizeof(sn_info
->id_str
), snap_name
);
922 pstrcpy(sn_info
->name
, sizeof(sn_info
->name
), snap_name
);
924 sn_info
->vm_state_size
= snaps
[i
].size
;
925 sn_info
->date_sec
= 0;
926 sn_info
->date_nsec
= 0;
927 sn_info
->vm_clock_nsec
= 0;
929 rbd_snap_list_end(snaps
);
936 #ifdef LIBRBD_SUPPORTS_DISCARD
937 static BlockDriverAIOCB
* qemu_rbd_aio_discard(BlockDriverState
*bs
,
940 BlockDriverCompletionFunc
*cb
,
943 return rbd_start_aio(bs
, sector_num
, NULL
, nb_sectors
, cb
, opaque
,
948 static QEMUOptionParameter qemu_rbd_create_options
[] = {
950 .name
= BLOCK_OPT_SIZE
,
952 .help
= "Virtual disk size"
955 .name
= BLOCK_OPT_CLUSTER_SIZE
,
957 .help
= "RBD object size"
962 static BlockDriver bdrv_rbd
= {
963 .format_name
= "rbd",
964 .instance_size
= sizeof(BDRVRBDState
),
965 .bdrv_file_open
= qemu_rbd_open
,
966 .bdrv_close
= qemu_rbd_close
,
967 .bdrv_create
= qemu_rbd_create
,
968 .bdrv_get_info
= qemu_rbd_getinfo
,
969 .create_options
= qemu_rbd_create_options
,
970 .bdrv_getlength
= qemu_rbd_getlength
,
971 .bdrv_truncate
= qemu_rbd_truncate
,
972 .protocol_name
= "rbd",
974 .bdrv_aio_readv
= qemu_rbd_aio_readv
,
975 .bdrv_aio_writev
= qemu_rbd_aio_writev
,
977 #ifdef LIBRBD_SUPPORTS_AIO_FLUSH
978 .bdrv_aio_flush
= qemu_rbd_aio_flush
,
980 .bdrv_co_flush_to_disk
= qemu_rbd_co_flush
,
983 #ifdef LIBRBD_SUPPORTS_DISCARD
984 .bdrv_aio_discard
= qemu_rbd_aio_discard
,
987 .bdrv_snapshot_create
= qemu_rbd_snap_create
,
988 .bdrv_snapshot_delete
= qemu_rbd_snap_remove
,
989 .bdrv_snapshot_list
= qemu_rbd_snap_list
,
990 .bdrv_snapshot_goto
= qemu_rbd_snap_rollback
,
993 static void bdrv_rbd_init(void)
995 bdrv_register(&bdrv_rbd
);
998 block_init(bdrv_rbd_init
);