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