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