3 rbd.c -- Export ceph rados objects as a Linux block device
6 based on drivers/block/osdblk.c:
8 Copyright 2009 Red Hat, Inc.
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; see the file COPYING. If not, write to
21 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
25 For usage instructions, please refer to:
27 Documentation/ABI/testing/sysfs-bus-rbd
31 #include <linux/ceph/libceph.h>
32 #include <linux/ceph/osd_client.h>
33 #include <linux/ceph/mon_client.h>
34 #include <linux/ceph/cls_lock_client.h>
35 #include <linux/ceph/decode.h>
36 #include <linux/parser.h>
37 #include <linux/bsearch.h>
39 #include <linux/kernel.h>
40 #include <linux/device.h>
41 #include <linux/module.h>
42 #include <linux/blk-mq.h>
44 #include <linux/blkdev.h>
45 #include <linux/slab.h>
46 #include <linux/idr.h>
47 #include <linux/workqueue.h>
49 #include "rbd_types.h"
51 #define RBD_DEBUG /* Activate rbd_assert() calls */
54 * The basic unit of block I/O is a sector. It is interpreted in a
55 * number of contexts in Linux (blk, bio, genhd), but the default is
56 * universally 512 bytes. These symbols are just slightly more
57 * meaningful than the bare numbers they represent.
59 #define SECTOR_SHIFT 9
60 #define SECTOR_SIZE (1ULL << SECTOR_SHIFT)
63 * Increment the given counter and return its updated value.
64 * If the counter is already 0 it will not be incremented.
65 * If the counter is already at its maximum value returns
66 * -EINVAL without updating it.
68 static int atomic_inc_return_safe(atomic_t *v)
72 counter = (unsigned int)__atomic_add_unless(v, 1, 0);
73 if (counter <= (unsigned int)INT_MAX)
81 /* Decrement the counter. Return the resulting value, or -EINVAL */
82 static int atomic_dec_return_safe(atomic_t *v)
86 counter = atomic_dec_return(v);
95 #define RBD_DRV_NAME "rbd"
97 #define RBD_MINORS_PER_MAJOR 256
98 #define RBD_SINGLE_MAJOR_PART_SHIFT 4
100 #define RBD_MAX_PARENT_CHAIN_LEN 16
102 #define RBD_SNAP_DEV_NAME_PREFIX "snap_"
103 #define RBD_MAX_SNAP_NAME_LEN \
104 (NAME_MAX - (sizeof (RBD_SNAP_DEV_NAME_PREFIX) - 1))
106 #define RBD_MAX_SNAP_COUNT 510 /* allows max snapc to fit in 4KB */
108 #define RBD_SNAP_HEAD_NAME "-"
110 #define BAD_SNAP_INDEX U32_MAX /* invalid index into snap array */
112 /* This allows a single page to hold an image name sent by OSD */
113 #define RBD_IMAGE_NAME_LEN_MAX (PAGE_SIZE - sizeof (__le32) - 1)
114 #define RBD_IMAGE_ID_LEN_MAX 64
116 #define RBD_OBJ_PREFIX_LEN_MAX 64
118 #define RBD_NOTIFY_TIMEOUT 5 /* seconds */
119 #define RBD_RETRY_DELAY msecs_to_jiffies(1000)
123 #define RBD_FEATURE_LAYERING (1<<0)
124 #define RBD_FEATURE_STRIPINGV2 (1<<1)
125 #define RBD_FEATURE_EXCLUSIVE_LOCK (1<<2)
126 #define RBD_FEATURES_ALL (RBD_FEATURE_LAYERING | \
127 RBD_FEATURE_STRIPINGV2 | \
128 RBD_FEATURE_EXCLUSIVE_LOCK)
130 /* Features supported by this (client software) implementation. */
132 #define RBD_FEATURES_SUPPORTED (RBD_FEATURES_ALL)
135 * An RBD device name will be "rbd#", where the "rbd" comes from
136 * RBD_DRV_NAME above, and # is a unique integer identifier.
138 #define DEV_NAME_LEN 32
141 * block device image metadata (in-memory version)
143 struct rbd_image_header {
144 /* These six fields never change for a given rbd image */
151 u64 features; /* Might be changeable someday? */
153 /* The remaining fields need to be updated occasionally */
155 struct ceph_snap_context *snapc;
156 char *snap_names; /* format 1 only */
157 u64 *snap_sizes; /* format 1 only */
161 * An rbd image specification.
163 * The tuple (pool_id, image_id, snap_id) is sufficient to uniquely
164 * identify an image. Each rbd_dev structure includes a pointer to
165 * an rbd_spec structure that encapsulates this identity.
167 * Each of the id's in an rbd_spec has an associated name. For a
168 * user-mapped image, the names are supplied and the id's associated
169 * with them are looked up. For a layered image, a parent image is
170 * defined by the tuple, and the names are looked up.
172 * An rbd_dev structure contains a parent_spec pointer which is
173 * non-null if the image it represents is a child in a layered
174 * image. This pointer will refer to the rbd_spec structure used
175 * by the parent rbd_dev for its own identity (i.e., the structure
176 * is shared between the parent and child).
178 * Since these structures are populated once, during the discovery
179 * phase of image construction, they are effectively immutable so
180 * we make no effort to synchronize access to them.
182 * Note that code herein does not assume the image name is known (it
183 * could be a null pointer).
187 const char *pool_name;
189 const char *image_id;
190 const char *image_name;
193 const char *snap_name;
199 * an instance of the client. multiple devices may share an rbd client.
202 struct ceph_client *client;
204 struct list_head node;
207 struct rbd_img_request;
208 typedef void (*rbd_img_callback_t)(struct rbd_img_request *);
210 #define BAD_WHICH U32_MAX /* Good which or bad which, which? */
212 struct rbd_obj_request;
213 typedef void (*rbd_obj_callback_t)(struct rbd_obj_request *);
215 enum obj_request_type {
216 OBJ_REQUEST_NODATA, OBJ_REQUEST_BIO, OBJ_REQUEST_PAGES
219 enum obj_operation_type {
226 OBJ_REQ_DONE, /* completion flag: not done = 0, done = 1 */
227 OBJ_REQ_IMG_DATA, /* object usage: standalone = 0, image = 1 */
228 OBJ_REQ_KNOWN, /* EXISTS flag valid: no = 0, yes = 1 */
229 OBJ_REQ_EXISTS, /* target exists: no = 0, yes = 1 */
232 struct rbd_obj_request {
233 const char *object_name;
234 u64 offset; /* object start byte */
235 u64 length; /* bytes from offset */
239 * An object request associated with an image will have its
240 * img_data flag set; a standalone object request will not.
242 * A standalone object request will have which == BAD_WHICH
243 * and a null obj_request pointer.
245 * An object request initiated in support of a layered image
246 * object (to check for its existence before a write) will
247 * have which == BAD_WHICH and a non-null obj_request pointer.
249 * Finally, an object request for rbd image data will have
250 * which != BAD_WHICH, and will have a non-null img_request
251 * pointer. The value of which will be in the range
252 * 0..(img_request->obj_request_count-1).
255 struct rbd_obj_request *obj_request; /* STAT op */
257 struct rbd_img_request *img_request;
259 /* links for img_request->obj_requests list */
260 struct list_head links;
263 u32 which; /* posn image request list */
265 enum obj_request_type type;
267 struct bio *bio_list;
273 struct page **copyup_pages;
274 u32 copyup_page_count;
276 struct ceph_osd_request *osd_req;
278 u64 xferred; /* bytes transferred */
281 rbd_obj_callback_t callback;
282 struct completion completion;
288 IMG_REQ_WRITE, /* I/O direction: read = 0, write = 1 */
289 IMG_REQ_CHILD, /* initiator: block = 0, child image = 1 */
290 IMG_REQ_LAYERED, /* ENOENT handling: normal = 0, layered = 1 */
291 IMG_REQ_DISCARD, /* discard: normal = 0, discard request = 1 */
294 struct rbd_img_request {
295 struct rbd_device *rbd_dev;
296 u64 offset; /* starting image byte offset */
297 u64 length; /* byte count from offset */
300 u64 snap_id; /* for reads */
301 struct ceph_snap_context *snapc; /* for writes */
304 struct request *rq; /* block request */
305 struct rbd_obj_request *obj_request; /* obj req initiator */
307 struct page **copyup_pages;
308 u32 copyup_page_count;
309 spinlock_t completion_lock;/* protects next_completion */
311 rbd_img_callback_t callback;
312 u64 xferred;/* aggregate bytes transferred */
313 int result; /* first nonzero obj_request result */
315 u32 obj_request_count;
316 struct list_head obj_requests; /* rbd_obj_request structs */
321 #define for_each_obj_request(ireq, oreq) \
322 list_for_each_entry(oreq, &(ireq)->obj_requests, links)
323 #define for_each_obj_request_from(ireq, oreq) \
324 list_for_each_entry_from(oreq, &(ireq)->obj_requests, links)
325 #define for_each_obj_request_safe(ireq, oreq, n) \
326 list_for_each_entry_safe_reverse(oreq, n, &(ireq)->obj_requests, links)
328 enum rbd_watch_state {
329 RBD_WATCH_STATE_UNREGISTERED,
330 RBD_WATCH_STATE_REGISTERED,
331 RBD_WATCH_STATE_ERROR,
334 enum rbd_lock_state {
335 RBD_LOCK_STATE_UNLOCKED,
336 RBD_LOCK_STATE_LOCKED,
337 RBD_LOCK_STATE_RELEASING,
340 /* WatchNotify::ClientId */
341 struct rbd_client_id {
356 int dev_id; /* blkdev unique id */
358 int major; /* blkdev assigned major */
360 struct gendisk *disk; /* blkdev's gendisk and rq */
362 u32 image_format; /* Either 1 or 2 */
363 struct rbd_client *rbd_client;
365 char name[DEV_NAME_LEN]; /* blkdev name, e.g. rbd3 */
367 spinlock_t lock; /* queue, flags, open_count */
369 struct rbd_image_header header;
370 unsigned long flags; /* possibly lock protected */
371 struct rbd_spec *spec;
372 struct rbd_options *opts;
373 char *config_info; /* add{,_single_major} string */
375 struct ceph_object_id header_oid;
376 struct ceph_object_locator header_oloc;
378 struct ceph_file_layout layout; /* used for all rbd requests */
380 struct mutex watch_mutex;
381 enum rbd_watch_state watch_state;
382 struct ceph_osd_linger_request *watch_handle;
384 struct delayed_work watch_dwork;
386 struct rw_semaphore lock_rwsem;
387 enum rbd_lock_state lock_state;
388 struct rbd_client_id owner_cid;
389 struct work_struct acquired_lock_work;
390 struct work_struct released_lock_work;
391 struct delayed_work lock_dwork;
392 struct work_struct unlock_work;
393 wait_queue_head_t lock_waitq;
395 struct workqueue_struct *task_wq;
397 struct rbd_spec *parent_spec;
400 struct rbd_device *parent;
402 /* Block layer tags. */
403 struct blk_mq_tag_set tag_set;
405 /* protects updating the header */
406 struct rw_semaphore header_rwsem;
408 struct rbd_mapping mapping;
410 struct list_head node;
414 unsigned long open_count; /* protected by lock */
418 * Flag bits for rbd_dev->flags. If atomicity is required,
419 * rbd_dev->lock is used to protect access.
421 * Currently, only the "removing" flag (which is coupled with the
422 * "open_count" field) requires atomic access.
425 RBD_DEV_FLAG_EXISTS, /* mapped snapshot has not been deleted */
426 RBD_DEV_FLAG_REMOVING, /* this mapping is being removed */
429 static DEFINE_MUTEX(client_mutex); /* Serialize client creation */
431 static LIST_HEAD(rbd_dev_list); /* devices */
432 static DEFINE_SPINLOCK(rbd_dev_list_lock);
434 static LIST_HEAD(rbd_client_list); /* clients */
435 static DEFINE_SPINLOCK(rbd_client_list_lock);
437 /* Slab caches for frequently-allocated structures */
439 static struct kmem_cache *rbd_img_request_cache;
440 static struct kmem_cache *rbd_obj_request_cache;
441 static struct kmem_cache *rbd_segment_name_cache;
443 static int rbd_major;
444 static DEFINE_IDA(rbd_dev_id_ida);
446 static struct workqueue_struct *rbd_wq;
449 * Default to false for now, as single-major requires >= 0.75 version of
450 * userspace rbd utility.
452 static bool single_major = false;
453 module_param(single_major, bool, S_IRUGO);
454 MODULE_PARM_DESC(single_major, "Use a single major number for all rbd devices (default: false)");
456 static int rbd_img_request_submit(struct rbd_img_request *img_request);
458 static ssize_t rbd_add(struct bus_type *bus, const char *buf,
460 static ssize_t rbd_remove(struct bus_type *bus, const char *buf,
462 static ssize_t rbd_add_single_major(struct bus_type *bus, const char *buf,
464 static ssize_t rbd_remove_single_major(struct bus_type *bus, const char *buf,
466 static int rbd_dev_image_probe(struct rbd_device *rbd_dev, int depth);
467 static void rbd_spec_put(struct rbd_spec *spec);
469 static int rbd_dev_id_to_minor(int dev_id)
471 return dev_id << RBD_SINGLE_MAJOR_PART_SHIFT;
474 static int minor_to_rbd_dev_id(int minor)
476 return minor >> RBD_SINGLE_MAJOR_PART_SHIFT;
479 static bool rbd_is_lock_supported(struct rbd_device *rbd_dev)
481 return (rbd_dev->header.features & RBD_FEATURE_EXCLUSIVE_LOCK) &&
482 rbd_dev->spec->snap_id == CEPH_NOSNAP &&
483 !rbd_dev->mapping.read_only;
486 static bool __rbd_is_lock_owner(struct rbd_device *rbd_dev)
488 return rbd_dev->lock_state == RBD_LOCK_STATE_LOCKED ||
489 rbd_dev->lock_state == RBD_LOCK_STATE_RELEASING;
492 static bool rbd_is_lock_owner(struct rbd_device *rbd_dev)
496 down_read(&rbd_dev->lock_rwsem);
497 is_lock_owner = __rbd_is_lock_owner(rbd_dev);
498 up_read(&rbd_dev->lock_rwsem);
499 return is_lock_owner;
502 static BUS_ATTR(add, S_IWUSR, NULL, rbd_add);
503 static BUS_ATTR(remove, S_IWUSR, NULL, rbd_remove);
504 static BUS_ATTR(add_single_major, S_IWUSR, NULL, rbd_add_single_major);
505 static BUS_ATTR(remove_single_major, S_IWUSR, NULL, rbd_remove_single_major);
507 static struct attribute *rbd_bus_attrs[] = {
509 &bus_attr_remove.attr,
510 &bus_attr_add_single_major.attr,
511 &bus_attr_remove_single_major.attr,
515 static umode_t rbd_bus_is_visible(struct kobject *kobj,
516 struct attribute *attr, int index)
519 (attr == &bus_attr_add_single_major.attr ||
520 attr == &bus_attr_remove_single_major.attr))
526 static const struct attribute_group rbd_bus_group = {
527 .attrs = rbd_bus_attrs,
528 .is_visible = rbd_bus_is_visible,
530 __ATTRIBUTE_GROUPS(rbd_bus);
532 static struct bus_type rbd_bus_type = {
534 .bus_groups = rbd_bus_groups,
537 static void rbd_root_dev_release(struct device *dev)
541 static struct device rbd_root_dev = {
543 .release = rbd_root_dev_release,
546 static __printf(2, 3)
547 void rbd_warn(struct rbd_device *rbd_dev, const char *fmt, ...)
549 struct va_format vaf;
557 printk(KERN_WARNING "%s: %pV\n", RBD_DRV_NAME, &vaf);
558 else if (rbd_dev->disk)
559 printk(KERN_WARNING "%s: %s: %pV\n",
560 RBD_DRV_NAME, rbd_dev->disk->disk_name, &vaf);
561 else if (rbd_dev->spec && rbd_dev->spec->image_name)
562 printk(KERN_WARNING "%s: image %s: %pV\n",
563 RBD_DRV_NAME, rbd_dev->spec->image_name, &vaf);
564 else if (rbd_dev->spec && rbd_dev->spec->image_id)
565 printk(KERN_WARNING "%s: id %s: %pV\n",
566 RBD_DRV_NAME, rbd_dev->spec->image_id, &vaf);
568 printk(KERN_WARNING "%s: rbd_dev %p: %pV\n",
569 RBD_DRV_NAME, rbd_dev, &vaf);
574 #define rbd_assert(expr) \
575 if (unlikely(!(expr))) { \
576 printk(KERN_ERR "\nAssertion failure in %s() " \
578 "\trbd_assert(%s);\n\n", \
579 __func__, __LINE__, #expr); \
582 #else /* !RBD_DEBUG */
583 # define rbd_assert(expr) ((void) 0)
584 #endif /* !RBD_DEBUG */
586 static void rbd_osd_copyup_callback(struct rbd_obj_request *obj_request);
587 static int rbd_img_obj_request_submit(struct rbd_obj_request *obj_request);
588 static void rbd_img_parent_read(struct rbd_obj_request *obj_request);
589 static void rbd_dev_remove_parent(struct rbd_device *rbd_dev);
591 static int rbd_dev_refresh(struct rbd_device *rbd_dev);
592 static int rbd_dev_v2_header_onetime(struct rbd_device *rbd_dev);
593 static int rbd_dev_header_info(struct rbd_device *rbd_dev);
594 static int rbd_dev_v2_parent_info(struct rbd_device *rbd_dev);
595 static const char *rbd_dev_v2_snap_name(struct rbd_device *rbd_dev,
597 static int _rbd_dev_v2_snap_size(struct rbd_device *rbd_dev, u64 snap_id,
598 u8 *order, u64 *snap_size);
599 static int _rbd_dev_v2_snap_features(struct rbd_device *rbd_dev, u64 snap_id,
602 static int rbd_open(struct block_device *bdev, fmode_t mode)
604 struct rbd_device *rbd_dev = bdev->bd_disk->private_data;
605 bool removing = false;
607 if ((mode & FMODE_WRITE) && rbd_dev->mapping.read_only)
610 spin_lock_irq(&rbd_dev->lock);
611 if (test_bit(RBD_DEV_FLAG_REMOVING, &rbd_dev->flags))
614 rbd_dev->open_count++;
615 spin_unlock_irq(&rbd_dev->lock);
619 (void) get_device(&rbd_dev->dev);
624 static void rbd_release(struct gendisk *disk, fmode_t mode)
626 struct rbd_device *rbd_dev = disk->private_data;
627 unsigned long open_count_before;
629 spin_lock_irq(&rbd_dev->lock);
630 open_count_before = rbd_dev->open_count--;
631 spin_unlock_irq(&rbd_dev->lock);
632 rbd_assert(open_count_before > 0);
634 put_device(&rbd_dev->dev);
637 static int rbd_ioctl_set_ro(struct rbd_device *rbd_dev, unsigned long arg)
642 bool ro_changed = false;
644 /* get_user() may sleep, so call it before taking rbd_dev->lock */
645 if (get_user(val, (int __user *)(arg)))
648 ro = val ? true : false;
649 /* Snapshot doesn't allow to write*/
650 if (rbd_dev->spec->snap_id != CEPH_NOSNAP && !ro)
653 spin_lock_irq(&rbd_dev->lock);
654 /* prevent others open this device */
655 if (rbd_dev->open_count > 1) {
660 if (rbd_dev->mapping.read_only != ro) {
661 rbd_dev->mapping.read_only = ro;
666 spin_unlock_irq(&rbd_dev->lock);
667 /* set_disk_ro() may sleep, so call it after releasing rbd_dev->lock */
668 if (ret == 0 && ro_changed)
669 set_disk_ro(rbd_dev->disk, ro ? 1 : 0);
674 static int rbd_ioctl(struct block_device *bdev, fmode_t mode,
675 unsigned int cmd, unsigned long arg)
677 struct rbd_device *rbd_dev = bdev->bd_disk->private_data;
682 ret = rbd_ioctl_set_ro(rbd_dev, arg);
692 static int rbd_compat_ioctl(struct block_device *bdev, fmode_t mode,
693 unsigned int cmd, unsigned long arg)
695 return rbd_ioctl(bdev, mode, cmd, arg);
697 #endif /* CONFIG_COMPAT */
699 static const struct block_device_operations rbd_bd_ops = {
700 .owner = THIS_MODULE,
702 .release = rbd_release,
705 .compat_ioctl = rbd_compat_ioctl,
710 * Initialize an rbd client instance. Success or not, this function
711 * consumes ceph_opts. Caller holds client_mutex.
713 static struct rbd_client *rbd_client_create(struct ceph_options *ceph_opts)
715 struct rbd_client *rbdc;
718 dout("%s:\n", __func__);
719 rbdc = kmalloc(sizeof(struct rbd_client), GFP_KERNEL);
723 kref_init(&rbdc->kref);
724 INIT_LIST_HEAD(&rbdc->node);
726 rbdc->client = ceph_create_client(ceph_opts, rbdc, 0, 0);
727 if (IS_ERR(rbdc->client))
729 ceph_opts = NULL; /* Now rbdc->client is responsible for ceph_opts */
731 ret = ceph_open_session(rbdc->client);
735 spin_lock(&rbd_client_list_lock);
736 list_add_tail(&rbdc->node, &rbd_client_list);
737 spin_unlock(&rbd_client_list_lock);
739 dout("%s: rbdc %p\n", __func__, rbdc);
743 ceph_destroy_client(rbdc->client);
748 ceph_destroy_options(ceph_opts);
749 dout("%s: error %d\n", __func__, ret);
754 static struct rbd_client *__rbd_get_client(struct rbd_client *rbdc)
756 kref_get(&rbdc->kref);
762 * Find a ceph client with specific addr and configuration. If
763 * found, bump its reference count.
765 static struct rbd_client *rbd_client_find(struct ceph_options *ceph_opts)
767 struct rbd_client *client_node;
770 if (ceph_opts->flags & CEPH_OPT_NOSHARE)
773 spin_lock(&rbd_client_list_lock);
774 list_for_each_entry(client_node, &rbd_client_list, node) {
775 if (!ceph_compare_options(ceph_opts, client_node->client)) {
776 __rbd_get_client(client_node);
782 spin_unlock(&rbd_client_list_lock);
784 return found ? client_node : NULL;
788 * (Per device) rbd map options
795 /* string args above */
802 static match_table_t rbd_opts_tokens = {
803 {Opt_queue_depth, "queue_depth=%d"},
805 /* string args above */
806 {Opt_read_only, "read_only"},
807 {Opt_read_only, "ro"}, /* Alternate spelling */
808 {Opt_read_write, "read_write"},
809 {Opt_read_write, "rw"}, /* Alternate spelling */
810 {Opt_lock_on_read, "lock_on_read"},
820 #define RBD_QUEUE_DEPTH_DEFAULT BLKDEV_MAX_RQ
821 #define RBD_READ_ONLY_DEFAULT false
822 #define RBD_LOCK_ON_READ_DEFAULT false
824 static int parse_rbd_opts_token(char *c, void *private)
826 struct rbd_options *rbd_opts = private;
827 substring_t argstr[MAX_OPT_ARGS];
828 int token, intval, ret;
830 token = match_token(c, rbd_opts_tokens, argstr);
831 if (token < Opt_last_int) {
832 ret = match_int(&argstr[0], &intval);
834 pr_err("bad mount option arg (not int) at '%s'\n", c);
837 dout("got int token %d val %d\n", token, intval);
838 } else if (token > Opt_last_int && token < Opt_last_string) {
839 dout("got string token %d val %s\n", token, argstr[0].from);
841 dout("got token %d\n", token);
845 case Opt_queue_depth:
847 pr_err("queue_depth out of range\n");
850 rbd_opts->queue_depth = intval;
853 rbd_opts->read_only = true;
856 rbd_opts->read_only = false;
858 case Opt_lock_on_read:
859 rbd_opts->lock_on_read = true;
862 /* libceph prints "bad option" msg */
869 static char* obj_op_name(enum obj_operation_type op_type)
884 * Get a ceph client with specific addr and configuration, if one does
885 * not exist create it. Either way, ceph_opts is consumed by this
888 static struct rbd_client *rbd_get_client(struct ceph_options *ceph_opts)
890 struct rbd_client *rbdc;
892 mutex_lock_nested(&client_mutex, SINGLE_DEPTH_NESTING);
893 rbdc = rbd_client_find(ceph_opts);
894 if (rbdc) /* using an existing client */
895 ceph_destroy_options(ceph_opts);
897 rbdc = rbd_client_create(ceph_opts);
898 mutex_unlock(&client_mutex);
904 * Destroy ceph client
906 * Caller must hold rbd_client_list_lock.
908 static void rbd_client_release(struct kref *kref)
910 struct rbd_client *rbdc = container_of(kref, struct rbd_client, kref);
912 dout("%s: rbdc %p\n", __func__, rbdc);
913 spin_lock(&rbd_client_list_lock);
914 list_del(&rbdc->node);
915 spin_unlock(&rbd_client_list_lock);
917 ceph_destroy_client(rbdc->client);
922 * Drop reference to ceph client node. If it's not referenced anymore, release
925 static void rbd_put_client(struct rbd_client *rbdc)
928 kref_put(&rbdc->kref, rbd_client_release);
931 static bool rbd_image_format_valid(u32 image_format)
933 return image_format == 1 || image_format == 2;
936 static bool rbd_dev_ondisk_valid(struct rbd_image_header_ondisk *ondisk)
941 /* The header has to start with the magic rbd header text */
942 if (memcmp(&ondisk->text, RBD_HEADER_TEXT, sizeof (RBD_HEADER_TEXT)))
945 /* The bio layer requires at least sector-sized I/O */
947 if (ondisk->options.order < SECTOR_SHIFT)
950 /* If we use u64 in a few spots we may be able to loosen this */
952 if (ondisk->options.order > 8 * sizeof (int) - 1)
956 * The size of a snapshot header has to fit in a size_t, and
957 * that limits the number of snapshots.
959 snap_count = le32_to_cpu(ondisk->snap_count);
960 size = SIZE_MAX - sizeof (struct ceph_snap_context);
961 if (snap_count > size / sizeof (__le64))
965 * Not only that, but the size of the entire the snapshot
966 * header must also be representable in a size_t.
968 size -= snap_count * sizeof (__le64);
969 if ((u64) size < le64_to_cpu(ondisk->snap_names_len))
976 * Fill an rbd image header with information from the given format 1
979 static int rbd_header_from_disk(struct rbd_device *rbd_dev,
980 struct rbd_image_header_ondisk *ondisk)
982 struct rbd_image_header *header = &rbd_dev->header;
983 bool first_time = header->object_prefix == NULL;
984 struct ceph_snap_context *snapc;
985 char *object_prefix = NULL;
986 char *snap_names = NULL;
987 u64 *snap_sizes = NULL;
993 /* Allocate this now to avoid having to handle failure below */
998 len = strnlen(ondisk->object_prefix,
999 sizeof (ondisk->object_prefix));
1000 object_prefix = kmalloc(len + 1, GFP_KERNEL);
1003 memcpy(object_prefix, ondisk->object_prefix, len);
1004 object_prefix[len] = '\0';
1007 /* Allocate the snapshot context and fill it in */
1009 snap_count = le32_to_cpu(ondisk->snap_count);
1010 snapc = ceph_create_snap_context(snap_count, GFP_KERNEL);
1013 snapc->seq = le64_to_cpu(ondisk->snap_seq);
1015 struct rbd_image_snap_ondisk *snaps;
1016 u64 snap_names_len = le64_to_cpu(ondisk->snap_names_len);
1018 /* We'll keep a copy of the snapshot names... */
1020 if (snap_names_len > (u64)SIZE_MAX)
1022 snap_names = kmalloc(snap_names_len, GFP_KERNEL);
1026 /* ...as well as the array of their sizes. */
1028 size = snap_count * sizeof (*header->snap_sizes);
1029 snap_sizes = kmalloc(size, GFP_KERNEL);
1034 * Copy the names, and fill in each snapshot's id
1037 * Note that rbd_dev_v1_header_info() guarantees the
1038 * ondisk buffer we're working with has
1039 * snap_names_len bytes beyond the end of the
1040 * snapshot id array, this memcpy() is safe.
1042 memcpy(snap_names, &ondisk->snaps[snap_count], snap_names_len);
1043 snaps = ondisk->snaps;
1044 for (i = 0; i < snap_count; i++) {
1045 snapc->snaps[i] = le64_to_cpu(snaps[i].id);
1046 snap_sizes[i] = le64_to_cpu(snaps[i].image_size);
1050 /* We won't fail any more, fill in the header */
1053 header->object_prefix = object_prefix;
1054 header->obj_order = ondisk->options.order;
1055 header->crypt_type = ondisk->options.crypt_type;
1056 header->comp_type = ondisk->options.comp_type;
1057 /* The rest aren't used for format 1 images */
1058 header->stripe_unit = 0;
1059 header->stripe_count = 0;
1060 header->features = 0;
1062 ceph_put_snap_context(header->snapc);
1063 kfree(header->snap_names);
1064 kfree(header->snap_sizes);
1067 /* The remaining fields always get updated (when we refresh) */
1069 header->image_size = le64_to_cpu(ondisk->image_size);
1070 header->snapc = snapc;
1071 header->snap_names = snap_names;
1072 header->snap_sizes = snap_sizes;
1080 ceph_put_snap_context(snapc);
1081 kfree(object_prefix);
1086 static const char *_rbd_dev_v1_snap_name(struct rbd_device *rbd_dev, u32 which)
1088 const char *snap_name;
1090 rbd_assert(which < rbd_dev->header.snapc->num_snaps);
1092 /* Skip over names until we find the one we are looking for */
1094 snap_name = rbd_dev->header.snap_names;
1096 snap_name += strlen(snap_name) + 1;
1098 return kstrdup(snap_name, GFP_KERNEL);
1102 * Snapshot id comparison function for use with qsort()/bsearch().
1103 * Note that result is for snapshots in *descending* order.
1105 static int snapid_compare_reverse(const void *s1, const void *s2)
1107 u64 snap_id1 = *(u64 *)s1;
1108 u64 snap_id2 = *(u64 *)s2;
1110 if (snap_id1 < snap_id2)
1112 return snap_id1 == snap_id2 ? 0 : -1;
1116 * Search a snapshot context to see if the given snapshot id is
1119 * Returns the position of the snapshot id in the array if it's found,
1120 * or BAD_SNAP_INDEX otherwise.
1122 * Note: The snapshot array is in kept sorted (by the osd) in
1123 * reverse order, highest snapshot id first.
1125 static u32 rbd_dev_snap_index(struct rbd_device *rbd_dev, u64 snap_id)
1127 struct ceph_snap_context *snapc = rbd_dev->header.snapc;
1130 found = bsearch(&snap_id, &snapc->snaps, snapc->num_snaps,
1131 sizeof (snap_id), snapid_compare_reverse);
1133 return found ? (u32)(found - &snapc->snaps[0]) : BAD_SNAP_INDEX;
1136 static const char *rbd_dev_v1_snap_name(struct rbd_device *rbd_dev,
1140 const char *snap_name;
1142 which = rbd_dev_snap_index(rbd_dev, snap_id);
1143 if (which == BAD_SNAP_INDEX)
1144 return ERR_PTR(-ENOENT);
1146 snap_name = _rbd_dev_v1_snap_name(rbd_dev, which);
1147 return snap_name ? snap_name : ERR_PTR(-ENOMEM);
1150 static const char *rbd_snap_name(struct rbd_device *rbd_dev, u64 snap_id)
1152 if (snap_id == CEPH_NOSNAP)
1153 return RBD_SNAP_HEAD_NAME;
1155 rbd_assert(rbd_image_format_valid(rbd_dev->image_format));
1156 if (rbd_dev->image_format == 1)
1157 return rbd_dev_v1_snap_name(rbd_dev, snap_id);
1159 return rbd_dev_v2_snap_name(rbd_dev, snap_id);
1162 static int rbd_snap_size(struct rbd_device *rbd_dev, u64 snap_id,
1165 rbd_assert(rbd_image_format_valid(rbd_dev->image_format));
1166 if (snap_id == CEPH_NOSNAP) {
1167 *snap_size = rbd_dev->header.image_size;
1168 } else if (rbd_dev->image_format == 1) {
1171 which = rbd_dev_snap_index(rbd_dev, snap_id);
1172 if (which == BAD_SNAP_INDEX)
1175 *snap_size = rbd_dev->header.snap_sizes[which];
1180 ret = _rbd_dev_v2_snap_size(rbd_dev, snap_id, NULL, &size);
1189 static int rbd_snap_features(struct rbd_device *rbd_dev, u64 snap_id,
1192 rbd_assert(rbd_image_format_valid(rbd_dev->image_format));
1193 if (snap_id == CEPH_NOSNAP) {
1194 *snap_features = rbd_dev->header.features;
1195 } else if (rbd_dev->image_format == 1) {
1196 *snap_features = 0; /* No features for format 1 */
1201 ret = _rbd_dev_v2_snap_features(rbd_dev, snap_id, &features);
1205 *snap_features = features;
1210 static int rbd_dev_mapping_set(struct rbd_device *rbd_dev)
1212 u64 snap_id = rbd_dev->spec->snap_id;
1217 ret = rbd_snap_size(rbd_dev, snap_id, &size);
1220 ret = rbd_snap_features(rbd_dev, snap_id, &features);
1224 rbd_dev->mapping.size = size;
1225 rbd_dev->mapping.features = features;
1230 static void rbd_dev_mapping_clear(struct rbd_device *rbd_dev)
1232 rbd_dev->mapping.size = 0;
1233 rbd_dev->mapping.features = 0;
1236 static void rbd_segment_name_free(const char *name)
1238 /* The explicit cast here is needed to drop the const qualifier */
1240 kmem_cache_free(rbd_segment_name_cache, (void *)name);
1243 static const char *rbd_segment_name(struct rbd_device *rbd_dev, u64 offset)
1250 name = kmem_cache_alloc(rbd_segment_name_cache, GFP_NOIO);
1253 segment = offset >> rbd_dev->header.obj_order;
1254 name_format = "%s.%012llx";
1255 if (rbd_dev->image_format == 2)
1256 name_format = "%s.%016llx";
1257 ret = snprintf(name, CEPH_MAX_OID_NAME_LEN + 1, name_format,
1258 rbd_dev->header.object_prefix, segment);
1259 if (ret < 0 || ret > CEPH_MAX_OID_NAME_LEN) {
1260 pr_err("error formatting segment name for #%llu (%d)\n",
1262 rbd_segment_name_free(name);
1269 static u64 rbd_segment_offset(struct rbd_device *rbd_dev, u64 offset)
1271 u64 segment_size = (u64) 1 << rbd_dev->header.obj_order;
1273 return offset & (segment_size - 1);
1276 static u64 rbd_segment_length(struct rbd_device *rbd_dev,
1277 u64 offset, u64 length)
1279 u64 segment_size = (u64) 1 << rbd_dev->header.obj_order;
1281 offset &= segment_size - 1;
1283 rbd_assert(length <= U64_MAX - offset);
1284 if (offset + length > segment_size)
1285 length = segment_size - offset;
1291 * returns the size of an object in the image
1293 static u64 rbd_obj_bytes(struct rbd_image_header *header)
1295 return 1 << header->obj_order;
1302 static void bio_chain_put(struct bio *chain)
1308 chain = chain->bi_next;
1314 * zeros a bio chain, starting at specific offset
1316 static void zero_bio_chain(struct bio *chain, int start_ofs)
1319 struct bvec_iter iter;
1320 unsigned long flags;
1325 bio_for_each_segment(bv, chain, iter) {
1326 if (pos + bv.bv_len > start_ofs) {
1327 int remainder = max(start_ofs - pos, 0);
1328 buf = bvec_kmap_irq(&bv, &flags);
1329 memset(buf + remainder, 0,
1330 bv.bv_len - remainder);
1331 flush_dcache_page(bv.bv_page);
1332 bvec_kunmap_irq(buf, &flags);
1337 chain = chain->bi_next;
1342 * similar to zero_bio_chain(), zeros data defined by a page array,
1343 * starting at the given byte offset from the start of the array and
1344 * continuing up to the given end offset. The pages array is
1345 * assumed to be big enough to hold all bytes up to the end.
1347 static void zero_pages(struct page **pages, u64 offset, u64 end)
1349 struct page **page = &pages[offset >> PAGE_SHIFT];
1351 rbd_assert(end > offset);
1352 rbd_assert(end - offset <= (u64)SIZE_MAX);
1353 while (offset < end) {
1356 unsigned long flags;
1359 page_offset = offset & ~PAGE_MASK;
1360 length = min_t(size_t, PAGE_SIZE - page_offset, end - offset);
1361 local_irq_save(flags);
1362 kaddr = kmap_atomic(*page);
1363 memset(kaddr + page_offset, 0, length);
1364 flush_dcache_page(*page);
1365 kunmap_atomic(kaddr);
1366 local_irq_restore(flags);
1374 * Clone a portion of a bio, starting at the given byte offset
1375 * and continuing for the number of bytes indicated.
1377 static struct bio *bio_clone_range(struct bio *bio_src,
1378 unsigned int offset,
1384 bio = bio_clone(bio_src, gfpmask);
1386 return NULL; /* ENOMEM */
1388 bio_advance(bio, offset);
1389 bio->bi_iter.bi_size = len;
1395 * Clone a portion of a bio chain, starting at the given byte offset
1396 * into the first bio in the source chain and continuing for the
1397 * number of bytes indicated. The result is another bio chain of
1398 * exactly the given length, or a null pointer on error.
1400 * The bio_src and offset parameters are both in-out. On entry they
1401 * refer to the first source bio and the offset into that bio where
1402 * the start of data to be cloned is located.
1404 * On return, bio_src is updated to refer to the bio in the source
1405 * chain that contains first un-cloned byte, and *offset will
1406 * contain the offset of that byte within that bio.
1408 static struct bio *bio_chain_clone_range(struct bio **bio_src,
1409 unsigned int *offset,
1413 struct bio *bi = *bio_src;
1414 unsigned int off = *offset;
1415 struct bio *chain = NULL;
1418 /* Build up a chain of clone bios up to the limit */
1420 if (!bi || off >= bi->bi_iter.bi_size || !len)
1421 return NULL; /* Nothing to clone */
1425 unsigned int bi_size;
1429 rbd_warn(NULL, "bio_chain exhausted with %u left", len);
1430 goto out_err; /* EINVAL; ran out of bio's */
1432 bi_size = min_t(unsigned int, bi->bi_iter.bi_size - off, len);
1433 bio = bio_clone_range(bi, off, bi_size, gfpmask);
1435 goto out_err; /* ENOMEM */
1438 end = &bio->bi_next;
1441 if (off == bi->bi_iter.bi_size) {
1452 bio_chain_put(chain);
1458 * The default/initial value for all object request flags is 0. For
1459 * each flag, once its value is set to 1 it is never reset to 0
1462 static void obj_request_img_data_set(struct rbd_obj_request *obj_request)
1464 if (test_and_set_bit(OBJ_REQ_IMG_DATA, &obj_request->flags)) {
1465 struct rbd_device *rbd_dev;
1467 rbd_dev = obj_request->img_request->rbd_dev;
1468 rbd_warn(rbd_dev, "obj_request %p already marked img_data",
1473 static bool obj_request_img_data_test(struct rbd_obj_request *obj_request)
1476 return test_bit(OBJ_REQ_IMG_DATA, &obj_request->flags) != 0;
1479 static void obj_request_done_set(struct rbd_obj_request *obj_request)
1481 if (test_and_set_bit(OBJ_REQ_DONE, &obj_request->flags)) {
1482 struct rbd_device *rbd_dev = NULL;
1484 if (obj_request_img_data_test(obj_request))
1485 rbd_dev = obj_request->img_request->rbd_dev;
1486 rbd_warn(rbd_dev, "obj_request %p already marked done",
1491 static bool obj_request_done_test(struct rbd_obj_request *obj_request)
1494 return test_bit(OBJ_REQ_DONE, &obj_request->flags) != 0;
1498 * This sets the KNOWN flag after (possibly) setting the EXISTS
1499 * flag. The latter is set based on the "exists" value provided.
1501 * Note that for our purposes once an object exists it never goes
1502 * away again. It's possible that the response from two existence
1503 * checks are separated by the creation of the target object, and
1504 * the first ("doesn't exist") response arrives *after* the second
1505 * ("does exist"). In that case we ignore the second one.
1507 static void obj_request_existence_set(struct rbd_obj_request *obj_request,
1511 set_bit(OBJ_REQ_EXISTS, &obj_request->flags);
1512 set_bit(OBJ_REQ_KNOWN, &obj_request->flags);
1516 static bool obj_request_known_test(struct rbd_obj_request *obj_request)
1519 return test_bit(OBJ_REQ_KNOWN, &obj_request->flags) != 0;
1522 static bool obj_request_exists_test(struct rbd_obj_request *obj_request)
1525 return test_bit(OBJ_REQ_EXISTS, &obj_request->flags) != 0;
1528 static bool obj_request_overlaps_parent(struct rbd_obj_request *obj_request)
1530 struct rbd_device *rbd_dev = obj_request->img_request->rbd_dev;
1532 return obj_request->img_offset <
1533 round_up(rbd_dev->parent_overlap, rbd_obj_bytes(&rbd_dev->header));
1536 static void rbd_obj_request_get(struct rbd_obj_request *obj_request)
1538 dout("%s: obj %p (was %d)\n", __func__, obj_request,
1539 atomic_read(&obj_request->kref.refcount));
1540 kref_get(&obj_request->kref);
1543 static void rbd_obj_request_destroy(struct kref *kref);
1544 static void rbd_obj_request_put(struct rbd_obj_request *obj_request)
1546 rbd_assert(obj_request != NULL);
1547 dout("%s: obj %p (was %d)\n", __func__, obj_request,
1548 atomic_read(&obj_request->kref.refcount));
1549 kref_put(&obj_request->kref, rbd_obj_request_destroy);
1552 static void rbd_img_request_get(struct rbd_img_request *img_request)
1554 dout("%s: img %p (was %d)\n", __func__, img_request,
1555 atomic_read(&img_request->kref.refcount));
1556 kref_get(&img_request->kref);
1559 static bool img_request_child_test(struct rbd_img_request *img_request);
1560 static void rbd_parent_request_destroy(struct kref *kref);
1561 static void rbd_img_request_destroy(struct kref *kref);
1562 static void rbd_img_request_put(struct rbd_img_request *img_request)
1564 rbd_assert(img_request != NULL);
1565 dout("%s: img %p (was %d)\n", __func__, img_request,
1566 atomic_read(&img_request->kref.refcount));
1567 if (img_request_child_test(img_request))
1568 kref_put(&img_request->kref, rbd_parent_request_destroy);
1570 kref_put(&img_request->kref, rbd_img_request_destroy);
1573 static inline void rbd_img_obj_request_add(struct rbd_img_request *img_request,
1574 struct rbd_obj_request *obj_request)
1576 rbd_assert(obj_request->img_request == NULL);
1578 /* Image request now owns object's original reference */
1579 obj_request->img_request = img_request;
1580 obj_request->which = img_request->obj_request_count;
1581 rbd_assert(!obj_request_img_data_test(obj_request));
1582 obj_request_img_data_set(obj_request);
1583 rbd_assert(obj_request->which != BAD_WHICH);
1584 img_request->obj_request_count++;
1585 list_add_tail(&obj_request->links, &img_request->obj_requests);
1586 dout("%s: img %p obj %p w=%u\n", __func__, img_request, obj_request,
1587 obj_request->which);
1590 static inline void rbd_img_obj_request_del(struct rbd_img_request *img_request,
1591 struct rbd_obj_request *obj_request)
1593 rbd_assert(obj_request->which != BAD_WHICH);
1595 dout("%s: img %p obj %p w=%u\n", __func__, img_request, obj_request,
1596 obj_request->which);
1597 list_del(&obj_request->links);
1598 rbd_assert(img_request->obj_request_count > 0);
1599 img_request->obj_request_count--;
1600 rbd_assert(obj_request->which == img_request->obj_request_count);
1601 obj_request->which = BAD_WHICH;
1602 rbd_assert(obj_request_img_data_test(obj_request));
1603 rbd_assert(obj_request->img_request == img_request);
1604 obj_request->img_request = NULL;
1605 obj_request->callback = NULL;
1606 rbd_obj_request_put(obj_request);
1609 static bool obj_request_type_valid(enum obj_request_type type)
1612 case OBJ_REQUEST_NODATA:
1613 case OBJ_REQUEST_BIO:
1614 case OBJ_REQUEST_PAGES:
1621 static void rbd_img_obj_callback(struct rbd_obj_request *obj_request);
1623 static void rbd_obj_request_submit(struct rbd_obj_request *obj_request)
1625 struct ceph_osd_request *osd_req = obj_request->osd_req;
1627 dout("%s %p osd_req %p\n", __func__, obj_request, osd_req);
1628 if (obj_request_img_data_test(obj_request)) {
1629 WARN_ON(obj_request->callback != rbd_img_obj_callback);
1630 rbd_img_request_get(obj_request->img_request);
1632 ceph_osdc_start_request(osd_req->r_osdc, osd_req, false);
1635 static void rbd_obj_request_end(struct rbd_obj_request *obj_request)
1637 dout("%s %p\n", __func__, obj_request);
1638 ceph_osdc_cancel_request(obj_request->osd_req);
1642 * Wait for an object request to complete. If interrupted, cancel the
1643 * underlying osd request.
1645 * @timeout: in jiffies, 0 means "wait forever"
1647 static int __rbd_obj_request_wait(struct rbd_obj_request *obj_request,
1648 unsigned long timeout)
1652 dout("%s %p\n", __func__, obj_request);
1653 ret = wait_for_completion_interruptible_timeout(
1654 &obj_request->completion,
1655 ceph_timeout_jiffies(timeout));
1659 rbd_obj_request_end(obj_request);
1664 dout("%s %p ret %d\n", __func__, obj_request, (int)ret);
1668 static int rbd_obj_request_wait(struct rbd_obj_request *obj_request)
1670 return __rbd_obj_request_wait(obj_request, 0);
1673 static void rbd_img_request_complete(struct rbd_img_request *img_request)
1676 dout("%s: img %p\n", __func__, img_request);
1679 * If no error occurred, compute the aggregate transfer
1680 * count for the image request. We could instead use
1681 * atomic64_cmpxchg() to update it as each object request
1682 * completes; not clear which way is better off hand.
1684 if (!img_request->result) {
1685 struct rbd_obj_request *obj_request;
1688 for_each_obj_request(img_request, obj_request)
1689 xferred += obj_request->xferred;
1690 img_request->xferred = xferred;
1693 if (img_request->callback)
1694 img_request->callback(img_request);
1696 rbd_img_request_put(img_request);
1700 * The default/initial value for all image request flags is 0. Each
1701 * is conditionally set to 1 at image request initialization time
1702 * and currently never change thereafter.
1704 static void img_request_write_set(struct rbd_img_request *img_request)
1706 set_bit(IMG_REQ_WRITE, &img_request->flags);
1710 static bool img_request_write_test(struct rbd_img_request *img_request)
1713 return test_bit(IMG_REQ_WRITE, &img_request->flags) != 0;
1717 * Set the discard flag when the img_request is an discard request
1719 static void img_request_discard_set(struct rbd_img_request *img_request)
1721 set_bit(IMG_REQ_DISCARD, &img_request->flags);
1725 static bool img_request_discard_test(struct rbd_img_request *img_request)
1728 return test_bit(IMG_REQ_DISCARD, &img_request->flags) != 0;
1731 static void img_request_child_set(struct rbd_img_request *img_request)
1733 set_bit(IMG_REQ_CHILD, &img_request->flags);
1737 static void img_request_child_clear(struct rbd_img_request *img_request)
1739 clear_bit(IMG_REQ_CHILD, &img_request->flags);
1743 static bool img_request_child_test(struct rbd_img_request *img_request)
1746 return test_bit(IMG_REQ_CHILD, &img_request->flags) != 0;
1749 static void img_request_layered_set(struct rbd_img_request *img_request)
1751 set_bit(IMG_REQ_LAYERED, &img_request->flags);
1755 static void img_request_layered_clear(struct rbd_img_request *img_request)
1757 clear_bit(IMG_REQ_LAYERED, &img_request->flags);
1761 static bool img_request_layered_test(struct rbd_img_request *img_request)
1764 return test_bit(IMG_REQ_LAYERED, &img_request->flags) != 0;
1767 static enum obj_operation_type
1768 rbd_img_request_op_type(struct rbd_img_request *img_request)
1770 if (img_request_write_test(img_request))
1771 return OBJ_OP_WRITE;
1772 else if (img_request_discard_test(img_request))
1773 return OBJ_OP_DISCARD;
1779 rbd_img_obj_request_read_callback(struct rbd_obj_request *obj_request)
1781 u64 xferred = obj_request->xferred;
1782 u64 length = obj_request->length;
1784 dout("%s: obj %p img %p result %d %llu/%llu\n", __func__,
1785 obj_request, obj_request->img_request, obj_request->result,
1788 * ENOENT means a hole in the image. We zero-fill the entire
1789 * length of the request. A short read also implies zero-fill
1790 * to the end of the request. An error requires the whole
1791 * length of the request to be reported finished with an error
1792 * to the block layer. In each case we update the xferred
1793 * count to indicate the whole request was satisfied.
1795 rbd_assert(obj_request->type != OBJ_REQUEST_NODATA);
1796 if (obj_request->result == -ENOENT) {
1797 if (obj_request->type == OBJ_REQUEST_BIO)
1798 zero_bio_chain(obj_request->bio_list, 0);
1800 zero_pages(obj_request->pages, 0, length);
1801 obj_request->result = 0;
1802 } else if (xferred < length && !obj_request->result) {
1803 if (obj_request->type == OBJ_REQUEST_BIO)
1804 zero_bio_chain(obj_request->bio_list, xferred);
1806 zero_pages(obj_request->pages, xferred, length);
1808 obj_request->xferred = length;
1809 obj_request_done_set(obj_request);
1812 static void rbd_obj_request_complete(struct rbd_obj_request *obj_request)
1814 dout("%s: obj %p cb %p\n", __func__, obj_request,
1815 obj_request->callback);
1816 if (obj_request->callback)
1817 obj_request->callback(obj_request);
1819 complete_all(&obj_request->completion);
1822 static void rbd_osd_read_callback(struct rbd_obj_request *obj_request)
1824 struct rbd_img_request *img_request = NULL;
1825 struct rbd_device *rbd_dev = NULL;
1826 bool layered = false;
1828 if (obj_request_img_data_test(obj_request)) {
1829 img_request = obj_request->img_request;
1830 layered = img_request && img_request_layered_test(img_request);
1831 rbd_dev = img_request->rbd_dev;
1834 dout("%s: obj %p img %p result %d %llu/%llu\n", __func__,
1835 obj_request, img_request, obj_request->result,
1836 obj_request->xferred, obj_request->length);
1837 if (layered && obj_request->result == -ENOENT &&
1838 obj_request->img_offset < rbd_dev->parent_overlap)
1839 rbd_img_parent_read(obj_request);
1840 else if (img_request)
1841 rbd_img_obj_request_read_callback(obj_request);
1843 obj_request_done_set(obj_request);
1846 static void rbd_osd_write_callback(struct rbd_obj_request *obj_request)
1848 dout("%s: obj %p result %d %llu\n", __func__, obj_request,
1849 obj_request->result, obj_request->length);
1851 * There is no such thing as a successful short write. Set
1852 * it to our originally-requested length.
1854 obj_request->xferred = obj_request->length;
1855 obj_request_done_set(obj_request);
1858 static void rbd_osd_discard_callback(struct rbd_obj_request *obj_request)
1860 dout("%s: obj %p result %d %llu\n", __func__, obj_request,
1861 obj_request->result, obj_request->length);
1863 * There is no such thing as a successful short discard. Set
1864 * it to our originally-requested length.
1866 obj_request->xferred = obj_request->length;
1867 /* discarding a non-existent object is not a problem */
1868 if (obj_request->result == -ENOENT)
1869 obj_request->result = 0;
1870 obj_request_done_set(obj_request);
1874 * For a simple stat call there's nothing to do. We'll do more if
1875 * this is part of a write sequence for a layered image.
1877 static void rbd_osd_stat_callback(struct rbd_obj_request *obj_request)
1879 dout("%s: obj %p\n", __func__, obj_request);
1880 obj_request_done_set(obj_request);
1883 static void rbd_osd_call_callback(struct rbd_obj_request *obj_request)
1885 dout("%s: obj %p\n", __func__, obj_request);
1887 if (obj_request_img_data_test(obj_request))
1888 rbd_osd_copyup_callback(obj_request);
1890 obj_request_done_set(obj_request);
1893 static void rbd_osd_req_callback(struct ceph_osd_request *osd_req)
1895 struct rbd_obj_request *obj_request = osd_req->r_priv;
1898 dout("%s: osd_req %p\n", __func__, osd_req);
1899 rbd_assert(osd_req == obj_request->osd_req);
1900 if (obj_request_img_data_test(obj_request)) {
1901 rbd_assert(obj_request->img_request);
1902 rbd_assert(obj_request->which != BAD_WHICH);
1904 rbd_assert(obj_request->which == BAD_WHICH);
1907 if (osd_req->r_result < 0)
1908 obj_request->result = osd_req->r_result;
1911 * We support a 64-bit length, but ultimately it has to be
1912 * passed to the block layer, which just supports a 32-bit
1915 obj_request->xferred = osd_req->r_ops[0].outdata_len;
1916 rbd_assert(obj_request->xferred < (u64)UINT_MAX);
1918 opcode = osd_req->r_ops[0].op;
1920 case CEPH_OSD_OP_READ:
1921 rbd_osd_read_callback(obj_request);
1923 case CEPH_OSD_OP_SETALLOCHINT:
1924 rbd_assert(osd_req->r_ops[1].op == CEPH_OSD_OP_WRITE ||
1925 osd_req->r_ops[1].op == CEPH_OSD_OP_WRITEFULL);
1927 case CEPH_OSD_OP_WRITE:
1928 case CEPH_OSD_OP_WRITEFULL:
1929 rbd_osd_write_callback(obj_request);
1931 case CEPH_OSD_OP_STAT:
1932 rbd_osd_stat_callback(obj_request);
1934 case CEPH_OSD_OP_DELETE:
1935 case CEPH_OSD_OP_TRUNCATE:
1936 case CEPH_OSD_OP_ZERO:
1937 rbd_osd_discard_callback(obj_request);
1939 case CEPH_OSD_OP_CALL:
1940 rbd_osd_call_callback(obj_request);
1943 rbd_warn(NULL, "%s: unsupported op %hu",
1944 obj_request->object_name, (unsigned short) opcode);
1948 if (obj_request_done_test(obj_request))
1949 rbd_obj_request_complete(obj_request);
1952 static void rbd_osd_req_format_read(struct rbd_obj_request *obj_request)
1954 struct rbd_img_request *img_request = obj_request->img_request;
1955 struct ceph_osd_request *osd_req = obj_request->osd_req;
1958 osd_req->r_snapid = img_request->snap_id;
1961 static void rbd_osd_req_format_write(struct rbd_obj_request *obj_request)
1963 struct ceph_osd_request *osd_req = obj_request->osd_req;
1965 osd_req->r_mtime = CURRENT_TIME;
1966 osd_req->r_data_offset = obj_request->offset;
1970 * Create an osd request. A read request has one osd op (read).
1971 * A write request has either one (watch) or two (hint+write) osd ops.
1972 * (All rbd data writes are prefixed with an allocation hint op, but
1973 * technically osd watch is a write request, hence this distinction.)
1975 static struct ceph_osd_request *rbd_osd_req_create(
1976 struct rbd_device *rbd_dev,
1977 enum obj_operation_type op_type,
1978 unsigned int num_ops,
1979 struct rbd_obj_request *obj_request)
1981 struct ceph_snap_context *snapc = NULL;
1982 struct ceph_osd_client *osdc;
1983 struct ceph_osd_request *osd_req;
1985 if (obj_request_img_data_test(obj_request) &&
1986 (op_type == OBJ_OP_DISCARD || op_type == OBJ_OP_WRITE)) {
1987 struct rbd_img_request *img_request = obj_request->img_request;
1988 if (op_type == OBJ_OP_WRITE) {
1989 rbd_assert(img_request_write_test(img_request));
1991 rbd_assert(img_request_discard_test(img_request));
1993 snapc = img_request->snapc;
1996 rbd_assert(num_ops == 1 || ((op_type == OBJ_OP_WRITE) && num_ops == 2));
1998 /* Allocate and initialize the request, for the num_ops ops */
2000 osdc = &rbd_dev->rbd_client->client->osdc;
2001 osd_req = ceph_osdc_alloc_request(osdc, snapc, num_ops, false,
2006 if (op_type == OBJ_OP_WRITE || op_type == OBJ_OP_DISCARD)
2007 osd_req->r_flags = CEPH_OSD_FLAG_WRITE | CEPH_OSD_FLAG_ONDISK;
2009 osd_req->r_flags = CEPH_OSD_FLAG_READ;
2011 osd_req->r_callback = rbd_osd_req_callback;
2012 osd_req->r_priv = obj_request;
2014 osd_req->r_base_oloc.pool = rbd_dev->layout.pool_id;
2015 if (ceph_oid_aprintf(&osd_req->r_base_oid, GFP_NOIO, "%s",
2016 obj_request->object_name))
2019 if (ceph_osdc_alloc_messages(osd_req, GFP_NOIO))
2025 ceph_osdc_put_request(osd_req);
2030 * Create a copyup osd request based on the information in the object
2031 * request supplied. A copyup request has two or three osd ops, a
2032 * copyup method call, potentially a hint op, and a write or truncate
2035 static struct ceph_osd_request *
2036 rbd_osd_req_create_copyup(struct rbd_obj_request *obj_request)
2038 struct rbd_img_request *img_request;
2039 struct ceph_snap_context *snapc;
2040 struct rbd_device *rbd_dev;
2041 struct ceph_osd_client *osdc;
2042 struct ceph_osd_request *osd_req;
2043 int num_osd_ops = 3;
2045 rbd_assert(obj_request_img_data_test(obj_request));
2046 img_request = obj_request->img_request;
2047 rbd_assert(img_request);
2048 rbd_assert(img_request_write_test(img_request) ||
2049 img_request_discard_test(img_request));
2051 if (img_request_discard_test(img_request))
2054 /* Allocate and initialize the request, for all the ops */
2056 snapc = img_request->snapc;
2057 rbd_dev = img_request->rbd_dev;
2058 osdc = &rbd_dev->rbd_client->client->osdc;
2059 osd_req = ceph_osdc_alloc_request(osdc, snapc, num_osd_ops,
2064 osd_req->r_flags = CEPH_OSD_FLAG_WRITE | CEPH_OSD_FLAG_ONDISK;
2065 osd_req->r_callback = rbd_osd_req_callback;
2066 osd_req->r_priv = obj_request;
2068 osd_req->r_base_oloc.pool = rbd_dev->layout.pool_id;
2069 if (ceph_oid_aprintf(&osd_req->r_base_oid, GFP_NOIO, "%s",
2070 obj_request->object_name))
2073 if (ceph_osdc_alloc_messages(osd_req, GFP_NOIO))
2079 ceph_osdc_put_request(osd_req);
2084 static void rbd_osd_req_destroy(struct ceph_osd_request *osd_req)
2086 ceph_osdc_put_request(osd_req);
2089 /* object_name is assumed to be a non-null pointer and NUL-terminated */
2091 static struct rbd_obj_request *rbd_obj_request_create(const char *object_name,
2092 u64 offset, u64 length,
2093 enum obj_request_type type)
2095 struct rbd_obj_request *obj_request;
2099 rbd_assert(obj_request_type_valid(type));
2101 size = strlen(object_name) + 1;
2102 name = kmalloc(size, GFP_NOIO);
2106 obj_request = kmem_cache_zalloc(rbd_obj_request_cache, GFP_NOIO);
2112 obj_request->object_name = memcpy(name, object_name, size);
2113 obj_request->offset = offset;
2114 obj_request->length = length;
2115 obj_request->flags = 0;
2116 obj_request->which = BAD_WHICH;
2117 obj_request->type = type;
2118 INIT_LIST_HEAD(&obj_request->links);
2119 init_completion(&obj_request->completion);
2120 kref_init(&obj_request->kref);
2122 dout("%s: \"%s\" %llu/%llu %d -> obj %p\n", __func__, object_name,
2123 offset, length, (int)type, obj_request);
2128 static void rbd_obj_request_destroy(struct kref *kref)
2130 struct rbd_obj_request *obj_request;
2132 obj_request = container_of(kref, struct rbd_obj_request, kref);
2134 dout("%s: obj %p\n", __func__, obj_request);
2136 rbd_assert(obj_request->img_request == NULL);
2137 rbd_assert(obj_request->which == BAD_WHICH);
2139 if (obj_request->osd_req)
2140 rbd_osd_req_destroy(obj_request->osd_req);
2142 rbd_assert(obj_request_type_valid(obj_request->type));
2143 switch (obj_request->type) {
2144 case OBJ_REQUEST_NODATA:
2145 break; /* Nothing to do */
2146 case OBJ_REQUEST_BIO:
2147 if (obj_request->bio_list)
2148 bio_chain_put(obj_request->bio_list);
2150 case OBJ_REQUEST_PAGES:
2151 if (obj_request->pages)
2152 ceph_release_page_vector(obj_request->pages,
2153 obj_request->page_count);
2157 kfree(obj_request->object_name);
2158 obj_request->object_name = NULL;
2159 kmem_cache_free(rbd_obj_request_cache, obj_request);
2162 /* It's OK to call this for a device with no parent */
2164 static void rbd_spec_put(struct rbd_spec *spec);
2165 static void rbd_dev_unparent(struct rbd_device *rbd_dev)
2167 rbd_dev_remove_parent(rbd_dev);
2168 rbd_spec_put(rbd_dev->parent_spec);
2169 rbd_dev->parent_spec = NULL;
2170 rbd_dev->parent_overlap = 0;
2174 * Parent image reference counting is used to determine when an
2175 * image's parent fields can be safely torn down--after there are no
2176 * more in-flight requests to the parent image. When the last
2177 * reference is dropped, cleaning them up is safe.
2179 static void rbd_dev_parent_put(struct rbd_device *rbd_dev)
2183 if (!rbd_dev->parent_spec)
2186 counter = atomic_dec_return_safe(&rbd_dev->parent_ref);
2190 /* Last reference; clean up parent data structures */
2193 rbd_dev_unparent(rbd_dev);
2195 rbd_warn(rbd_dev, "parent reference underflow");
2199 * If an image has a non-zero parent overlap, get a reference to its
2202 * Returns true if the rbd device has a parent with a non-zero
2203 * overlap and a reference for it was successfully taken, or
2206 static bool rbd_dev_parent_get(struct rbd_device *rbd_dev)
2210 if (!rbd_dev->parent_spec)
2213 down_read(&rbd_dev->header_rwsem);
2214 if (rbd_dev->parent_overlap)
2215 counter = atomic_inc_return_safe(&rbd_dev->parent_ref);
2216 up_read(&rbd_dev->header_rwsem);
2219 rbd_warn(rbd_dev, "parent reference overflow");
2225 * Caller is responsible for filling in the list of object requests
2226 * that comprises the image request, and the Linux request pointer
2227 * (if there is one).
2229 static struct rbd_img_request *rbd_img_request_create(
2230 struct rbd_device *rbd_dev,
2231 u64 offset, u64 length,
2232 enum obj_operation_type op_type,
2233 struct ceph_snap_context *snapc)
2235 struct rbd_img_request *img_request;
2237 img_request = kmem_cache_alloc(rbd_img_request_cache, GFP_NOIO);
2241 img_request->rq = NULL;
2242 img_request->rbd_dev = rbd_dev;
2243 img_request->offset = offset;
2244 img_request->length = length;
2245 img_request->flags = 0;
2246 if (op_type == OBJ_OP_DISCARD) {
2247 img_request_discard_set(img_request);
2248 img_request->snapc = snapc;
2249 } else if (op_type == OBJ_OP_WRITE) {
2250 img_request_write_set(img_request);
2251 img_request->snapc = snapc;
2253 img_request->snap_id = rbd_dev->spec->snap_id;
2255 if (rbd_dev_parent_get(rbd_dev))
2256 img_request_layered_set(img_request);
2257 spin_lock_init(&img_request->completion_lock);
2258 img_request->next_completion = 0;
2259 img_request->callback = NULL;
2260 img_request->result = 0;
2261 img_request->obj_request_count = 0;
2262 INIT_LIST_HEAD(&img_request->obj_requests);
2263 kref_init(&img_request->kref);
2265 dout("%s: rbd_dev %p %s %llu/%llu -> img %p\n", __func__, rbd_dev,
2266 obj_op_name(op_type), offset, length, img_request);
2271 static void rbd_img_request_destroy(struct kref *kref)
2273 struct rbd_img_request *img_request;
2274 struct rbd_obj_request *obj_request;
2275 struct rbd_obj_request *next_obj_request;
2277 img_request = container_of(kref, struct rbd_img_request, kref);
2279 dout("%s: img %p\n", __func__, img_request);
2281 for_each_obj_request_safe(img_request, obj_request, next_obj_request)
2282 rbd_img_obj_request_del(img_request, obj_request);
2283 rbd_assert(img_request->obj_request_count == 0);
2285 if (img_request_layered_test(img_request)) {
2286 img_request_layered_clear(img_request);
2287 rbd_dev_parent_put(img_request->rbd_dev);
2290 if (img_request_write_test(img_request) ||
2291 img_request_discard_test(img_request))
2292 ceph_put_snap_context(img_request->snapc);
2294 kmem_cache_free(rbd_img_request_cache, img_request);
2297 static struct rbd_img_request *rbd_parent_request_create(
2298 struct rbd_obj_request *obj_request,
2299 u64 img_offset, u64 length)
2301 struct rbd_img_request *parent_request;
2302 struct rbd_device *rbd_dev;
2304 rbd_assert(obj_request->img_request);
2305 rbd_dev = obj_request->img_request->rbd_dev;
2307 parent_request = rbd_img_request_create(rbd_dev->parent, img_offset,
2308 length, OBJ_OP_READ, NULL);
2309 if (!parent_request)
2312 img_request_child_set(parent_request);
2313 rbd_obj_request_get(obj_request);
2314 parent_request->obj_request = obj_request;
2316 return parent_request;
2319 static void rbd_parent_request_destroy(struct kref *kref)
2321 struct rbd_img_request *parent_request;
2322 struct rbd_obj_request *orig_request;
2324 parent_request = container_of(kref, struct rbd_img_request, kref);
2325 orig_request = parent_request->obj_request;
2327 parent_request->obj_request = NULL;
2328 rbd_obj_request_put(orig_request);
2329 img_request_child_clear(parent_request);
2331 rbd_img_request_destroy(kref);
2334 static bool rbd_img_obj_end_request(struct rbd_obj_request *obj_request)
2336 struct rbd_img_request *img_request;
2337 unsigned int xferred;
2341 rbd_assert(obj_request_img_data_test(obj_request));
2342 img_request = obj_request->img_request;
2344 rbd_assert(obj_request->xferred <= (u64)UINT_MAX);
2345 xferred = (unsigned int)obj_request->xferred;
2346 result = obj_request->result;
2348 struct rbd_device *rbd_dev = img_request->rbd_dev;
2349 enum obj_operation_type op_type;
2351 if (img_request_discard_test(img_request))
2352 op_type = OBJ_OP_DISCARD;
2353 else if (img_request_write_test(img_request))
2354 op_type = OBJ_OP_WRITE;
2356 op_type = OBJ_OP_READ;
2358 rbd_warn(rbd_dev, "%s %llx at %llx (%llx)",
2359 obj_op_name(op_type), obj_request->length,
2360 obj_request->img_offset, obj_request->offset);
2361 rbd_warn(rbd_dev, " result %d xferred %x",
2363 if (!img_request->result)
2364 img_request->result = result;
2366 * Need to end I/O on the entire obj_request worth of
2367 * bytes in case of error.
2369 xferred = obj_request->length;
2372 /* Image object requests don't own their page array */
2374 if (obj_request->type == OBJ_REQUEST_PAGES) {
2375 obj_request->pages = NULL;
2376 obj_request->page_count = 0;
2379 if (img_request_child_test(img_request)) {
2380 rbd_assert(img_request->obj_request != NULL);
2381 more = obj_request->which < img_request->obj_request_count - 1;
2383 rbd_assert(img_request->rq != NULL);
2385 more = blk_update_request(img_request->rq, result, xferred);
2387 __blk_mq_end_request(img_request->rq, result);
2393 static void rbd_img_obj_callback(struct rbd_obj_request *obj_request)
2395 struct rbd_img_request *img_request;
2396 u32 which = obj_request->which;
2399 rbd_assert(obj_request_img_data_test(obj_request));
2400 img_request = obj_request->img_request;
2402 dout("%s: img %p obj %p\n", __func__, img_request, obj_request);
2403 rbd_assert(img_request != NULL);
2404 rbd_assert(img_request->obj_request_count > 0);
2405 rbd_assert(which != BAD_WHICH);
2406 rbd_assert(which < img_request->obj_request_count);
2408 spin_lock_irq(&img_request->completion_lock);
2409 if (which != img_request->next_completion)
2412 for_each_obj_request_from(img_request, obj_request) {
2414 rbd_assert(which < img_request->obj_request_count);
2416 if (!obj_request_done_test(obj_request))
2418 more = rbd_img_obj_end_request(obj_request);
2422 rbd_assert(more ^ (which == img_request->obj_request_count));
2423 img_request->next_completion = which;
2425 spin_unlock_irq(&img_request->completion_lock);
2426 rbd_img_request_put(img_request);
2429 rbd_img_request_complete(img_request);
2433 * Add individual osd ops to the given ceph_osd_request and prepare
2434 * them for submission. num_ops is the current number of
2435 * osd operations already to the object request.
2437 static void rbd_img_obj_request_fill(struct rbd_obj_request *obj_request,
2438 struct ceph_osd_request *osd_request,
2439 enum obj_operation_type op_type,
2440 unsigned int num_ops)
2442 struct rbd_img_request *img_request = obj_request->img_request;
2443 struct rbd_device *rbd_dev = img_request->rbd_dev;
2444 u64 object_size = rbd_obj_bytes(&rbd_dev->header);
2445 u64 offset = obj_request->offset;
2446 u64 length = obj_request->length;
2450 if (op_type == OBJ_OP_DISCARD) {
2451 if (!offset && length == object_size &&
2452 (!img_request_layered_test(img_request) ||
2453 !obj_request_overlaps_parent(obj_request))) {
2454 opcode = CEPH_OSD_OP_DELETE;
2455 } else if ((offset + length == object_size)) {
2456 opcode = CEPH_OSD_OP_TRUNCATE;
2458 down_read(&rbd_dev->header_rwsem);
2459 img_end = rbd_dev->header.image_size;
2460 up_read(&rbd_dev->header_rwsem);
2462 if (obj_request->img_offset + length == img_end)
2463 opcode = CEPH_OSD_OP_TRUNCATE;
2465 opcode = CEPH_OSD_OP_ZERO;
2467 } else if (op_type == OBJ_OP_WRITE) {
2468 if (!offset && length == object_size)
2469 opcode = CEPH_OSD_OP_WRITEFULL;
2471 opcode = CEPH_OSD_OP_WRITE;
2472 osd_req_op_alloc_hint_init(osd_request, num_ops,
2473 object_size, object_size);
2476 opcode = CEPH_OSD_OP_READ;
2479 if (opcode == CEPH_OSD_OP_DELETE)
2480 osd_req_op_init(osd_request, num_ops, opcode, 0);
2482 osd_req_op_extent_init(osd_request, num_ops, opcode,
2483 offset, length, 0, 0);
2485 if (obj_request->type == OBJ_REQUEST_BIO)
2486 osd_req_op_extent_osd_data_bio(osd_request, num_ops,
2487 obj_request->bio_list, length);
2488 else if (obj_request->type == OBJ_REQUEST_PAGES)
2489 osd_req_op_extent_osd_data_pages(osd_request, num_ops,
2490 obj_request->pages, length,
2491 offset & ~PAGE_MASK, false, false);
2493 /* Discards are also writes */
2494 if (op_type == OBJ_OP_WRITE || op_type == OBJ_OP_DISCARD)
2495 rbd_osd_req_format_write(obj_request);
2497 rbd_osd_req_format_read(obj_request);
2501 * Split up an image request into one or more object requests, each
2502 * to a different object. The "type" parameter indicates whether
2503 * "data_desc" is the pointer to the head of a list of bio
2504 * structures, or the base of a page array. In either case this
2505 * function assumes data_desc describes memory sufficient to hold
2506 * all data described by the image request.
2508 static int rbd_img_request_fill(struct rbd_img_request *img_request,
2509 enum obj_request_type type,
2512 struct rbd_device *rbd_dev = img_request->rbd_dev;
2513 struct rbd_obj_request *obj_request = NULL;
2514 struct rbd_obj_request *next_obj_request;
2515 struct bio *bio_list = NULL;
2516 unsigned int bio_offset = 0;
2517 struct page **pages = NULL;
2518 enum obj_operation_type op_type;
2522 dout("%s: img %p type %d data_desc %p\n", __func__, img_request,
2523 (int)type, data_desc);
2525 img_offset = img_request->offset;
2526 resid = img_request->length;
2527 rbd_assert(resid > 0);
2528 op_type = rbd_img_request_op_type(img_request);
2530 if (type == OBJ_REQUEST_BIO) {
2531 bio_list = data_desc;
2532 rbd_assert(img_offset ==
2533 bio_list->bi_iter.bi_sector << SECTOR_SHIFT);
2534 } else if (type == OBJ_REQUEST_PAGES) {
2539 struct ceph_osd_request *osd_req;
2540 const char *object_name;
2544 object_name = rbd_segment_name(rbd_dev, img_offset);
2547 offset = rbd_segment_offset(rbd_dev, img_offset);
2548 length = rbd_segment_length(rbd_dev, img_offset, resid);
2549 obj_request = rbd_obj_request_create(object_name,
2550 offset, length, type);
2551 /* object request has its own copy of the object name */
2552 rbd_segment_name_free(object_name);
2557 * set obj_request->img_request before creating the
2558 * osd_request so that it gets the right snapc
2560 rbd_img_obj_request_add(img_request, obj_request);
2562 if (type == OBJ_REQUEST_BIO) {
2563 unsigned int clone_size;
2565 rbd_assert(length <= (u64)UINT_MAX);
2566 clone_size = (unsigned int)length;
2567 obj_request->bio_list =
2568 bio_chain_clone_range(&bio_list,
2572 if (!obj_request->bio_list)
2574 } else if (type == OBJ_REQUEST_PAGES) {
2575 unsigned int page_count;
2577 obj_request->pages = pages;
2578 page_count = (u32)calc_pages_for(offset, length);
2579 obj_request->page_count = page_count;
2580 if ((offset + length) & ~PAGE_MASK)
2581 page_count--; /* more on last page */
2582 pages += page_count;
2585 osd_req = rbd_osd_req_create(rbd_dev, op_type,
2586 (op_type == OBJ_OP_WRITE) ? 2 : 1,
2591 obj_request->osd_req = osd_req;
2592 obj_request->callback = rbd_img_obj_callback;
2593 obj_request->img_offset = img_offset;
2595 rbd_img_obj_request_fill(obj_request, osd_req, op_type, 0);
2597 img_offset += length;
2604 for_each_obj_request_safe(img_request, obj_request, next_obj_request)
2605 rbd_img_obj_request_del(img_request, obj_request);
2611 rbd_osd_copyup_callback(struct rbd_obj_request *obj_request)
2613 struct rbd_img_request *img_request;
2614 struct rbd_device *rbd_dev;
2615 struct page **pages;
2618 dout("%s: obj %p\n", __func__, obj_request);
2620 rbd_assert(obj_request->type == OBJ_REQUEST_BIO ||
2621 obj_request->type == OBJ_REQUEST_NODATA);
2622 rbd_assert(obj_request_img_data_test(obj_request));
2623 img_request = obj_request->img_request;
2624 rbd_assert(img_request);
2626 rbd_dev = img_request->rbd_dev;
2627 rbd_assert(rbd_dev);
2629 pages = obj_request->copyup_pages;
2630 rbd_assert(pages != NULL);
2631 obj_request->copyup_pages = NULL;
2632 page_count = obj_request->copyup_page_count;
2633 rbd_assert(page_count);
2634 obj_request->copyup_page_count = 0;
2635 ceph_release_page_vector(pages, page_count);
2638 * We want the transfer count to reflect the size of the
2639 * original write request. There is no such thing as a
2640 * successful short write, so if the request was successful
2641 * we can just set it to the originally-requested length.
2643 if (!obj_request->result)
2644 obj_request->xferred = obj_request->length;
2646 obj_request_done_set(obj_request);
2650 rbd_img_obj_parent_read_full_callback(struct rbd_img_request *img_request)
2652 struct rbd_obj_request *orig_request;
2653 struct ceph_osd_request *osd_req;
2654 struct rbd_device *rbd_dev;
2655 struct page **pages;
2656 enum obj_operation_type op_type;
2661 rbd_assert(img_request_child_test(img_request));
2663 /* First get what we need from the image request */
2665 pages = img_request->copyup_pages;
2666 rbd_assert(pages != NULL);
2667 img_request->copyup_pages = NULL;
2668 page_count = img_request->copyup_page_count;
2669 rbd_assert(page_count);
2670 img_request->copyup_page_count = 0;
2672 orig_request = img_request->obj_request;
2673 rbd_assert(orig_request != NULL);
2674 rbd_assert(obj_request_type_valid(orig_request->type));
2675 img_result = img_request->result;
2676 parent_length = img_request->length;
2677 rbd_assert(parent_length == img_request->xferred);
2678 rbd_img_request_put(img_request);
2680 rbd_assert(orig_request->img_request);
2681 rbd_dev = orig_request->img_request->rbd_dev;
2682 rbd_assert(rbd_dev);
2685 * If the overlap has become 0 (most likely because the
2686 * image has been flattened) we need to free the pages
2687 * and re-submit the original write request.
2689 if (!rbd_dev->parent_overlap) {
2690 ceph_release_page_vector(pages, page_count);
2691 rbd_obj_request_submit(orig_request);
2699 * The original osd request is of no use to use any more.
2700 * We need a new one that can hold the three ops in a copyup
2701 * request. Allocate the new copyup osd request for the
2702 * original request, and release the old one.
2704 img_result = -ENOMEM;
2705 osd_req = rbd_osd_req_create_copyup(orig_request);
2708 rbd_osd_req_destroy(orig_request->osd_req);
2709 orig_request->osd_req = osd_req;
2710 orig_request->copyup_pages = pages;
2711 orig_request->copyup_page_count = page_count;
2713 /* Initialize the copyup op */
2715 osd_req_op_cls_init(osd_req, 0, CEPH_OSD_OP_CALL, "rbd", "copyup");
2716 osd_req_op_cls_request_data_pages(osd_req, 0, pages, parent_length, 0,
2719 /* Add the other op(s) */
2721 op_type = rbd_img_request_op_type(orig_request->img_request);
2722 rbd_img_obj_request_fill(orig_request, osd_req, op_type, 1);
2724 /* All set, send it off. */
2726 rbd_obj_request_submit(orig_request);
2730 orig_request->result = img_result;
2731 orig_request->xferred = 0;
2732 rbd_img_request_get(orig_request->img_request);
2733 obj_request_done_set(orig_request);
2734 rbd_obj_request_complete(orig_request);
2738 * Read from the parent image the range of data that covers the
2739 * entire target of the given object request. This is used for
2740 * satisfying a layered image write request when the target of an
2741 * object request from the image request does not exist.
2743 * A page array big enough to hold the returned data is allocated
2744 * and supplied to rbd_img_request_fill() as the "data descriptor."
2745 * When the read completes, this page array will be transferred to
2746 * the original object request for the copyup operation.
2748 * If an error occurs, it is recorded as the result of the original
2749 * object request in rbd_img_obj_exists_callback().
2751 static int rbd_img_obj_parent_read_full(struct rbd_obj_request *obj_request)
2753 struct rbd_device *rbd_dev = obj_request->img_request->rbd_dev;
2754 struct rbd_img_request *parent_request = NULL;
2757 struct page **pages = NULL;
2761 rbd_assert(rbd_dev->parent != NULL);
2764 * Determine the byte range covered by the object in the
2765 * child image to which the original request was to be sent.
2767 img_offset = obj_request->img_offset - obj_request->offset;
2768 length = (u64)1 << rbd_dev->header.obj_order;
2771 * There is no defined parent data beyond the parent
2772 * overlap, so limit what we read at that boundary if
2775 if (img_offset + length > rbd_dev->parent_overlap) {
2776 rbd_assert(img_offset < rbd_dev->parent_overlap);
2777 length = rbd_dev->parent_overlap - img_offset;
2781 * Allocate a page array big enough to receive the data read
2784 page_count = (u32)calc_pages_for(0, length);
2785 pages = ceph_alloc_page_vector(page_count, GFP_KERNEL);
2786 if (IS_ERR(pages)) {
2787 result = PTR_ERR(pages);
2793 parent_request = rbd_parent_request_create(obj_request,
2794 img_offset, length);
2795 if (!parent_request)
2798 result = rbd_img_request_fill(parent_request, OBJ_REQUEST_PAGES, pages);
2802 parent_request->copyup_pages = pages;
2803 parent_request->copyup_page_count = page_count;
2804 parent_request->callback = rbd_img_obj_parent_read_full_callback;
2806 result = rbd_img_request_submit(parent_request);
2810 parent_request->copyup_pages = NULL;
2811 parent_request->copyup_page_count = 0;
2812 parent_request->obj_request = NULL;
2813 rbd_obj_request_put(obj_request);
2816 ceph_release_page_vector(pages, page_count);
2818 rbd_img_request_put(parent_request);
2822 static void rbd_img_obj_exists_callback(struct rbd_obj_request *obj_request)
2824 struct rbd_obj_request *orig_request;
2825 struct rbd_device *rbd_dev;
2828 rbd_assert(!obj_request_img_data_test(obj_request));
2831 * All we need from the object request is the original
2832 * request and the result of the STAT op. Grab those, then
2833 * we're done with the request.
2835 orig_request = obj_request->obj_request;
2836 obj_request->obj_request = NULL;
2837 rbd_obj_request_put(orig_request);
2838 rbd_assert(orig_request);
2839 rbd_assert(orig_request->img_request);
2841 result = obj_request->result;
2842 obj_request->result = 0;
2844 dout("%s: obj %p for obj %p result %d %llu/%llu\n", __func__,
2845 obj_request, orig_request, result,
2846 obj_request->xferred, obj_request->length);
2847 rbd_obj_request_put(obj_request);
2850 * If the overlap has become 0 (most likely because the
2851 * image has been flattened) we need to re-submit the
2854 rbd_dev = orig_request->img_request->rbd_dev;
2855 if (!rbd_dev->parent_overlap) {
2856 rbd_obj_request_submit(orig_request);
2861 * Our only purpose here is to determine whether the object
2862 * exists, and we don't want to treat the non-existence as
2863 * an error. If something else comes back, transfer the
2864 * error to the original request and complete it now.
2867 obj_request_existence_set(orig_request, true);
2868 } else if (result == -ENOENT) {
2869 obj_request_existence_set(orig_request, false);
2871 goto fail_orig_request;
2875 * Resubmit the original request now that we have recorded
2876 * whether the target object exists.
2878 result = rbd_img_obj_request_submit(orig_request);
2880 goto fail_orig_request;
2885 orig_request->result = result;
2886 orig_request->xferred = 0;
2887 rbd_img_request_get(orig_request->img_request);
2888 obj_request_done_set(orig_request);
2889 rbd_obj_request_complete(orig_request);
2892 static int rbd_img_obj_exists_submit(struct rbd_obj_request *obj_request)
2894 struct rbd_device *rbd_dev = obj_request->img_request->rbd_dev;
2895 struct rbd_obj_request *stat_request;
2896 struct page **pages = NULL;
2902 * The response data for a STAT call consists of:
2909 size = sizeof (__le64) + sizeof (__le32) + sizeof (__le32);
2910 page_count = (u32)calc_pages_for(0, size);
2911 pages = ceph_alloc_page_vector(page_count, GFP_KERNEL);
2913 return PTR_ERR(pages);
2916 stat_request = rbd_obj_request_create(obj_request->object_name, 0, 0,
2921 rbd_obj_request_get(obj_request);
2922 stat_request->obj_request = obj_request;
2923 stat_request->pages = pages;
2924 stat_request->page_count = page_count;
2926 stat_request->osd_req = rbd_osd_req_create(rbd_dev, OBJ_OP_READ, 1,
2928 if (!stat_request->osd_req)
2930 stat_request->callback = rbd_img_obj_exists_callback;
2932 osd_req_op_init(stat_request->osd_req, 0, CEPH_OSD_OP_STAT, 0);
2933 osd_req_op_raw_data_in_pages(stat_request->osd_req, 0, pages, size, 0,
2935 rbd_osd_req_format_read(stat_request);
2937 rbd_obj_request_submit(stat_request);
2942 rbd_obj_request_put(obj_request);
2947 static bool img_obj_request_simple(struct rbd_obj_request *obj_request)
2949 struct rbd_img_request *img_request = obj_request->img_request;
2950 struct rbd_device *rbd_dev = img_request->rbd_dev;
2953 if (!img_request_write_test(img_request) &&
2954 !img_request_discard_test(img_request))
2957 /* Non-layered writes */
2958 if (!img_request_layered_test(img_request))
2962 * Layered writes outside of the parent overlap range don't
2963 * share any data with the parent.
2965 if (!obj_request_overlaps_parent(obj_request))
2969 * Entire-object layered writes - we will overwrite whatever
2970 * parent data there is anyway.
2972 if (!obj_request->offset &&
2973 obj_request->length == rbd_obj_bytes(&rbd_dev->header))
2977 * If the object is known to already exist, its parent data has
2978 * already been copied.
2980 if (obj_request_known_test(obj_request) &&
2981 obj_request_exists_test(obj_request))
2987 static int rbd_img_obj_request_submit(struct rbd_obj_request *obj_request)
2989 rbd_assert(obj_request_img_data_test(obj_request));
2990 rbd_assert(obj_request_type_valid(obj_request->type));
2991 rbd_assert(obj_request->img_request);
2993 if (img_obj_request_simple(obj_request)) {
2994 rbd_obj_request_submit(obj_request);
2999 * It's a layered write. The target object might exist but
3000 * we may not know that yet. If we know it doesn't exist,
3001 * start by reading the data for the full target object from
3002 * the parent so we can use it for a copyup to the target.
3004 if (obj_request_known_test(obj_request))
3005 return rbd_img_obj_parent_read_full(obj_request);
3007 /* We don't know whether the target exists. Go find out. */
3009 return rbd_img_obj_exists_submit(obj_request);
3012 static int rbd_img_request_submit(struct rbd_img_request *img_request)
3014 struct rbd_obj_request *obj_request;
3015 struct rbd_obj_request *next_obj_request;
3018 dout("%s: img %p\n", __func__, img_request);
3020 rbd_img_request_get(img_request);
3021 for_each_obj_request_safe(img_request, obj_request, next_obj_request) {
3022 ret = rbd_img_obj_request_submit(obj_request);
3028 rbd_img_request_put(img_request);
3032 static void rbd_img_parent_read_callback(struct rbd_img_request *img_request)
3034 struct rbd_obj_request *obj_request;
3035 struct rbd_device *rbd_dev;
3040 rbd_assert(img_request_child_test(img_request));
3042 /* First get what we need from the image request and release it */
3044 obj_request = img_request->obj_request;
3045 img_xferred = img_request->xferred;
3046 img_result = img_request->result;
3047 rbd_img_request_put(img_request);
3050 * If the overlap has become 0 (most likely because the
3051 * image has been flattened) we need to re-submit the
3054 rbd_assert(obj_request);
3055 rbd_assert(obj_request->img_request);
3056 rbd_dev = obj_request->img_request->rbd_dev;
3057 if (!rbd_dev->parent_overlap) {
3058 rbd_obj_request_submit(obj_request);
3062 obj_request->result = img_result;
3063 if (obj_request->result)
3067 * We need to zero anything beyond the parent overlap
3068 * boundary. Since rbd_img_obj_request_read_callback()
3069 * will zero anything beyond the end of a short read, an
3070 * easy way to do this is to pretend the data from the
3071 * parent came up short--ending at the overlap boundary.
3073 rbd_assert(obj_request->img_offset < U64_MAX - obj_request->length);
3074 obj_end = obj_request->img_offset + obj_request->length;
3075 if (obj_end > rbd_dev->parent_overlap) {
3078 if (obj_request->img_offset < rbd_dev->parent_overlap)
3079 xferred = rbd_dev->parent_overlap -
3080 obj_request->img_offset;
3082 obj_request->xferred = min(img_xferred, xferred);
3084 obj_request->xferred = img_xferred;
3087 rbd_img_obj_request_read_callback(obj_request);
3088 rbd_obj_request_complete(obj_request);
3091 static void rbd_img_parent_read(struct rbd_obj_request *obj_request)
3093 struct rbd_img_request *img_request;
3096 rbd_assert(obj_request_img_data_test(obj_request));
3097 rbd_assert(obj_request->img_request != NULL);
3098 rbd_assert(obj_request->result == (s32) -ENOENT);
3099 rbd_assert(obj_request_type_valid(obj_request->type));
3101 /* rbd_read_finish(obj_request, obj_request->length); */
3102 img_request = rbd_parent_request_create(obj_request,
3103 obj_request->img_offset,
3104 obj_request->length);
3109 if (obj_request->type == OBJ_REQUEST_BIO)
3110 result = rbd_img_request_fill(img_request, OBJ_REQUEST_BIO,
3111 obj_request->bio_list);
3113 result = rbd_img_request_fill(img_request, OBJ_REQUEST_PAGES,
3114 obj_request->pages);
3118 img_request->callback = rbd_img_parent_read_callback;
3119 result = rbd_img_request_submit(img_request);
3126 rbd_img_request_put(img_request);
3127 obj_request->result = result;
3128 obj_request->xferred = 0;
3129 obj_request_done_set(obj_request);
3132 static const struct rbd_client_id rbd_empty_cid;
3134 static bool rbd_cid_equal(const struct rbd_client_id *lhs,
3135 const struct rbd_client_id *rhs)
3137 return lhs->gid == rhs->gid && lhs->handle == rhs->handle;
3140 static struct rbd_client_id rbd_get_cid(struct rbd_device *rbd_dev)
3142 struct rbd_client_id cid;
3144 mutex_lock(&rbd_dev->watch_mutex);
3145 cid.gid = ceph_client_gid(rbd_dev->rbd_client->client);
3146 cid.handle = rbd_dev->watch_cookie;
3147 mutex_unlock(&rbd_dev->watch_mutex);
3152 * lock_rwsem must be held for write
3154 static void rbd_set_owner_cid(struct rbd_device *rbd_dev,
3155 const struct rbd_client_id *cid)
3157 dout("%s rbd_dev %p %llu-%llu -> %llu-%llu\n", __func__, rbd_dev,
3158 rbd_dev->owner_cid.gid, rbd_dev->owner_cid.handle,
3159 cid->gid, cid->handle);
3160 rbd_dev->owner_cid = *cid; /* struct */
3163 static void format_lock_cookie(struct rbd_device *rbd_dev, char *buf)
3165 mutex_lock(&rbd_dev->watch_mutex);
3166 sprintf(buf, "%s %llu", RBD_LOCK_COOKIE_PREFIX, rbd_dev->watch_cookie);
3167 mutex_unlock(&rbd_dev->watch_mutex);
3171 * lock_rwsem must be held for write
3173 static int rbd_lock(struct rbd_device *rbd_dev)
3175 struct ceph_osd_client *osdc = &rbd_dev->rbd_client->client->osdc;
3176 struct rbd_client_id cid = rbd_get_cid(rbd_dev);
3180 WARN_ON(__rbd_is_lock_owner(rbd_dev));
3182 format_lock_cookie(rbd_dev, cookie);
3183 ret = ceph_cls_lock(osdc, &rbd_dev->header_oid, &rbd_dev->header_oloc,
3184 RBD_LOCK_NAME, CEPH_CLS_LOCK_EXCLUSIVE, cookie,
3185 RBD_LOCK_TAG, "", 0);
3189 rbd_dev->lock_state = RBD_LOCK_STATE_LOCKED;
3190 rbd_set_owner_cid(rbd_dev, &cid);
3191 queue_work(rbd_dev->task_wq, &rbd_dev->acquired_lock_work);
3196 * lock_rwsem must be held for write
3198 static int rbd_unlock(struct rbd_device *rbd_dev)
3200 struct ceph_osd_client *osdc = &rbd_dev->rbd_client->client->osdc;
3204 WARN_ON(!__rbd_is_lock_owner(rbd_dev));
3206 rbd_dev->lock_state = RBD_LOCK_STATE_UNLOCKED;
3208 format_lock_cookie(rbd_dev, cookie);
3209 ret = ceph_cls_unlock(osdc, &rbd_dev->header_oid, &rbd_dev->header_oloc,
3210 RBD_LOCK_NAME, cookie);
3211 if (ret && ret != -ENOENT) {
3212 rbd_warn(rbd_dev, "cls_unlock failed: %d", ret);
3216 rbd_set_owner_cid(rbd_dev, &rbd_empty_cid);
3217 queue_work(rbd_dev->task_wq, &rbd_dev->released_lock_work);
3221 static int __rbd_notify_op_lock(struct rbd_device *rbd_dev,
3222 enum rbd_notify_op notify_op,
3223 struct page ***preply_pages,
3226 struct ceph_osd_client *osdc = &rbd_dev->rbd_client->client->osdc;
3227 struct rbd_client_id cid = rbd_get_cid(rbd_dev);
3228 int buf_size = 4 + 8 + 8 + CEPH_ENCODING_START_BLK_LEN;
3232 dout("%s rbd_dev %p notify_op %d\n", __func__, rbd_dev, notify_op);
3234 /* encode *LockPayload NotifyMessage (op + ClientId) */
3235 ceph_start_encoding(&p, 2, 1, buf_size - CEPH_ENCODING_START_BLK_LEN);
3236 ceph_encode_32(&p, notify_op);
3237 ceph_encode_64(&p, cid.gid);
3238 ceph_encode_64(&p, cid.handle);
3240 return ceph_osdc_notify(osdc, &rbd_dev->header_oid,
3241 &rbd_dev->header_oloc, buf, buf_size,
3242 RBD_NOTIFY_TIMEOUT, preply_pages, preply_len);
3245 static void rbd_notify_op_lock(struct rbd_device *rbd_dev,
3246 enum rbd_notify_op notify_op)
3248 struct page **reply_pages;
3251 __rbd_notify_op_lock(rbd_dev, notify_op, &reply_pages, &reply_len);
3252 ceph_release_page_vector(reply_pages, calc_pages_for(0, reply_len));
3255 static void rbd_notify_acquired_lock(struct work_struct *work)
3257 struct rbd_device *rbd_dev = container_of(work, struct rbd_device,
3258 acquired_lock_work);
3260 rbd_notify_op_lock(rbd_dev, RBD_NOTIFY_OP_ACQUIRED_LOCK);
3263 static void rbd_notify_released_lock(struct work_struct *work)
3265 struct rbd_device *rbd_dev = container_of(work, struct rbd_device,
3266 released_lock_work);
3268 rbd_notify_op_lock(rbd_dev, RBD_NOTIFY_OP_RELEASED_LOCK);
3271 static int rbd_request_lock(struct rbd_device *rbd_dev)
3273 struct page **reply_pages;
3275 bool lock_owner_responded = false;
3278 dout("%s rbd_dev %p\n", __func__, rbd_dev);
3280 ret = __rbd_notify_op_lock(rbd_dev, RBD_NOTIFY_OP_REQUEST_LOCK,
3281 &reply_pages, &reply_len);
3282 if (ret && ret != -ETIMEDOUT) {
3283 rbd_warn(rbd_dev, "failed to request lock: %d", ret);
3287 if (reply_len > 0 && reply_len <= PAGE_SIZE) {
3288 void *p = page_address(reply_pages[0]);
3289 void *const end = p + reply_len;
3292 ceph_decode_32_safe(&p, end, n, e_inval); /* num_acks */
3297 ceph_decode_need(&p, end, 8 + 8, e_inval);
3298 p += 8 + 8; /* skip gid and cookie */
3300 ceph_decode_32_safe(&p, end, len, e_inval);
3304 if (lock_owner_responded) {
3306 "duplicate lock owners detected");
3311 lock_owner_responded = true;
3312 ret = ceph_start_decoding(&p, end, 1, "ResponseMessage",
3316 "failed to decode ResponseMessage: %d",
3321 ret = ceph_decode_32(&p);
3325 if (!lock_owner_responded) {
3326 rbd_warn(rbd_dev, "no lock owners detected");
3331 ceph_release_page_vector(reply_pages, calc_pages_for(0, reply_len));
3339 static void wake_requests(struct rbd_device *rbd_dev, bool wake_all)
3341 dout("%s rbd_dev %p wake_all %d\n", __func__, rbd_dev, wake_all);
3343 cancel_delayed_work(&rbd_dev->lock_dwork);
3345 wake_up_all(&rbd_dev->lock_waitq);
3347 wake_up(&rbd_dev->lock_waitq);
3350 static int get_lock_owner_info(struct rbd_device *rbd_dev,
3351 struct ceph_locker **lockers, u32 *num_lockers)
3353 struct ceph_osd_client *osdc = &rbd_dev->rbd_client->client->osdc;
3358 dout("%s rbd_dev %p\n", __func__, rbd_dev);
3360 ret = ceph_cls_lock_info(osdc, &rbd_dev->header_oid,
3361 &rbd_dev->header_oloc, RBD_LOCK_NAME,
3362 &lock_type, &lock_tag, lockers, num_lockers);
3366 if (*num_lockers == 0) {
3367 dout("%s rbd_dev %p no lockers detected\n", __func__, rbd_dev);
3371 if (strcmp(lock_tag, RBD_LOCK_TAG)) {
3372 rbd_warn(rbd_dev, "locked by external mechanism, tag %s",
3378 if (lock_type == CEPH_CLS_LOCK_SHARED) {
3379 rbd_warn(rbd_dev, "shared lock type detected");
3384 if (strncmp((*lockers)[0].id.cookie, RBD_LOCK_COOKIE_PREFIX,
3385 strlen(RBD_LOCK_COOKIE_PREFIX))) {
3386 rbd_warn(rbd_dev, "locked by external mechanism, cookie %s",
3387 (*lockers)[0].id.cookie);
3397 static int find_watcher(struct rbd_device *rbd_dev,
3398 const struct ceph_locker *locker)
3400 struct ceph_osd_client *osdc = &rbd_dev->rbd_client->client->osdc;
3401 struct ceph_watch_item *watchers;
3407 ret = ceph_osdc_list_watchers(osdc, &rbd_dev->header_oid,
3408 &rbd_dev->header_oloc, &watchers,
3413 sscanf(locker->id.cookie, RBD_LOCK_COOKIE_PREFIX " %llu", &cookie);
3414 for (i = 0; i < num_watchers; i++) {
3415 if (!memcmp(&watchers[i].addr, &locker->info.addr,
3416 sizeof(locker->info.addr)) &&
3417 watchers[i].cookie == cookie) {
3418 struct rbd_client_id cid = {
3419 .gid = le64_to_cpu(watchers[i].name.num),
3423 dout("%s rbd_dev %p found cid %llu-%llu\n", __func__,
3424 rbd_dev, cid.gid, cid.handle);
3425 rbd_set_owner_cid(rbd_dev, &cid);
3431 dout("%s rbd_dev %p no watchers\n", __func__, rbd_dev);
3439 * lock_rwsem must be held for write
3441 static int rbd_try_lock(struct rbd_device *rbd_dev)
3443 struct ceph_client *client = rbd_dev->rbd_client->client;
3444 struct ceph_locker *lockers;
3449 ret = rbd_lock(rbd_dev);
3453 /* determine if the current lock holder is still alive */
3454 ret = get_lock_owner_info(rbd_dev, &lockers, &num_lockers);
3458 if (num_lockers == 0)
3461 ret = find_watcher(rbd_dev, lockers);
3464 ret = 0; /* have to request lock */
3468 rbd_warn(rbd_dev, "%s%llu seems dead, breaking lock",
3469 ENTITY_NAME(lockers[0].id.name));
3471 ret = ceph_monc_blacklist_add(&client->monc,
3472 &lockers[0].info.addr);
3474 rbd_warn(rbd_dev, "blacklist of %s%llu failed: %d",
3475 ENTITY_NAME(lockers[0].id.name), ret);
3479 ret = ceph_cls_break_lock(&client->osdc, &rbd_dev->header_oid,
3480 &rbd_dev->header_oloc, RBD_LOCK_NAME,
3481 lockers[0].id.cookie,
3482 &lockers[0].id.name);
3483 if (ret && ret != -ENOENT)
3487 ceph_free_lockers(lockers, num_lockers);
3491 ceph_free_lockers(lockers, num_lockers);
3496 * ret is set only if lock_state is RBD_LOCK_STATE_UNLOCKED
3498 static enum rbd_lock_state rbd_try_acquire_lock(struct rbd_device *rbd_dev,
3501 enum rbd_lock_state lock_state;
3503 down_read(&rbd_dev->lock_rwsem);
3504 dout("%s rbd_dev %p read lock_state %d\n", __func__, rbd_dev,
3505 rbd_dev->lock_state);
3506 if (__rbd_is_lock_owner(rbd_dev)) {
3507 lock_state = rbd_dev->lock_state;
3508 up_read(&rbd_dev->lock_rwsem);
3512 up_read(&rbd_dev->lock_rwsem);
3513 down_write(&rbd_dev->lock_rwsem);
3514 dout("%s rbd_dev %p write lock_state %d\n", __func__, rbd_dev,
3515 rbd_dev->lock_state);
3516 if (!__rbd_is_lock_owner(rbd_dev)) {
3517 *pret = rbd_try_lock(rbd_dev);
3519 rbd_warn(rbd_dev, "failed to acquire lock: %d", *pret);
3522 lock_state = rbd_dev->lock_state;
3523 up_write(&rbd_dev->lock_rwsem);
3527 static void rbd_acquire_lock(struct work_struct *work)
3529 struct rbd_device *rbd_dev = container_of(to_delayed_work(work),
3530 struct rbd_device, lock_dwork);
3531 enum rbd_lock_state lock_state;
3534 dout("%s rbd_dev %p\n", __func__, rbd_dev);
3536 lock_state = rbd_try_acquire_lock(rbd_dev, &ret);
3537 if (lock_state != RBD_LOCK_STATE_UNLOCKED || ret == -EBLACKLISTED) {
3538 if (lock_state == RBD_LOCK_STATE_LOCKED)
3539 wake_requests(rbd_dev, true);
3540 dout("%s rbd_dev %p lock_state %d ret %d - done\n", __func__,
3541 rbd_dev, lock_state, ret);
3545 ret = rbd_request_lock(rbd_dev);
3546 if (ret == -ETIMEDOUT) {
3547 goto again; /* treat this as a dead client */
3548 } else if (ret < 0) {
3549 rbd_warn(rbd_dev, "error requesting lock: %d", ret);
3550 mod_delayed_work(rbd_dev->task_wq, &rbd_dev->lock_dwork,
3554 * lock owner acked, but resend if we don't see them
3557 dout("%s rbd_dev %p requeueing lock_dwork\n", __func__,
3559 mod_delayed_work(rbd_dev->task_wq, &rbd_dev->lock_dwork,
3560 msecs_to_jiffies(2 * RBD_NOTIFY_TIMEOUT * MSEC_PER_SEC));
3565 * lock_rwsem must be held for write
3567 static bool rbd_release_lock(struct rbd_device *rbd_dev)
3569 dout("%s rbd_dev %p read lock_state %d\n", __func__, rbd_dev,
3570 rbd_dev->lock_state);
3571 if (rbd_dev->lock_state != RBD_LOCK_STATE_LOCKED)
3574 rbd_dev->lock_state = RBD_LOCK_STATE_RELEASING;
3575 downgrade_write(&rbd_dev->lock_rwsem);
3577 * Ensure that all in-flight IO is flushed.
3579 * FIXME: ceph_osdc_sync() flushes the entire OSD client, which
3580 * may be shared with other devices.
3582 ceph_osdc_sync(&rbd_dev->rbd_client->client->osdc);
3583 up_read(&rbd_dev->lock_rwsem);
3585 down_write(&rbd_dev->lock_rwsem);
3586 dout("%s rbd_dev %p write lock_state %d\n", __func__, rbd_dev,
3587 rbd_dev->lock_state);
3588 if (rbd_dev->lock_state != RBD_LOCK_STATE_RELEASING)
3591 if (!rbd_unlock(rbd_dev))
3593 * Give others a chance to grab the lock - we would re-acquire
3594 * almost immediately if we got new IO during ceph_osdc_sync()
3595 * otherwise. We need to ack our own notifications, so this
3596 * lock_dwork will be requeued from rbd_wait_state_locked()
3597 * after wake_requests() in rbd_handle_released_lock().
3599 cancel_delayed_work(&rbd_dev->lock_dwork);
3604 static void rbd_release_lock_work(struct work_struct *work)
3606 struct rbd_device *rbd_dev = container_of(work, struct rbd_device,
3609 down_write(&rbd_dev->lock_rwsem);
3610 rbd_release_lock(rbd_dev);
3611 up_write(&rbd_dev->lock_rwsem);
3614 static void rbd_handle_acquired_lock(struct rbd_device *rbd_dev, u8 struct_v,
3617 struct rbd_client_id cid = { 0 };
3619 if (struct_v >= 2) {
3620 cid.gid = ceph_decode_64(p);
3621 cid.handle = ceph_decode_64(p);
3624 dout("%s rbd_dev %p cid %llu-%llu\n", __func__, rbd_dev, cid.gid,
3626 if (!rbd_cid_equal(&cid, &rbd_empty_cid)) {
3627 down_write(&rbd_dev->lock_rwsem);
3628 if (rbd_cid_equal(&cid, &rbd_dev->owner_cid)) {
3630 * we already know that the remote client is
3633 up_write(&rbd_dev->lock_rwsem);
3637 rbd_set_owner_cid(rbd_dev, &cid);
3638 downgrade_write(&rbd_dev->lock_rwsem);
3640 down_read(&rbd_dev->lock_rwsem);
3643 if (!__rbd_is_lock_owner(rbd_dev))
3644 wake_requests(rbd_dev, false);
3645 up_read(&rbd_dev->lock_rwsem);
3648 static void rbd_handle_released_lock(struct rbd_device *rbd_dev, u8 struct_v,
3651 struct rbd_client_id cid = { 0 };
3653 if (struct_v >= 2) {
3654 cid.gid = ceph_decode_64(p);
3655 cid.handle = ceph_decode_64(p);
3658 dout("%s rbd_dev %p cid %llu-%llu\n", __func__, rbd_dev, cid.gid,
3660 if (!rbd_cid_equal(&cid, &rbd_empty_cid)) {
3661 down_write(&rbd_dev->lock_rwsem);
3662 if (!rbd_cid_equal(&cid, &rbd_dev->owner_cid)) {
3663 dout("%s rbd_dev %p unexpected owner, cid %llu-%llu != owner_cid %llu-%llu\n",
3664 __func__, rbd_dev, cid.gid, cid.handle,
3665 rbd_dev->owner_cid.gid, rbd_dev->owner_cid.handle);
3666 up_write(&rbd_dev->lock_rwsem);
3670 rbd_set_owner_cid(rbd_dev, &rbd_empty_cid);
3671 downgrade_write(&rbd_dev->lock_rwsem);
3673 down_read(&rbd_dev->lock_rwsem);
3676 if (!__rbd_is_lock_owner(rbd_dev))
3677 wake_requests(rbd_dev, false);
3678 up_read(&rbd_dev->lock_rwsem);
3681 static bool rbd_handle_request_lock(struct rbd_device *rbd_dev, u8 struct_v,
3684 struct rbd_client_id my_cid = rbd_get_cid(rbd_dev);
3685 struct rbd_client_id cid = { 0 };
3688 if (struct_v >= 2) {
3689 cid.gid = ceph_decode_64(p);
3690 cid.handle = ceph_decode_64(p);
3693 dout("%s rbd_dev %p cid %llu-%llu\n", __func__, rbd_dev, cid.gid,
3695 if (rbd_cid_equal(&cid, &my_cid))
3698 down_read(&rbd_dev->lock_rwsem);
3699 need_to_send = __rbd_is_lock_owner(rbd_dev);
3700 if (rbd_dev->lock_state == RBD_LOCK_STATE_LOCKED) {
3701 if (!rbd_cid_equal(&rbd_dev->owner_cid, &rbd_empty_cid)) {
3702 dout("%s rbd_dev %p queueing unlock_work\n", __func__,
3704 queue_work(rbd_dev->task_wq, &rbd_dev->unlock_work);
3707 up_read(&rbd_dev->lock_rwsem);
3708 return need_to_send;
3711 static void __rbd_acknowledge_notify(struct rbd_device *rbd_dev,
3712 u64 notify_id, u64 cookie, s32 *result)
3714 struct ceph_osd_client *osdc = &rbd_dev->rbd_client->client->osdc;
3715 int buf_size = 4 + CEPH_ENCODING_START_BLK_LEN;
3722 /* encode ResponseMessage */
3723 ceph_start_encoding(&p, 1, 1,
3724 buf_size - CEPH_ENCODING_START_BLK_LEN);
3725 ceph_encode_32(&p, *result);
3730 ret = ceph_osdc_notify_ack(osdc, &rbd_dev->header_oid,
3731 &rbd_dev->header_oloc, notify_id, cookie,
3734 rbd_warn(rbd_dev, "acknowledge_notify failed: %d", ret);
3737 static void rbd_acknowledge_notify(struct rbd_device *rbd_dev, u64 notify_id,
3740 dout("%s rbd_dev %p\n", __func__, rbd_dev);
3741 __rbd_acknowledge_notify(rbd_dev, notify_id, cookie, NULL);
3744 static void rbd_acknowledge_notify_result(struct rbd_device *rbd_dev,
3745 u64 notify_id, u64 cookie, s32 result)
3747 dout("%s rbd_dev %p result %d\n", __func__, rbd_dev, result);
3748 __rbd_acknowledge_notify(rbd_dev, notify_id, cookie, &result);
3751 static void rbd_watch_cb(void *arg, u64 notify_id, u64 cookie,
3752 u64 notifier_id, void *data, size_t data_len)
3754 struct rbd_device *rbd_dev = arg;
3756 void *const end = p + data_len;
3762 dout("%s rbd_dev %p cookie %llu notify_id %llu data_len %zu\n",
3763 __func__, rbd_dev, cookie, notify_id, data_len);
3765 ret = ceph_start_decoding(&p, end, 1, "NotifyMessage",
3768 rbd_warn(rbd_dev, "failed to decode NotifyMessage: %d",
3773 notify_op = ceph_decode_32(&p);
3775 /* legacy notification for header updates */
3776 notify_op = RBD_NOTIFY_OP_HEADER_UPDATE;
3780 dout("%s rbd_dev %p notify_op %u\n", __func__, rbd_dev, notify_op);
3781 switch (notify_op) {
3782 case RBD_NOTIFY_OP_ACQUIRED_LOCK:
3783 rbd_handle_acquired_lock(rbd_dev, struct_v, &p);
3784 rbd_acknowledge_notify(rbd_dev, notify_id, cookie);
3786 case RBD_NOTIFY_OP_RELEASED_LOCK:
3787 rbd_handle_released_lock(rbd_dev, struct_v, &p);
3788 rbd_acknowledge_notify(rbd_dev, notify_id, cookie);
3790 case RBD_NOTIFY_OP_REQUEST_LOCK:
3791 if (rbd_handle_request_lock(rbd_dev, struct_v, &p))
3793 * send ResponseMessage(0) back so the client
3794 * can detect a missing owner
3796 rbd_acknowledge_notify_result(rbd_dev, notify_id,
3799 rbd_acknowledge_notify(rbd_dev, notify_id, cookie);
3801 case RBD_NOTIFY_OP_HEADER_UPDATE:
3802 ret = rbd_dev_refresh(rbd_dev);
3804 rbd_warn(rbd_dev, "refresh failed: %d", ret);
3806 rbd_acknowledge_notify(rbd_dev, notify_id, cookie);
3809 if (rbd_is_lock_owner(rbd_dev))
3810 rbd_acknowledge_notify_result(rbd_dev, notify_id,
3811 cookie, -EOPNOTSUPP);
3813 rbd_acknowledge_notify(rbd_dev, notify_id, cookie);
3818 static void __rbd_unregister_watch(struct rbd_device *rbd_dev);
3820 static void rbd_watch_errcb(void *arg, u64 cookie, int err)
3822 struct rbd_device *rbd_dev = arg;
3824 rbd_warn(rbd_dev, "encountered watch error: %d", err);
3826 down_write(&rbd_dev->lock_rwsem);
3827 rbd_set_owner_cid(rbd_dev, &rbd_empty_cid);
3828 up_write(&rbd_dev->lock_rwsem);
3830 mutex_lock(&rbd_dev->watch_mutex);
3831 if (rbd_dev->watch_state == RBD_WATCH_STATE_REGISTERED) {
3832 __rbd_unregister_watch(rbd_dev);
3833 rbd_dev->watch_state = RBD_WATCH_STATE_ERROR;
3835 queue_delayed_work(rbd_dev->task_wq, &rbd_dev->watch_dwork, 0);
3837 mutex_unlock(&rbd_dev->watch_mutex);
3841 * watch_mutex must be locked
3843 static int __rbd_register_watch(struct rbd_device *rbd_dev)
3845 struct ceph_osd_client *osdc = &rbd_dev->rbd_client->client->osdc;
3846 struct ceph_osd_linger_request *handle;
3848 rbd_assert(!rbd_dev->watch_handle);
3849 dout("%s rbd_dev %p\n", __func__, rbd_dev);
3851 handle = ceph_osdc_watch(osdc, &rbd_dev->header_oid,
3852 &rbd_dev->header_oloc, rbd_watch_cb,
3853 rbd_watch_errcb, rbd_dev);
3855 return PTR_ERR(handle);
3857 rbd_dev->watch_handle = handle;
3862 * watch_mutex must be locked
3864 static void __rbd_unregister_watch(struct rbd_device *rbd_dev)
3866 struct ceph_osd_client *osdc = &rbd_dev->rbd_client->client->osdc;
3869 rbd_assert(rbd_dev->watch_handle);
3870 dout("%s rbd_dev %p\n", __func__, rbd_dev);
3872 ret = ceph_osdc_unwatch(osdc, rbd_dev->watch_handle);
3874 rbd_warn(rbd_dev, "failed to unwatch: %d", ret);
3876 rbd_dev->watch_handle = NULL;
3879 static int rbd_register_watch(struct rbd_device *rbd_dev)
3883 mutex_lock(&rbd_dev->watch_mutex);
3884 rbd_assert(rbd_dev->watch_state == RBD_WATCH_STATE_UNREGISTERED);
3885 ret = __rbd_register_watch(rbd_dev);
3889 rbd_dev->watch_state = RBD_WATCH_STATE_REGISTERED;
3890 rbd_dev->watch_cookie = rbd_dev->watch_handle->linger_id;
3893 mutex_unlock(&rbd_dev->watch_mutex);
3897 static void cancel_tasks_sync(struct rbd_device *rbd_dev)
3899 dout("%s rbd_dev %p\n", __func__, rbd_dev);
3901 cancel_delayed_work_sync(&rbd_dev->watch_dwork);
3902 cancel_work_sync(&rbd_dev->acquired_lock_work);
3903 cancel_work_sync(&rbd_dev->released_lock_work);
3904 cancel_delayed_work_sync(&rbd_dev->lock_dwork);
3905 cancel_work_sync(&rbd_dev->unlock_work);
3908 static void rbd_unregister_watch(struct rbd_device *rbd_dev)
3910 WARN_ON(waitqueue_active(&rbd_dev->lock_waitq));
3911 cancel_tasks_sync(rbd_dev);
3913 mutex_lock(&rbd_dev->watch_mutex);
3914 if (rbd_dev->watch_state == RBD_WATCH_STATE_REGISTERED)
3915 __rbd_unregister_watch(rbd_dev);
3916 rbd_dev->watch_state = RBD_WATCH_STATE_UNREGISTERED;
3917 mutex_unlock(&rbd_dev->watch_mutex);
3919 ceph_osdc_flush_notifies(&rbd_dev->rbd_client->client->osdc);
3922 static void rbd_reregister_watch(struct work_struct *work)
3924 struct rbd_device *rbd_dev = container_of(to_delayed_work(work),
3925 struct rbd_device, watch_dwork);
3926 bool was_lock_owner = false;
3929 dout("%s rbd_dev %p\n", __func__, rbd_dev);
3931 down_write(&rbd_dev->lock_rwsem);
3932 if (rbd_dev->lock_state == RBD_LOCK_STATE_LOCKED)
3933 was_lock_owner = rbd_release_lock(rbd_dev);
3935 mutex_lock(&rbd_dev->watch_mutex);
3936 if (rbd_dev->watch_state != RBD_WATCH_STATE_ERROR)
3939 ret = __rbd_register_watch(rbd_dev);
3941 rbd_warn(rbd_dev, "failed to reregister watch: %d", ret);
3942 if (ret != -EBLACKLISTED)
3943 queue_delayed_work(rbd_dev->task_wq,
3944 &rbd_dev->watch_dwork,
3949 rbd_dev->watch_state = RBD_WATCH_STATE_REGISTERED;
3950 rbd_dev->watch_cookie = rbd_dev->watch_handle->linger_id;
3951 mutex_unlock(&rbd_dev->watch_mutex);
3953 ret = rbd_dev_refresh(rbd_dev);
3955 rbd_warn(rbd_dev, "reregisteration refresh failed: %d", ret);
3957 if (was_lock_owner) {
3958 ret = rbd_try_lock(rbd_dev);
3960 rbd_warn(rbd_dev, "reregisteration lock failed: %d",
3964 up_write(&rbd_dev->lock_rwsem);
3965 wake_requests(rbd_dev, true);
3969 mutex_unlock(&rbd_dev->watch_mutex);
3970 up_write(&rbd_dev->lock_rwsem);
3974 * Synchronous osd object method call. Returns the number of bytes
3975 * returned in the outbound buffer, or a negative error code.
3977 static int rbd_obj_method_sync(struct rbd_device *rbd_dev,
3978 const char *object_name,
3979 const char *class_name,
3980 const char *method_name,
3981 const void *outbound,
3982 size_t outbound_size,
3984 size_t inbound_size)
3986 struct rbd_obj_request *obj_request;
3987 struct page **pages;
3992 * Method calls are ultimately read operations. The result
3993 * should placed into the inbound buffer provided. They
3994 * also supply outbound data--parameters for the object
3995 * method. Currently if this is present it will be a
3998 page_count = (u32)calc_pages_for(0, inbound_size);
3999 pages = ceph_alloc_page_vector(page_count, GFP_KERNEL);
4001 return PTR_ERR(pages);
4004 obj_request = rbd_obj_request_create(object_name, 0, inbound_size,
4009 obj_request->pages = pages;
4010 obj_request->page_count = page_count;
4012 obj_request->osd_req = rbd_osd_req_create(rbd_dev, OBJ_OP_READ, 1,
4014 if (!obj_request->osd_req)
4017 osd_req_op_cls_init(obj_request->osd_req, 0, CEPH_OSD_OP_CALL,
4018 class_name, method_name);
4019 if (outbound_size) {
4020 struct ceph_pagelist *pagelist;
4022 pagelist = kmalloc(sizeof (*pagelist), GFP_NOFS);
4026 ceph_pagelist_init(pagelist);
4027 ceph_pagelist_append(pagelist, outbound, outbound_size);
4028 osd_req_op_cls_request_data_pagelist(obj_request->osd_req, 0,
4031 osd_req_op_cls_response_data_pages(obj_request->osd_req, 0,
4032 obj_request->pages, inbound_size,
4034 rbd_osd_req_format_read(obj_request);
4036 rbd_obj_request_submit(obj_request);
4037 ret = rbd_obj_request_wait(obj_request);
4041 ret = obj_request->result;
4045 rbd_assert(obj_request->xferred < (u64)INT_MAX);
4046 ret = (int)obj_request->xferred;
4047 ceph_copy_from_page_vector(pages, inbound, 0, obj_request->xferred);
4050 rbd_obj_request_put(obj_request);
4052 ceph_release_page_vector(pages, page_count);
4058 * lock_rwsem must be held for read
4060 static void rbd_wait_state_locked(struct rbd_device *rbd_dev)
4066 * Note the use of mod_delayed_work() in rbd_acquire_lock()
4067 * and cancel_delayed_work() in wake_requests().
4069 dout("%s rbd_dev %p queueing lock_dwork\n", __func__, rbd_dev);
4070 queue_delayed_work(rbd_dev->task_wq, &rbd_dev->lock_dwork, 0);
4071 prepare_to_wait_exclusive(&rbd_dev->lock_waitq, &wait,
4072 TASK_UNINTERRUPTIBLE);
4073 up_read(&rbd_dev->lock_rwsem);
4075 down_read(&rbd_dev->lock_rwsem);
4076 } while (rbd_dev->lock_state != RBD_LOCK_STATE_LOCKED);
4077 finish_wait(&rbd_dev->lock_waitq, &wait);
4080 static void rbd_queue_workfn(struct work_struct *work)
4082 struct request *rq = blk_mq_rq_from_pdu(work);
4083 struct rbd_device *rbd_dev = rq->q->queuedata;
4084 struct rbd_img_request *img_request;
4085 struct ceph_snap_context *snapc = NULL;
4086 u64 offset = (u64)blk_rq_pos(rq) << SECTOR_SHIFT;
4087 u64 length = blk_rq_bytes(rq);
4088 enum obj_operation_type op_type;
4090 bool must_be_locked;
4093 if (rq->cmd_type != REQ_TYPE_FS) {
4094 dout("%s: non-fs request type %d\n", __func__,
4095 (int) rq->cmd_type);
4100 if (req_op(rq) == REQ_OP_DISCARD)
4101 op_type = OBJ_OP_DISCARD;
4102 else if (req_op(rq) == REQ_OP_WRITE)
4103 op_type = OBJ_OP_WRITE;
4105 op_type = OBJ_OP_READ;
4107 /* Ignore/skip any zero-length requests */
4110 dout("%s: zero-length request\n", __func__);
4115 /* Only reads are allowed to a read-only device */
4117 if (op_type != OBJ_OP_READ) {
4118 if (rbd_dev->mapping.read_only) {
4122 rbd_assert(rbd_dev->spec->snap_id == CEPH_NOSNAP);
4126 * Quit early if the mapped snapshot no longer exists. It's
4127 * still possible the snapshot will have disappeared by the
4128 * time our request arrives at the osd, but there's no sense in
4129 * sending it if we already know.
4131 if (!test_bit(RBD_DEV_FLAG_EXISTS, &rbd_dev->flags)) {
4132 dout("request for non-existent snapshot");
4133 rbd_assert(rbd_dev->spec->snap_id != CEPH_NOSNAP);
4138 if (offset && length > U64_MAX - offset + 1) {
4139 rbd_warn(rbd_dev, "bad request range (%llu~%llu)", offset,
4142 goto err_rq; /* Shouldn't happen */
4145 blk_mq_start_request(rq);
4147 down_read(&rbd_dev->header_rwsem);
4148 mapping_size = rbd_dev->mapping.size;
4149 if (op_type != OBJ_OP_READ) {
4150 snapc = rbd_dev->header.snapc;
4151 ceph_get_snap_context(snapc);
4152 must_be_locked = rbd_is_lock_supported(rbd_dev);
4154 must_be_locked = rbd_dev->opts->lock_on_read &&
4155 rbd_is_lock_supported(rbd_dev);
4157 up_read(&rbd_dev->header_rwsem);
4159 if (offset + length > mapping_size) {
4160 rbd_warn(rbd_dev, "beyond EOD (%llu~%llu > %llu)", offset,
4161 length, mapping_size);
4166 if (must_be_locked) {
4167 down_read(&rbd_dev->lock_rwsem);
4168 if (rbd_dev->lock_state != RBD_LOCK_STATE_LOCKED)
4169 rbd_wait_state_locked(rbd_dev);
4172 img_request = rbd_img_request_create(rbd_dev, offset, length, op_type,
4178 img_request->rq = rq;
4179 snapc = NULL; /* img_request consumes a ref */
4181 if (op_type == OBJ_OP_DISCARD)
4182 result = rbd_img_request_fill(img_request, OBJ_REQUEST_NODATA,
4185 result = rbd_img_request_fill(img_request, OBJ_REQUEST_BIO,
4188 goto err_img_request;
4190 result = rbd_img_request_submit(img_request);
4192 goto err_img_request;
4195 up_read(&rbd_dev->lock_rwsem);
4199 rbd_img_request_put(img_request);
4202 up_read(&rbd_dev->lock_rwsem);
4205 rbd_warn(rbd_dev, "%s %llx at %llx result %d",
4206 obj_op_name(op_type), length, offset, result);
4207 ceph_put_snap_context(snapc);
4209 blk_mq_end_request(rq, result);
4212 static int rbd_queue_rq(struct blk_mq_hw_ctx *hctx,
4213 const struct blk_mq_queue_data *bd)
4215 struct request *rq = bd->rq;
4216 struct work_struct *work = blk_mq_rq_to_pdu(rq);
4218 queue_work(rbd_wq, work);
4219 return BLK_MQ_RQ_QUEUE_OK;
4222 static void rbd_free_disk(struct rbd_device *rbd_dev)
4224 struct gendisk *disk = rbd_dev->disk;
4229 rbd_dev->disk = NULL;
4230 if (disk->flags & GENHD_FL_UP) {
4233 blk_cleanup_queue(disk->queue);
4234 blk_mq_free_tag_set(&rbd_dev->tag_set);
4239 static int rbd_obj_read_sync(struct rbd_device *rbd_dev,
4240 const char *object_name,
4241 u64 offset, u64 length, void *buf)
4244 struct rbd_obj_request *obj_request;
4245 struct page **pages = NULL;
4250 page_count = (u32) calc_pages_for(offset, length);
4251 pages = ceph_alloc_page_vector(page_count, GFP_KERNEL);
4253 return PTR_ERR(pages);
4256 obj_request = rbd_obj_request_create(object_name, offset, length,
4261 obj_request->pages = pages;
4262 obj_request->page_count = page_count;
4264 obj_request->osd_req = rbd_osd_req_create(rbd_dev, OBJ_OP_READ, 1,
4266 if (!obj_request->osd_req)
4269 osd_req_op_extent_init(obj_request->osd_req, 0, CEPH_OSD_OP_READ,
4270 offset, length, 0, 0);
4271 osd_req_op_extent_osd_data_pages(obj_request->osd_req, 0,
4273 obj_request->length,
4274 obj_request->offset & ~PAGE_MASK,
4276 rbd_osd_req_format_read(obj_request);
4278 rbd_obj_request_submit(obj_request);
4279 ret = rbd_obj_request_wait(obj_request);
4283 ret = obj_request->result;
4287 rbd_assert(obj_request->xferred <= (u64) SIZE_MAX);
4288 size = (size_t) obj_request->xferred;
4289 ceph_copy_from_page_vector(pages, buf, 0, size);
4290 rbd_assert(size <= (size_t)INT_MAX);
4294 rbd_obj_request_put(obj_request);
4296 ceph_release_page_vector(pages, page_count);
4302 * Read the complete header for the given rbd device. On successful
4303 * return, the rbd_dev->header field will contain up-to-date
4304 * information about the image.
4306 static int rbd_dev_v1_header_info(struct rbd_device *rbd_dev)
4308 struct rbd_image_header_ondisk *ondisk = NULL;
4315 * The complete header will include an array of its 64-bit
4316 * snapshot ids, followed by the names of those snapshots as
4317 * a contiguous block of NUL-terminated strings. Note that
4318 * the number of snapshots could change by the time we read
4319 * it in, in which case we re-read it.
4326 size = sizeof (*ondisk);
4327 size += snap_count * sizeof (struct rbd_image_snap_ondisk);
4329 ondisk = kmalloc(size, GFP_KERNEL);
4333 ret = rbd_obj_read_sync(rbd_dev, rbd_dev->header_oid.name,
4337 if ((size_t)ret < size) {
4339 rbd_warn(rbd_dev, "short header read (want %zd got %d)",
4343 if (!rbd_dev_ondisk_valid(ondisk)) {
4345 rbd_warn(rbd_dev, "invalid header");
4349 names_size = le64_to_cpu(ondisk->snap_names_len);
4350 want_count = snap_count;
4351 snap_count = le32_to_cpu(ondisk->snap_count);
4352 } while (snap_count != want_count);
4354 ret = rbd_header_from_disk(rbd_dev, ondisk);
4362 * Clear the rbd device's EXISTS flag if the snapshot it's mapped to
4363 * has disappeared from the (just updated) snapshot context.
4365 static void rbd_exists_validate(struct rbd_device *rbd_dev)
4369 if (!test_bit(RBD_DEV_FLAG_EXISTS, &rbd_dev->flags))
4372 snap_id = rbd_dev->spec->snap_id;
4373 if (snap_id == CEPH_NOSNAP)
4376 if (rbd_dev_snap_index(rbd_dev, snap_id) == BAD_SNAP_INDEX)
4377 clear_bit(RBD_DEV_FLAG_EXISTS, &rbd_dev->flags);
4380 static void rbd_dev_update_size(struct rbd_device *rbd_dev)
4385 * If EXISTS is not set, rbd_dev->disk may be NULL, so don't
4386 * try to update its size. If REMOVING is set, updating size
4387 * is just useless work since the device can't be opened.
4389 if (test_bit(RBD_DEV_FLAG_EXISTS, &rbd_dev->flags) &&
4390 !test_bit(RBD_DEV_FLAG_REMOVING, &rbd_dev->flags)) {
4391 size = (sector_t)rbd_dev->mapping.size / SECTOR_SIZE;
4392 dout("setting size to %llu sectors", (unsigned long long)size);
4393 set_capacity(rbd_dev->disk, size);
4394 revalidate_disk(rbd_dev->disk);
4398 static int rbd_dev_refresh(struct rbd_device *rbd_dev)
4403 down_write(&rbd_dev->header_rwsem);
4404 mapping_size = rbd_dev->mapping.size;
4406 ret = rbd_dev_header_info(rbd_dev);
4411 * If there is a parent, see if it has disappeared due to the
4412 * mapped image getting flattened.
4414 if (rbd_dev->parent) {
4415 ret = rbd_dev_v2_parent_info(rbd_dev);
4420 if (rbd_dev->spec->snap_id == CEPH_NOSNAP) {
4421 rbd_dev->mapping.size = rbd_dev->header.image_size;
4423 /* validate mapped snapshot's EXISTS flag */
4424 rbd_exists_validate(rbd_dev);
4428 up_write(&rbd_dev->header_rwsem);
4429 if (!ret && mapping_size != rbd_dev->mapping.size)
4430 rbd_dev_update_size(rbd_dev);
4435 static int rbd_init_request(void *data, struct request *rq,
4436 unsigned int hctx_idx, unsigned int request_idx,
4437 unsigned int numa_node)
4439 struct work_struct *work = blk_mq_rq_to_pdu(rq);
4441 INIT_WORK(work, rbd_queue_workfn);
4445 static struct blk_mq_ops rbd_mq_ops = {
4446 .queue_rq = rbd_queue_rq,
4447 .map_queue = blk_mq_map_queue,
4448 .init_request = rbd_init_request,
4451 static int rbd_init_disk(struct rbd_device *rbd_dev)
4453 struct gendisk *disk;
4454 struct request_queue *q;
4458 /* create gendisk info */
4459 disk = alloc_disk(single_major ?
4460 (1 << RBD_SINGLE_MAJOR_PART_SHIFT) :
4461 RBD_MINORS_PER_MAJOR);
4465 snprintf(disk->disk_name, sizeof(disk->disk_name), RBD_DRV_NAME "%d",
4467 disk->major = rbd_dev->major;
4468 disk->first_minor = rbd_dev->minor;
4470 disk->flags |= GENHD_FL_EXT_DEVT;
4471 disk->fops = &rbd_bd_ops;
4472 disk->private_data = rbd_dev;
4474 memset(&rbd_dev->tag_set, 0, sizeof(rbd_dev->tag_set));
4475 rbd_dev->tag_set.ops = &rbd_mq_ops;
4476 rbd_dev->tag_set.queue_depth = rbd_dev->opts->queue_depth;
4477 rbd_dev->tag_set.numa_node = NUMA_NO_NODE;
4478 rbd_dev->tag_set.flags = BLK_MQ_F_SHOULD_MERGE | BLK_MQ_F_SG_MERGE;
4479 rbd_dev->tag_set.nr_hw_queues = 1;
4480 rbd_dev->tag_set.cmd_size = sizeof(struct work_struct);
4482 err = blk_mq_alloc_tag_set(&rbd_dev->tag_set);
4486 q = blk_mq_init_queue(&rbd_dev->tag_set);
4492 queue_flag_set_unlocked(QUEUE_FLAG_NONROT, q);
4493 /* QUEUE_FLAG_ADD_RANDOM is off by default for blk-mq */
4495 /* set io sizes to object size */
4496 segment_size = rbd_obj_bytes(&rbd_dev->header);
4497 blk_queue_max_hw_sectors(q, segment_size / SECTOR_SIZE);
4498 q->limits.max_sectors = queue_max_hw_sectors(q);
4499 blk_queue_max_segments(q, segment_size / SECTOR_SIZE);
4500 blk_queue_max_segment_size(q, segment_size);
4501 blk_queue_io_min(q, segment_size);
4502 blk_queue_io_opt(q, segment_size);
4504 /* enable the discard support */
4505 queue_flag_set_unlocked(QUEUE_FLAG_DISCARD, q);
4506 q->limits.discard_granularity = segment_size;
4507 q->limits.discard_alignment = segment_size;
4508 blk_queue_max_discard_sectors(q, segment_size / SECTOR_SIZE);
4509 q->limits.discard_zeroes_data = 1;
4511 if (!ceph_test_opt(rbd_dev->rbd_client->client, NOCRC))
4512 q->backing_dev_info.capabilities |= BDI_CAP_STABLE_WRITES;
4516 q->queuedata = rbd_dev;
4518 rbd_dev->disk = disk;
4522 blk_mq_free_tag_set(&rbd_dev->tag_set);
4532 static struct rbd_device *dev_to_rbd_dev(struct device *dev)
4534 return container_of(dev, struct rbd_device, dev);
4537 static ssize_t rbd_size_show(struct device *dev,
4538 struct device_attribute *attr, char *buf)
4540 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4542 return sprintf(buf, "%llu\n",
4543 (unsigned long long)rbd_dev->mapping.size);
4547 * Note this shows the features for whatever's mapped, which is not
4548 * necessarily the base image.
4550 static ssize_t rbd_features_show(struct device *dev,
4551 struct device_attribute *attr, char *buf)
4553 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4555 return sprintf(buf, "0x%016llx\n",
4556 (unsigned long long)rbd_dev->mapping.features);
4559 static ssize_t rbd_major_show(struct device *dev,
4560 struct device_attribute *attr, char *buf)
4562 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4565 return sprintf(buf, "%d\n", rbd_dev->major);
4567 return sprintf(buf, "(none)\n");
4570 static ssize_t rbd_minor_show(struct device *dev,
4571 struct device_attribute *attr, char *buf)
4573 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4575 return sprintf(buf, "%d\n", rbd_dev->minor);
4578 static ssize_t rbd_client_addr_show(struct device *dev,
4579 struct device_attribute *attr, char *buf)
4581 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4582 struct ceph_entity_addr *client_addr =
4583 ceph_client_addr(rbd_dev->rbd_client->client);
4585 return sprintf(buf, "%pISpc/%u\n", &client_addr->in_addr,
4586 le32_to_cpu(client_addr->nonce));
4589 static ssize_t rbd_client_id_show(struct device *dev,
4590 struct device_attribute *attr, char *buf)
4592 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4594 return sprintf(buf, "client%lld\n",
4595 ceph_client_gid(rbd_dev->rbd_client->client));
4598 static ssize_t rbd_cluster_fsid_show(struct device *dev,
4599 struct device_attribute *attr, char *buf)
4601 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4603 return sprintf(buf, "%pU\n", &rbd_dev->rbd_client->client->fsid);
4606 static ssize_t rbd_config_info_show(struct device *dev,
4607 struct device_attribute *attr, char *buf)
4609 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4611 return sprintf(buf, "%s\n", rbd_dev->config_info);
4614 static ssize_t rbd_pool_show(struct device *dev,
4615 struct device_attribute *attr, char *buf)
4617 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4619 return sprintf(buf, "%s\n", rbd_dev->spec->pool_name);
4622 static ssize_t rbd_pool_id_show(struct device *dev,
4623 struct device_attribute *attr, char *buf)
4625 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4627 return sprintf(buf, "%llu\n",
4628 (unsigned long long) rbd_dev->spec->pool_id);
4631 static ssize_t rbd_name_show(struct device *dev,
4632 struct device_attribute *attr, char *buf)
4634 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4636 if (rbd_dev->spec->image_name)
4637 return sprintf(buf, "%s\n", rbd_dev->spec->image_name);
4639 return sprintf(buf, "(unknown)\n");
4642 static ssize_t rbd_image_id_show(struct device *dev,
4643 struct device_attribute *attr, char *buf)
4645 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4647 return sprintf(buf, "%s\n", rbd_dev->spec->image_id);
4651 * Shows the name of the currently-mapped snapshot (or
4652 * RBD_SNAP_HEAD_NAME for the base image).
4654 static ssize_t rbd_snap_show(struct device *dev,
4655 struct device_attribute *attr,
4658 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4660 return sprintf(buf, "%s\n", rbd_dev->spec->snap_name);
4663 static ssize_t rbd_snap_id_show(struct device *dev,
4664 struct device_attribute *attr, char *buf)
4666 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4668 return sprintf(buf, "%llu\n", rbd_dev->spec->snap_id);
4672 * For a v2 image, shows the chain of parent images, separated by empty
4673 * lines. For v1 images or if there is no parent, shows "(no parent
4676 static ssize_t rbd_parent_show(struct device *dev,
4677 struct device_attribute *attr,
4680 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4683 if (!rbd_dev->parent)
4684 return sprintf(buf, "(no parent image)\n");
4686 for ( ; rbd_dev->parent; rbd_dev = rbd_dev->parent) {
4687 struct rbd_spec *spec = rbd_dev->parent_spec;
4689 count += sprintf(&buf[count], "%s"
4690 "pool_id %llu\npool_name %s\n"
4691 "image_id %s\nimage_name %s\n"
4692 "snap_id %llu\nsnap_name %s\n"
4694 !count ? "" : "\n", /* first? */
4695 spec->pool_id, spec->pool_name,
4696 spec->image_id, spec->image_name ?: "(unknown)",
4697 spec->snap_id, spec->snap_name,
4698 rbd_dev->parent_overlap);
4704 static ssize_t rbd_image_refresh(struct device *dev,
4705 struct device_attribute *attr,
4709 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4712 ret = rbd_dev_refresh(rbd_dev);
4719 static DEVICE_ATTR(size, S_IRUGO, rbd_size_show, NULL);
4720 static DEVICE_ATTR(features, S_IRUGO, rbd_features_show, NULL);
4721 static DEVICE_ATTR(major, S_IRUGO, rbd_major_show, NULL);
4722 static DEVICE_ATTR(minor, S_IRUGO, rbd_minor_show, NULL);
4723 static DEVICE_ATTR(client_addr, S_IRUGO, rbd_client_addr_show, NULL);
4724 static DEVICE_ATTR(client_id, S_IRUGO, rbd_client_id_show, NULL);
4725 static DEVICE_ATTR(cluster_fsid, S_IRUGO, rbd_cluster_fsid_show, NULL);
4726 static DEVICE_ATTR(config_info, S_IRUSR, rbd_config_info_show, NULL);
4727 static DEVICE_ATTR(pool, S_IRUGO, rbd_pool_show, NULL);
4728 static DEVICE_ATTR(pool_id, S_IRUGO, rbd_pool_id_show, NULL);
4729 static DEVICE_ATTR(name, S_IRUGO, rbd_name_show, NULL);
4730 static DEVICE_ATTR(image_id, S_IRUGO, rbd_image_id_show, NULL);
4731 static DEVICE_ATTR(refresh, S_IWUSR, NULL, rbd_image_refresh);
4732 static DEVICE_ATTR(current_snap, S_IRUGO, rbd_snap_show, NULL);
4733 static DEVICE_ATTR(snap_id, S_IRUGO, rbd_snap_id_show, NULL);
4734 static DEVICE_ATTR(parent, S_IRUGO, rbd_parent_show, NULL);
4736 static struct attribute *rbd_attrs[] = {
4737 &dev_attr_size.attr,
4738 &dev_attr_features.attr,
4739 &dev_attr_major.attr,
4740 &dev_attr_minor.attr,
4741 &dev_attr_client_addr.attr,
4742 &dev_attr_client_id.attr,
4743 &dev_attr_cluster_fsid.attr,
4744 &dev_attr_config_info.attr,
4745 &dev_attr_pool.attr,
4746 &dev_attr_pool_id.attr,
4747 &dev_attr_name.attr,
4748 &dev_attr_image_id.attr,
4749 &dev_attr_current_snap.attr,
4750 &dev_attr_snap_id.attr,
4751 &dev_attr_parent.attr,
4752 &dev_attr_refresh.attr,
4756 static struct attribute_group rbd_attr_group = {
4760 static const struct attribute_group *rbd_attr_groups[] = {
4765 static void rbd_dev_release(struct device *dev);
4767 static struct device_type rbd_device_type = {
4769 .groups = rbd_attr_groups,
4770 .release = rbd_dev_release,
4773 static struct rbd_spec *rbd_spec_get(struct rbd_spec *spec)
4775 kref_get(&spec->kref);
4780 static void rbd_spec_free(struct kref *kref);
4781 static void rbd_spec_put(struct rbd_spec *spec)
4784 kref_put(&spec->kref, rbd_spec_free);
4787 static struct rbd_spec *rbd_spec_alloc(void)
4789 struct rbd_spec *spec;
4791 spec = kzalloc(sizeof (*spec), GFP_KERNEL);
4795 spec->pool_id = CEPH_NOPOOL;
4796 spec->snap_id = CEPH_NOSNAP;
4797 kref_init(&spec->kref);
4802 static void rbd_spec_free(struct kref *kref)
4804 struct rbd_spec *spec = container_of(kref, struct rbd_spec, kref);
4806 kfree(spec->pool_name);
4807 kfree(spec->image_id);
4808 kfree(spec->image_name);
4809 kfree(spec->snap_name);
4813 static void rbd_dev_free(struct rbd_device *rbd_dev)
4815 WARN_ON(rbd_dev->watch_state != RBD_WATCH_STATE_UNREGISTERED);
4816 WARN_ON(rbd_dev->lock_state != RBD_LOCK_STATE_UNLOCKED);
4818 ceph_oid_destroy(&rbd_dev->header_oid);
4819 ceph_oloc_destroy(&rbd_dev->header_oloc);
4820 kfree(rbd_dev->config_info);
4822 rbd_put_client(rbd_dev->rbd_client);
4823 rbd_spec_put(rbd_dev->spec);
4824 kfree(rbd_dev->opts);
4828 static void rbd_dev_release(struct device *dev)
4830 struct rbd_device *rbd_dev = dev_to_rbd_dev(dev);
4831 bool need_put = !!rbd_dev->opts;
4834 destroy_workqueue(rbd_dev->task_wq);
4835 ida_simple_remove(&rbd_dev_id_ida, rbd_dev->dev_id);
4838 rbd_dev_free(rbd_dev);
4841 * This is racy, but way better than putting module outside of
4842 * the release callback. The race window is pretty small, so
4843 * doing something similar to dm (dm-builtin.c) is overkill.
4846 module_put(THIS_MODULE);
4849 static struct rbd_device *__rbd_dev_create(struct rbd_client *rbdc,
4850 struct rbd_spec *spec)
4852 struct rbd_device *rbd_dev;
4854 rbd_dev = kzalloc(sizeof(*rbd_dev), GFP_KERNEL);
4858 spin_lock_init(&rbd_dev->lock);
4859 INIT_LIST_HEAD(&rbd_dev->node);
4860 init_rwsem(&rbd_dev->header_rwsem);
4862 ceph_oid_init(&rbd_dev->header_oid);
4863 ceph_oloc_init(&rbd_dev->header_oloc);
4865 mutex_init(&rbd_dev->watch_mutex);
4866 rbd_dev->watch_state = RBD_WATCH_STATE_UNREGISTERED;
4867 INIT_DELAYED_WORK(&rbd_dev->watch_dwork, rbd_reregister_watch);
4869 init_rwsem(&rbd_dev->lock_rwsem);
4870 rbd_dev->lock_state = RBD_LOCK_STATE_UNLOCKED;
4871 INIT_WORK(&rbd_dev->acquired_lock_work, rbd_notify_acquired_lock);
4872 INIT_WORK(&rbd_dev->released_lock_work, rbd_notify_released_lock);
4873 INIT_DELAYED_WORK(&rbd_dev->lock_dwork, rbd_acquire_lock);
4874 INIT_WORK(&rbd_dev->unlock_work, rbd_release_lock_work);
4875 init_waitqueue_head(&rbd_dev->lock_waitq);
4877 rbd_dev->dev.bus = &rbd_bus_type;
4878 rbd_dev->dev.type = &rbd_device_type;
4879 rbd_dev->dev.parent = &rbd_root_dev;
4880 device_initialize(&rbd_dev->dev);
4882 rbd_dev->rbd_client = rbdc;
4883 rbd_dev->spec = spec;
4885 rbd_dev->layout.stripe_unit = 1 << RBD_MAX_OBJ_ORDER;
4886 rbd_dev->layout.stripe_count = 1;
4887 rbd_dev->layout.object_size = 1 << RBD_MAX_OBJ_ORDER;
4888 rbd_dev->layout.pool_id = spec->pool_id;
4889 RCU_INIT_POINTER(rbd_dev->layout.pool_ns, NULL);
4895 * Create a mapping rbd_dev.
4897 static struct rbd_device *rbd_dev_create(struct rbd_client *rbdc,
4898 struct rbd_spec *spec,
4899 struct rbd_options *opts)
4901 struct rbd_device *rbd_dev;
4903 rbd_dev = __rbd_dev_create(rbdc, spec);
4907 rbd_dev->opts = opts;
4909 /* get an id and fill in device name */
4910 rbd_dev->dev_id = ida_simple_get(&rbd_dev_id_ida, 0,
4911 minor_to_rbd_dev_id(1 << MINORBITS),
4913 if (rbd_dev->dev_id < 0)
4916 sprintf(rbd_dev->name, RBD_DRV_NAME "%d", rbd_dev->dev_id);
4917 rbd_dev->task_wq = alloc_ordered_workqueue("%s-tasks", WQ_MEM_RECLAIM,
4919 if (!rbd_dev->task_wq)
4922 /* we have a ref from do_rbd_add() */
4923 __module_get(THIS_MODULE);
4925 dout("%s rbd_dev %p dev_id %d\n", __func__, rbd_dev, rbd_dev->dev_id);
4929 ida_simple_remove(&rbd_dev_id_ida, rbd_dev->dev_id);
4931 rbd_dev_free(rbd_dev);
4935 static void rbd_dev_destroy(struct rbd_device *rbd_dev)
4938 put_device(&rbd_dev->dev);
4942 * Get the size and object order for an image snapshot, or if
4943 * snap_id is CEPH_NOSNAP, gets this information for the base
4946 static int _rbd_dev_v2_snap_size(struct rbd_device *rbd_dev, u64 snap_id,
4947 u8 *order, u64 *snap_size)
4949 __le64 snapid = cpu_to_le64(snap_id);
4954 } __attribute__ ((packed)) size_buf = { 0 };
4956 ret = rbd_obj_method_sync(rbd_dev, rbd_dev->header_oid.name,
4958 &snapid, sizeof (snapid),
4959 &size_buf, sizeof (size_buf));
4960 dout("%s: rbd_obj_method_sync returned %d\n", __func__, ret);
4963 if (ret < sizeof (size_buf))
4967 *order = size_buf.order;
4968 dout(" order %u", (unsigned int)*order);
4970 *snap_size = le64_to_cpu(size_buf.size);
4972 dout(" snap_id 0x%016llx snap_size = %llu\n",
4973 (unsigned long long)snap_id,
4974 (unsigned long long)*snap_size);
4979 static int rbd_dev_v2_image_size(struct rbd_device *rbd_dev)
4981 return _rbd_dev_v2_snap_size(rbd_dev, CEPH_NOSNAP,
4982 &rbd_dev->header.obj_order,
4983 &rbd_dev->header.image_size);
4986 static int rbd_dev_v2_object_prefix(struct rbd_device *rbd_dev)
4992 reply_buf = kzalloc(RBD_OBJ_PREFIX_LEN_MAX, GFP_KERNEL);
4996 ret = rbd_obj_method_sync(rbd_dev, rbd_dev->header_oid.name,
4997 "rbd", "get_object_prefix", NULL, 0,
4998 reply_buf, RBD_OBJ_PREFIX_LEN_MAX);
4999 dout("%s: rbd_obj_method_sync returned %d\n", __func__, ret);
5004 rbd_dev->header.object_prefix = ceph_extract_encoded_string(&p,
5005 p + ret, NULL, GFP_NOIO);
5008 if (IS_ERR(rbd_dev->header.object_prefix)) {
5009 ret = PTR_ERR(rbd_dev->header.object_prefix);
5010 rbd_dev->header.object_prefix = NULL;
5012 dout(" object_prefix = %s\n", rbd_dev->header.object_prefix);
5020 static int _rbd_dev_v2_snap_features(struct rbd_device *rbd_dev, u64 snap_id,
5023 __le64 snapid = cpu_to_le64(snap_id);
5027 } __attribute__ ((packed)) features_buf = { 0 };
5031 ret = rbd_obj_method_sync(rbd_dev, rbd_dev->header_oid.name,
5032 "rbd", "get_features",
5033 &snapid, sizeof (snapid),
5034 &features_buf, sizeof (features_buf));
5035 dout("%s: rbd_obj_method_sync returned %d\n", __func__, ret);
5038 if (ret < sizeof (features_buf))
5041 unsup = le64_to_cpu(features_buf.incompat) & ~RBD_FEATURES_SUPPORTED;
5043 rbd_warn(rbd_dev, "image uses unsupported features: 0x%llx",
5048 *snap_features = le64_to_cpu(features_buf.features);
5050 dout(" snap_id 0x%016llx features = 0x%016llx incompat = 0x%016llx\n",
5051 (unsigned long long)snap_id,
5052 (unsigned long long)*snap_features,
5053 (unsigned long long)le64_to_cpu(features_buf.incompat));
5058 static int rbd_dev_v2_features(struct rbd_device *rbd_dev)
5060 return _rbd_dev_v2_snap_features(rbd_dev, CEPH_NOSNAP,
5061 &rbd_dev->header.features);
5064 static int rbd_dev_v2_parent_info(struct rbd_device *rbd_dev)
5066 struct rbd_spec *parent_spec;
5068 void *reply_buf = NULL;
5078 parent_spec = rbd_spec_alloc();
5082 size = sizeof (__le64) + /* pool_id */
5083 sizeof (__le32) + RBD_IMAGE_ID_LEN_MAX + /* image_id */
5084 sizeof (__le64) + /* snap_id */
5085 sizeof (__le64); /* overlap */
5086 reply_buf = kmalloc(size, GFP_KERNEL);
5092 snapid = cpu_to_le64(rbd_dev->spec->snap_id);
5093 ret = rbd_obj_method_sync(rbd_dev, rbd_dev->header_oid.name,
5094 "rbd", "get_parent",
5095 &snapid, sizeof (snapid),
5097 dout("%s: rbd_obj_method_sync returned %d\n", __func__, ret);
5102 end = reply_buf + ret;
5104 ceph_decode_64_safe(&p, end, pool_id, out_err);
5105 if (pool_id == CEPH_NOPOOL) {
5107 * Either the parent never existed, or we have
5108 * record of it but the image got flattened so it no
5109 * longer has a parent. When the parent of a
5110 * layered image disappears we immediately set the
5111 * overlap to 0. The effect of this is that all new
5112 * requests will be treated as if the image had no
5115 if (rbd_dev->parent_overlap) {
5116 rbd_dev->parent_overlap = 0;
5117 rbd_dev_parent_put(rbd_dev);
5118 pr_info("%s: clone image has been flattened\n",
5119 rbd_dev->disk->disk_name);
5122 goto out; /* No parent? No problem. */
5125 /* The ceph file layout needs to fit pool id in 32 bits */
5128 if (pool_id > (u64)U32_MAX) {
5129 rbd_warn(NULL, "parent pool id too large (%llu > %u)",
5130 (unsigned long long)pool_id, U32_MAX);
5134 image_id = ceph_extract_encoded_string(&p, end, NULL, GFP_KERNEL);
5135 if (IS_ERR(image_id)) {
5136 ret = PTR_ERR(image_id);
5139 ceph_decode_64_safe(&p, end, snap_id, out_err);
5140 ceph_decode_64_safe(&p, end, overlap, out_err);
5143 * The parent won't change (except when the clone is
5144 * flattened, already handled that). So we only need to
5145 * record the parent spec we have not already done so.
5147 if (!rbd_dev->parent_spec) {
5148 parent_spec->pool_id = pool_id;
5149 parent_spec->image_id = image_id;
5150 parent_spec->snap_id = snap_id;
5151 rbd_dev->parent_spec = parent_spec;
5152 parent_spec = NULL; /* rbd_dev now owns this */
5158 * We always update the parent overlap. If it's zero we issue
5159 * a warning, as we will proceed as if there was no parent.
5163 /* refresh, careful to warn just once */
5164 if (rbd_dev->parent_overlap)
5166 "clone now standalone (overlap became 0)");
5169 rbd_warn(rbd_dev, "clone is standalone (overlap 0)");
5172 rbd_dev->parent_overlap = overlap;
5178 rbd_spec_put(parent_spec);
5183 static int rbd_dev_v2_striping_info(struct rbd_device *rbd_dev)
5187 __le64 stripe_count;
5188 } __attribute__ ((packed)) striping_info_buf = { 0 };
5189 size_t size = sizeof (striping_info_buf);
5196 ret = rbd_obj_method_sync(rbd_dev, rbd_dev->header_oid.name,
5197 "rbd", "get_stripe_unit_count", NULL, 0,
5198 (char *)&striping_info_buf, size);
5199 dout("%s: rbd_obj_method_sync returned %d\n", __func__, ret);
5206 * We don't actually support the "fancy striping" feature
5207 * (STRIPINGV2) yet, but if the striping sizes are the
5208 * defaults the behavior is the same as before. So find
5209 * out, and only fail if the image has non-default values.
5212 obj_size = (u64)1 << rbd_dev->header.obj_order;
5213 p = &striping_info_buf;
5214 stripe_unit = ceph_decode_64(&p);
5215 if (stripe_unit != obj_size) {
5216 rbd_warn(rbd_dev, "unsupported stripe unit "
5217 "(got %llu want %llu)",
5218 stripe_unit, obj_size);
5221 stripe_count = ceph_decode_64(&p);
5222 if (stripe_count != 1) {
5223 rbd_warn(rbd_dev, "unsupported stripe count "
5224 "(got %llu want 1)", stripe_count);
5227 rbd_dev->header.stripe_unit = stripe_unit;
5228 rbd_dev->header.stripe_count = stripe_count;
5233 static char *rbd_dev_image_name(struct rbd_device *rbd_dev)
5235 size_t image_id_size;
5240 void *reply_buf = NULL;
5242 char *image_name = NULL;
5245 rbd_assert(!rbd_dev->spec->image_name);
5247 len = strlen(rbd_dev->spec->image_id);
5248 image_id_size = sizeof (__le32) + len;
5249 image_id = kmalloc(image_id_size, GFP_KERNEL);
5254 end = image_id + image_id_size;
5255 ceph_encode_string(&p, end, rbd_dev->spec->image_id, (u32)len);
5257 size = sizeof (__le32) + RBD_IMAGE_NAME_LEN_MAX;
5258 reply_buf = kmalloc(size, GFP_KERNEL);
5262 ret = rbd_obj_method_sync(rbd_dev, RBD_DIRECTORY,
5263 "rbd", "dir_get_name",
5264 image_id, image_id_size,
5269 end = reply_buf + ret;
5271 image_name = ceph_extract_encoded_string(&p, end, &len, GFP_KERNEL);
5272 if (IS_ERR(image_name))
5275 dout("%s: name is %s len is %zd\n", __func__, image_name, len);
5283 static u64 rbd_v1_snap_id_by_name(struct rbd_device *rbd_dev, const char *name)
5285 struct ceph_snap_context *snapc = rbd_dev->header.snapc;
5286 const char *snap_name;
5289 /* Skip over names until we find the one we are looking for */
5291 snap_name = rbd_dev->header.snap_names;
5292 while (which < snapc->num_snaps) {
5293 if (!strcmp(name, snap_name))
5294 return snapc->snaps[which];
5295 snap_name += strlen(snap_name) + 1;
5301 static u64 rbd_v2_snap_id_by_name(struct rbd_device *rbd_dev, const char *name)
5303 struct ceph_snap_context *snapc = rbd_dev->header.snapc;
5308 for (which = 0; !found && which < snapc->num_snaps; which++) {
5309 const char *snap_name;
5311 snap_id = snapc->snaps[which];
5312 snap_name = rbd_dev_v2_snap_name(rbd_dev, snap_id);
5313 if (IS_ERR(snap_name)) {
5314 /* ignore no-longer existing snapshots */
5315 if (PTR_ERR(snap_name) == -ENOENT)
5320 found = !strcmp(name, snap_name);
5323 return found ? snap_id : CEPH_NOSNAP;
5327 * Assumes name is never RBD_SNAP_HEAD_NAME; returns CEPH_NOSNAP if
5328 * no snapshot by that name is found, or if an error occurs.
5330 static u64 rbd_snap_id_by_name(struct rbd_device *rbd_dev, const char *name)
5332 if (rbd_dev->image_format == 1)
5333 return rbd_v1_snap_id_by_name(rbd_dev, name);
5335 return rbd_v2_snap_id_by_name(rbd_dev, name);
5339 * An image being mapped will have everything but the snap id.
5341 static int rbd_spec_fill_snap_id(struct rbd_device *rbd_dev)
5343 struct rbd_spec *spec = rbd_dev->spec;
5345 rbd_assert(spec->pool_id != CEPH_NOPOOL && spec->pool_name);
5346 rbd_assert(spec->image_id && spec->image_name);
5347 rbd_assert(spec->snap_name);
5349 if (strcmp(spec->snap_name, RBD_SNAP_HEAD_NAME)) {
5352 snap_id = rbd_snap_id_by_name(rbd_dev, spec->snap_name);
5353 if (snap_id == CEPH_NOSNAP)
5356 spec->snap_id = snap_id;
5358 spec->snap_id = CEPH_NOSNAP;
5365 * A parent image will have all ids but none of the names.
5367 * All names in an rbd spec are dynamically allocated. It's OK if we
5368 * can't figure out the name for an image id.
5370 static int rbd_spec_fill_names(struct rbd_device *rbd_dev)
5372 struct ceph_osd_client *osdc = &rbd_dev->rbd_client->client->osdc;
5373 struct rbd_spec *spec = rbd_dev->spec;
5374 const char *pool_name;
5375 const char *image_name;
5376 const char *snap_name;
5379 rbd_assert(spec->pool_id != CEPH_NOPOOL);
5380 rbd_assert(spec->image_id);
5381 rbd_assert(spec->snap_id != CEPH_NOSNAP);
5383 /* Get the pool name; we have to make our own copy of this */
5385 pool_name = ceph_pg_pool_name_by_id(osdc->osdmap, spec->pool_id);
5387 rbd_warn(rbd_dev, "no pool with id %llu", spec->pool_id);
5390 pool_name = kstrdup(pool_name, GFP_KERNEL);
5394 /* Fetch the image name; tolerate failure here */
5396 image_name = rbd_dev_image_name(rbd_dev);
5398 rbd_warn(rbd_dev, "unable to get image name");
5400 /* Fetch the snapshot name */
5402 snap_name = rbd_snap_name(rbd_dev, spec->snap_id);
5403 if (IS_ERR(snap_name)) {
5404 ret = PTR_ERR(snap_name);
5408 spec->pool_name = pool_name;
5409 spec->image_name = image_name;
5410 spec->snap_name = snap_name;
5420 static int rbd_dev_v2_snap_context(struct rbd_device *rbd_dev)
5429 struct ceph_snap_context *snapc;
5433 * We'll need room for the seq value (maximum snapshot id),
5434 * snapshot count, and array of that many snapshot ids.
5435 * For now we have a fixed upper limit on the number we're
5436 * prepared to receive.
5438 size = sizeof (__le64) + sizeof (__le32) +
5439 RBD_MAX_SNAP_COUNT * sizeof (__le64);
5440 reply_buf = kzalloc(size, GFP_KERNEL);
5444 ret = rbd_obj_method_sync(rbd_dev, rbd_dev->header_oid.name,
5445 "rbd", "get_snapcontext", NULL, 0,
5447 dout("%s: rbd_obj_method_sync returned %d\n", __func__, ret);
5452 end = reply_buf + ret;
5454 ceph_decode_64_safe(&p, end, seq, out);
5455 ceph_decode_32_safe(&p, end, snap_count, out);
5458 * Make sure the reported number of snapshot ids wouldn't go
5459 * beyond the end of our buffer. But before checking that,
5460 * make sure the computed size of the snapshot context we
5461 * allocate is representable in a size_t.
5463 if (snap_count > (SIZE_MAX - sizeof (struct ceph_snap_context))
5468 if (!ceph_has_room(&p, end, snap_count * sizeof (__le64)))
5472 snapc = ceph_create_snap_context(snap_count, GFP_KERNEL);
5478 for (i = 0; i < snap_count; i++)
5479 snapc->snaps[i] = ceph_decode_64(&p);
5481 ceph_put_snap_context(rbd_dev->header.snapc);
5482 rbd_dev->header.snapc = snapc;
5484 dout(" snap context seq = %llu, snap_count = %u\n",
5485 (unsigned long long)seq, (unsigned int)snap_count);
5492 static const char *rbd_dev_v2_snap_name(struct rbd_device *rbd_dev,
5503 size = sizeof (__le32) + RBD_MAX_SNAP_NAME_LEN;
5504 reply_buf = kmalloc(size, GFP_KERNEL);
5506 return ERR_PTR(-ENOMEM);
5508 snapid = cpu_to_le64(snap_id);
5509 ret = rbd_obj_method_sync(rbd_dev, rbd_dev->header_oid.name,
5510 "rbd", "get_snapshot_name",
5511 &snapid, sizeof (snapid),
5513 dout("%s: rbd_obj_method_sync returned %d\n", __func__, ret);
5515 snap_name = ERR_PTR(ret);
5520 end = reply_buf + ret;
5521 snap_name = ceph_extract_encoded_string(&p, end, NULL, GFP_KERNEL);
5522 if (IS_ERR(snap_name))
5525 dout(" snap_id 0x%016llx snap_name = %s\n",
5526 (unsigned long long)snap_id, snap_name);
5533 static int rbd_dev_v2_header_info(struct rbd_device *rbd_dev)
5535 bool first_time = rbd_dev->header.object_prefix == NULL;
5538 ret = rbd_dev_v2_image_size(rbd_dev);
5543 ret = rbd_dev_v2_header_onetime(rbd_dev);
5548 ret = rbd_dev_v2_snap_context(rbd_dev);
5549 if (ret && first_time) {
5550 kfree(rbd_dev->header.object_prefix);
5551 rbd_dev->header.object_prefix = NULL;
5557 static int rbd_dev_header_info(struct rbd_device *rbd_dev)
5559 rbd_assert(rbd_image_format_valid(rbd_dev->image_format));
5561 if (rbd_dev->image_format == 1)
5562 return rbd_dev_v1_header_info(rbd_dev);
5564 return rbd_dev_v2_header_info(rbd_dev);
5568 * Skips over white space at *buf, and updates *buf to point to the
5569 * first found non-space character (if any). Returns the length of
5570 * the token (string of non-white space characters) found. Note
5571 * that *buf must be terminated with '\0'.
5573 static inline size_t next_token(const char **buf)
5576 * These are the characters that produce nonzero for
5577 * isspace() in the "C" and "POSIX" locales.
5579 const char *spaces = " \f\n\r\t\v";
5581 *buf += strspn(*buf, spaces); /* Find start of token */
5583 return strcspn(*buf, spaces); /* Return token length */
5587 * Finds the next token in *buf, dynamically allocates a buffer big
5588 * enough to hold a copy of it, and copies the token into the new
5589 * buffer. The copy is guaranteed to be terminated with '\0'. Note
5590 * that a duplicate buffer is created even for a zero-length token.
5592 * Returns a pointer to the newly-allocated duplicate, or a null
5593 * pointer if memory for the duplicate was not available. If
5594 * the lenp argument is a non-null pointer, the length of the token
5595 * (not including the '\0') is returned in *lenp.
5597 * If successful, the *buf pointer will be updated to point beyond
5598 * the end of the found token.
5600 * Note: uses GFP_KERNEL for allocation.
5602 static inline char *dup_token(const char **buf, size_t *lenp)
5607 len = next_token(buf);
5608 dup = kmemdup(*buf, len + 1, GFP_KERNEL);
5611 *(dup + len) = '\0';
5621 * Parse the options provided for an "rbd add" (i.e., rbd image
5622 * mapping) request. These arrive via a write to /sys/bus/rbd/add,
5623 * and the data written is passed here via a NUL-terminated buffer.
5624 * Returns 0 if successful or an error code otherwise.
5626 * The information extracted from these options is recorded in
5627 * the other parameters which return dynamically-allocated
5630 * The address of a pointer that will refer to a ceph options
5631 * structure. Caller must release the returned pointer using
5632 * ceph_destroy_options() when it is no longer needed.
5634 * Address of an rbd options pointer. Fully initialized by
5635 * this function; caller must release with kfree().
5637 * Address of an rbd image specification pointer. Fully
5638 * initialized by this function based on parsed options.
5639 * Caller must release with rbd_spec_put().
5641 * The options passed take this form:
5642 * <mon_addrs> <options> <pool_name> <image_name> [<snap_id>]
5645 * A comma-separated list of one or more monitor addresses.
5646 * A monitor address is an ip address, optionally followed
5647 * by a port number (separated by a colon).
5648 * I.e.: ip1[:port1][,ip2[:port2]...]
5650 * A comma-separated list of ceph and/or rbd options.
5652 * The name of the rados pool containing the rbd image.
5654 * The name of the image in that pool to map.
5656 * An optional snapshot id. If provided, the mapping will
5657 * present data from the image at the time that snapshot was
5658 * created. The image head is used if no snapshot id is
5659 * provided. Snapshot mappings are always read-only.
5661 static int rbd_add_parse_args(const char *buf,
5662 struct ceph_options **ceph_opts,
5663 struct rbd_options **opts,
5664 struct rbd_spec **rbd_spec)
5668 const char *mon_addrs;
5670 size_t mon_addrs_size;
5671 struct rbd_spec *spec = NULL;
5672 struct rbd_options *rbd_opts = NULL;
5673 struct ceph_options *copts;
5676 /* The first four tokens are required */
5678 len = next_token(&buf);
5680 rbd_warn(NULL, "no monitor address(es) provided");
5684 mon_addrs_size = len + 1;
5688 options = dup_token(&buf, NULL);
5692 rbd_warn(NULL, "no options provided");
5696 spec = rbd_spec_alloc();
5700 spec->pool_name = dup_token(&buf, NULL);
5701 if (!spec->pool_name)
5703 if (!*spec->pool_name) {
5704 rbd_warn(NULL, "no pool name provided");
5708 spec->image_name = dup_token(&buf, NULL);
5709 if (!spec->image_name)
5711 if (!*spec->image_name) {
5712 rbd_warn(NULL, "no image name provided");
5717 * Snapshot name is optional; default is to use "-"
5718 * (indicating the head/no snapshot).
5720 len = next_token(&buf);
5722 buf = RBD_SNAP_HEAD_NAME; /* No snapshot supplied */
5723 len = sizeof (RBD_SNAP_HEAD_NAME) - 1;
5724 } else if (len > RBD_MAX_SNAP_NAME_LEN) {
5725 ret = -ENAMETOOLONG;
5728 snap_name = kmemdup(buf, len + 1, GFP_KERNEL);
5731 *(snap_name + len) = '\0';
5732 spec->snap_name = snap_name;
5734 /* Initialize all rbd options to the defaults */
5736 rbd_opts = kzalloc(sizeof (*rbd_opts), GFP_KERNEL);
5740 rbd_opts->read_only = RBD_READ_ONLY_DEFAULT;
5741 rbd_opts->queue_depth = RBD_QUEUE_DEPTH_DEFAULT;
5742 rbd_opts->lock_on_read = RBD_LOCK_ON_READ_DEFAULT;
5744 copts = ceph_parse_options(options, mon_addrs,
5745 mon_addrs + mon_addrs_size - 1,
5746 parse_rbd_opts_token, rbd_opts);
5747 if (IS_ERR(copts)) {
5748 ret = PTR_ERR(copts);
5769 * Return pool id (>= 0) or a negative error code.
5771 static int rbd_add_get_pool_id(struct rbd_client *rbdc, const char *pool_name)
5773 struct ceph_options *opts = rbdc->client->options;
5779 ret = ceph_pg_poolid_by_name(rbdc->client->osdc.osdmap, pool_name);
5780 if (ret == -ENOENT && tries++ < 1) {
5781 ret = ceph_monc_get_version(&rbdc->client->monc, "osdmap",
5786 if (rbdc->client->osdc.osdmap->epoch < newest_epoch) {
5787 ceph_osdc_maybe_request_map(&rbdc->client->osdc);
5788 (void) ceph_monc_wait_osdmap(&rbdc->client->monc,
5790 opts->mount_timeout);
5793 /* the osdmap we have is new enough */
5802 * An rbd format 2 image has a unique identifier, distinct from the
5803 * name given to it by the user. Internally, that identifier is
5804 * what's used to specify the names of objects related to the image.
5806 * A special "rbd id" object is used to map an rbd image name to its
5807 * id. If that object doesn't exist, then there is no v2 rbd image
5808 * with the supplied name.
5810 * This function will record the given rbd_dev's image_id field if
5811 * it can be determined, and in that case will return 0. If any
5812 * errors occur a negative errno will be returned and the rbd_dev's
5813 * image_id field will be unchanged (and should be NULL).
5815 static int rbd_dev_image_id(struct rbd_device *rbd_dev)
5824 * When probing a parent image, the image id is already
5825 * known (and the image name likely is not). There's no
5826 * need to fetch the image id again in this case. We
5827 * do still need to set the image format though.
5829 if (rbd_dev->spec->image_id) {
5830 rbd_dev->image_format = *rbd_dev->spec->image_id ? 2 : 1;
5836 * First, see if the format 2 image id file exists, and if
5837 * so, get the image's persistent id from it.
5839 size = sizeof (RBD_ID_PREFIX) + strlen(rbd_dev->spec->image_name);
5840 object_name = kmalloc(size, GFP_NOIO);
5843 sprintf(object_name, "%s%s", RBD_ID_PREFIX, rbd_dev->spec->image_name);
5844 dout("rbd id object name is %s\n", object_name);
5846 /* Response will be an encoded string, which includes a length */
5848 size = sizeof (__le32) + RBD_IMAGE_ID_LEN_MAX;
5849 response = kzalloc(size, GFP_NOIO);
5855 /* If it doesn't exist we'll assume it's a format 1 image */
5857 ret = rbd_obj_method_sync(rbd_dev, object_name,
5858 "rbd", "get_id", NULL, 0,
5859 response, RBD_IMAGE_ID_LEN_MAX);
5860 dout("%s: rbd_obj_method_sync returned %d\n", __func__, ret);
5861 if (ret == -ENOENT) {
5862 image_id = kstrdup("", GFP_KERNEL);
5863 ret = image_id ? 0 : -ENOMEM;
5865 rbd_dev->image_format = 1;
5866 } else if (ret >= 0) {
5869 image_id = ceph_extract_encoded_string(&p, p + ret,
5871 ret = PTR_ERR_OR_ZERO(image_id);
5873 rbd_dev->image_format = 2;
5877 rbd_dev->spec->image_id = image_id;
5878 dout("image_id is %s\n", image_id);
5888 * Undo whatever state changes are made by v1 or v2 header info
5891 static void rbd_dev_unprobe(struct rbd_device *rbd_dev)
5893 struct rbd_image_header *header;
5895 rbd_dev_parent_put(rbd_dev);
5897 /* Free dynamic fields from the header, then zero it out */
5899 header = &rbd_dev->header;
5900 ceph_put_snap_context(header->snapc);
5901 kfree(header->snap_sizes);
5902 kfree(header->snap_names);
5903 kfree(header->object_prefix);
5904 memset(header, 0, sizeof (*header));
5907 static int rbd_dev_v2_header_onetime(struct rbd_device *rbd_dev)
5911 ret = rbd_dev_v2_object_prefix(rbd_dev);
5916 * Get the and check features for the image. Currently the
5917 * features are assumed to never change.
5919 ret = rbd_dev_v2_features(rbd_dev);
5923 /* If the image supports fancy striping, get its parameters */
5925 if (rbd_dev->header.features & RBD_FEATURE_STRIPINGV2) {
5926 ret = rbd_dev_v2_striping_info(rbd_dev);
5930 /* No support for crypto and compression type format 2 images */
5934 rbd_dev->header.features = 0;
5935 kfree(rbd_dev->header.object_prefix);
5936 rbd_dev->header.object_prefix = NULL;
5942 * @depth is rbd_dev_image_probe() -> rbd_dev_probe_parent() ->
5943 * rbd_dev_image_probe() recursion depth, which means it's also the
5944 * length of the already discovered part of the parent chain.
5946 static int rbd_dev_probe_parent(struct rbd_device *rbd_dev, int depth)
5948 struct rbd_device *parent = NULL;
5951 if (!rbd_dev->parent_spec)
5954 if (++depth > RBD_MAX_PARENT_CHAIN_LEN) {
5955 pr_info("parent chain is too long (%d)\n", depth);
5960 parent = __rbd_dev_create(rbd_dev->rbd_client, rbd_dev->parent_spec);
5967 * Images related by parent/child relationships always share
5968 * rbd_client and spec/parent_spec, so bump their refcounts.
5970 __rbd_get_client(rbd_dev->rbd_client);
5971 rbd_spec_get(rbd_dev->parent_spec);
5973 ret = rbd_dev_image_probe(parent, depth);
5977 rbd_dev->parent = parent;
5978 atomic_set(&rbd_dev->parent_ref, 1);
5982 rbd_dev_unparent(rbd_dev);
5983 rbd_dev_destroy(parent);
5988 * rbd_dev->header_rwsem must be locked for write and will be unlocked
5991 static int rbd_dev_device_setup(struct rbd_device *rbd_dev)
5995 /* Record our major and minor device numbers. */
5997 if (!single_major) {
5998 ret = register_blkdev(0, rbd_dev->name);
6000 goto err_out_unlock;
6002 rbd_dev->major = ret;
6005 rbd_dev->major = rbd_major;
6006 rbd_dev->minor = rbd_dev_id_to_minor(rbd_dev->dev_id);
6009 /* Set up the blkdev mapping. */
6011 ret = rbd_init_disk(rbd_dev);
6013 goto err_out_blkdev;
6015 ret = rbd_dev_mapping_set(rbd_dev);
6019 set_capacity(rbd_dev->disk, rbd_dev->mapping.size / SECTOR_SIZE);
6020 set_disk_ro(rbd_dev->disk, rbd_dev->mapping.read_only);
6022 dev_set_name(&rbd_dev->dev, "%d", rbd_dev->dev_id);
6023 ret = device_add(&rbd_dev->dev);
6025 goto err_out_mapping;
6027 /* Everything's ready. Announce the disk to the world. */
6029 set_bit(RBD_DEV_FLAG_EXISTS, &rbd_dev->flags);
6030 up_write(&rbd_dev->header_rwsem);
6032 spin_lock(&rbd_dev_list_lock);
6033 list_add_tail(&rbd_dev->node, &rbd_dev_list);
6034 spin_unlock(&rbd_dev_list_lock);
6036 add_disk(rbd_dev->disk);
6037 pr_info("%s: capacity %llu features 0x%llx\n", rbd_dev->disk->disk_name,
6038 (unsigned long long)get_capacity(rbd_dev->disk) << SECTOR_SHIFT,
6039 rbd_dev->header.features);
6044 rbd_dev_mapping_clear(rbd_dev);
6046 rbd_free_disk(rbd_dev);
6049 unregister_blkdev(rbd_dev->major, rbd_dev->name);
6051 up_write(&rbd_dev->header_rwsem);
6055 static int rbd_dev_header_name(struct rbd_device *rbd_dev)
6057 struct rbd_spec *spec = rbd_dev->spec;
6060 /* Record the header object name for this rbd image. */
6062 rbd_assert(rbd_image_format_valid(rbd_dev->image_format));
6064 rbd_dev->header_oloc.pool = rbd_dev->layout.pool_id;
6065 if (rbd_dev->image_format == 1)
6066 ret = ceph_oid_aprintf(&rbd_dev->header_oid, GFP_KERNEL, "%s%s",
6067 spec->image_name, RBD_SUFFIX);
6069 ret = ceph_oid_aprintf(&rbd_dev->header_oid, GFP_KERNEL, "%s%s",
6070 RBD_HEADER_PREFIX, spec->image_id);
6075 static void rbd_dev_image_release(struct rbd_device *rbd_dev)
6077 rbd_dev_unprobe(rbd_dev);
6078 rbd_dev->image_format = 0;
6079 kfree(rbd_dev->spec->image_id);
6080 rbd_dev->spec->image_id = NULL;
6082 rbd_dev_destroy(rbd_dev);
6086 * Probe for the existence of the header object for the given rbd
6087 * device. If this image is the one being mapped (i.e., not a
6088 * parent), initiate a watch on its header object before using that
6089 * object to get detailed information about the rbd image.
6091 static int rbd_dev_image_probe(struct rbd_device *rbd_dev, int depth)
6096 * Get the id from the image id object. Unless there's an
6097 * error, rbd_dev->spec->image_id will be filled in with
6098 * a dynamically-allocated string, and rbd_dev->image_format
6099 * will be set to either 1 or 2.
6101 ret = rbd_dev_image_id(rbd_dev);
6105 ret = rbd_dev_header_name(rbd_dev);
6107 goto err_out_format;
6110 ret = rbd_register_watch(rbd_dev);
6113 pr_info("image %s/%s does not exist\n",
6114 rbd_dev->spec->pool_name,
6115 rbd_dev->spec->image_name);
6116 goto err_out_format;
6120 ret = rbd_dev_header_info(rbd_dev);
6125 * If this image is the one being mapped, we have pool name and
6126 * id, image name and id, and snap name - need to fill snap id.
6127 * Otherwise this is a parent image, identified by pool, image
6128 * and snap ids - need to fill in names for those ids.
6131 ret = rbd_spec_fill_snap_id(rbd_dev);
6133 ret = rbd_spec_fill_names(rbd_dev);
6136 pr_info("snap %s/%s@%s does not exist\n",
6137 rbd_dev->spec->pool_name,
6138 rbd_dev->spec->image_name,
6139 rbd_dev->spec->snap_name);
6143 if (rbd_dev->header.features & RBD_FEATURE_LAYERING) {
6144 ret = rbd_dev_v2_parent_info(rbd_dev);
6149 * Need to warn users if this image is the one being
6150 * mapped and has a parent.
6152 if (!depth && rbd_dev->parent_spec)
6154 "WARNING: kernel layering is EXPERIMENTAL!");
6157 ret = rbd_dev_probe_parent(rbd_dev, depth);
6161 dout("discovered format %u image, header name is %s\n",
6162 rbd_dev->image_format, rbd_dev->header_oid.name);
6166 rbd_dev_unprobe(rbd_dev);
6169 rbd_unregister_watch(rbd_dev);
6171 rbd_dev->image_format = 0;
6172 kfree(rbd_dev->spec->image_id);
6173 rbd_dev->spec->image_id = NULL;
6177 static ssize_t do_rbd_add(struct bus_type *bus,
6181 struct rbd_device *rbd_dev = NULL;
6182 struct ceph_options *ceph_opts = NULL;
6183 struct rbd_options *rbd_opts = NULL;
6184 struct rbd_spec *spec = NULL;
6185 struct rbd_client *rbdc;
6189 if (!try_module_get(THIS_MODULE))
6192 /* parse add command */
6193 rc = rbd_add_parse_args(buf, &ceph_opts, &rbd_opts, &spec);
6197 rbdc = rbd_get_client(ceph_opts);
6204 rc = rbd_add_get_pool_id(rbdc, spec->pool_name);
6207 pr_info("pool %s does not exist\n", spec->pool_name);
6208 goto err_out_client;
6210 spec->pool_id = (u64)rc;
6212 rbd_dev = rbd_dev_create(rbdc, spec, rbd_opts);
6215 goto err_out_client;
6217 rbdc = NULL; /* rbd_dev now owns this */
6218 spec = NULL; /* rbd_dev now owns this */
6219 rbd_opts = NULL; /* rbd_dev now owns this */
6221 rbd_dev->config_info = kstrdup(buf, GFP_KERNEL);
6222 if (!rbd_dev->config_info) {
6224 goto err_out_rbd_dev;
6227 down_write(&rbd_dev->header_rwsem);
6228 rc = rbd_dev_image_probe(rbd_dev, 0);
6230 up_write(&rbd_dev->header_rwsem);
6231 goto err_out_rbd_dev;
6234 /* If we are mapping a snapshot it must be marked read-only */
6236 read_only = rbd_dev->opts->read_only;
6237 if (rbd_dev->spec->snap_id != CEPH_NOSNAP)
6239 rbd_dev->mapping.read_only = read_only;
6241 rc = rbd_dev_device_setup(rbd_dev);
6244 * rbd_unregister_watch() can't be moved into
6245 * rbd_dev_image_release() without refactoring, see
6246 * commit 1f3ef78861ac.
6248 rbd_unregister_watch(rbd_dev);
6249 rbd_dev_image_release(rbd_dev);
6255 module_put(THIS_MODULE);
6259 rbd_dev_destroy(rbd_dev);
6261 rbd_put_client(rbdc);
6268 static ssize_t rbd_add(struct bus_type *bus,
6275 return do_rbd_add(bus, buf, count);
6278 static ssize_t rbd_add_single_major(struct bus_type *bus,
6282 return do_rbd_add(bus, buf, count);
6285 static void rbd_dev_device_release(struct rbd_device *rbd_dev)
6287 rbd_free_disk(rbd_dev);
6289 spin_lock(&rbd_dev_list_lock);
6290 list_del_init(&rbd_dev->node);
6291 spin_unlock(&rbd_dev_list_lock);
6293 clear_bit(RBD_DEV_FLAG_EXISTS, &rbd_dev->flags);
6294 device_del(&rbd_dev->dev);
6295 rbd_dev_mapping_clear(rbd_dev);
6297 unregister_blkdev(rbd_dev->major, rbd_dev->name);
6300 static void rbd_dev_remove_parent(struct rbd_device *rbd_dev)
6302 while (rbd_dev->parent) {
6303 struct rbd_device *first = rbd_dev;
6304 struct rbd_device *second = first->parent;
6305 struct rbd_device *third;
6308 * Follow to the parent with no grandparent and
6311 while (second && (third = second->parent)) {
6316 rbd_dev_image_release(second);
6317 first->parent = NULL;
6318 first->parent_overlap = 0;
6320 rbd_assert(first->parent_spec);
6321 rbd_spec_put(first->parent_spec);
6322 first->parent_spec = NULL;
6326 static ssize_t do_rbd_remove(struct bus_type *bus,
6330 struct rbd_device *rbd_dev = NULL;
6331 struct list_head *tmp;
6334 bool already = false;
6340 sscanf(buf, "%d %5s", &dev_id, opt_buf);
6342 pr_err("dev_id out of range\n");
6345 if (opt_buf[0] != '\0') {
6346 if (!strcmp(opt_buf, "force")) {
6349 pr_err("bad remove option at '%s'\n", opt_buf);
6355 spin_lock(&rbd_dev_list_lock);
6356 list_for_each(tmp, &rbd_dev_list) {
6357 rbd_dev = list_entry(tmp, struct rbd_device, node);
6358 if (rbd_dev->dev_id == dev_id) {
6364 spin_lock_irq(&rbd_dev->lock);
6365 if (rbd_dev->open_count && !force)
6368 already = test_and_set_bit(RBD_DEV_FLAG_REMOVING,
6370 spin_unlock_irq(&rbd_dev->lock);
6372 spin_unlock(&rbd_dev_list_lock);
6373 if (ret < 0 || already)
6378 * Prevent new IO from being queued and wait for existing
6379 * IO to complete/fail.
6381 blk_mq_freeze_queue(rbd_dev->disk->queue);
6382 blk_set_queue_dying(rbd_dev->disk->queue);
6385 down_write(&rbd_dev->lock_rwsem);
6386 if (__rbd_is_lock_owner(rbd_dev))
6387 rbd_unlock(rbd_dev);
6388 up_write(&rbd_dev->lock_rwsem);
6389 rbd_unregister_watch(rbd_dev);
6392 * Don't free anything from rbd_dev->disk until after all
6393 * notifies are completely processed. Otherwise
6394 * rbd_bus_del_dev() will race with rbd_watch_cb(), resulting
6395 * in a potential use after free of rbd_dev->disk or rbd_dev.
6397 rbd_dev_device_release(rbd_dev);
6398 rbd_dev_image_release(rbd_dev);
6403 static ssize_t rbd_remove(struct bus_type *bus,
6410 return do_rbd_remove(bus, buf, count);
6413 static ssize_t rbd_remove_single_major(struct bus_type *bus,
6417 return do_rbd_remove(bus, buf, count);
6421 * create control files in sysfs
6424 static int rbd_sysfs_init(void)
6428 ret = device_register(&rbd_root_dev);
6432 ret = bus_register(&rbd_bus_type);
6434 device_unregister(&rbd_root_dev);
6439 static void rbd_sysfs_cleanup(void)
6441 bus_unregister(&rbd_bus_type);
6442 device_unregister(&rbd_root_dev);
6445 static int rbd_slab_init(void)
6447 rbd_assert(!rbd_img_request_cache);
6448 rbd_img_request_cache = KMEM_CACHE(rbd_img_request, 0);
6449 if (!rbd_img_request_cache)
6452 rbd_assert(!rbd_obj_request_cache);
6453 rbd_obj_request_cache = KMEM_CACHE(rbd_obj_request, 0);
6454 if (!rbd_obj_request_cache)
6457 rbd_assert(!rbd_segment_name_cache);
6458 rbd_segment_name_cache = kmem_cache_create("rbd_segment_name",
6459 CEPH_MAX_OID_NAME_LEN + 1, 1, 0, NULL);
6460 if (rbd_segment_name_cache)
6463 kmem_cache_destroy(rbd_obj_request_cache);
6464 rbd_obj_request_cache = NULL;
6466 kmem_cache_destroy(rbd_img_request_cache);
6467 rbd_img_request_cache = NULL;
6472 static void rbd_slab_exit(void)
6474 rbd_assert(rbd_segment_name_cache);
6475 kmem_cache_destroy(rbd_segment_name_cache);
6476 rbd_segment_name_cache = NULL;
6478 rbd_assert(rbd_obj_request_cache);
6479 kmem_cache_destroy(rbd_obj_request_cache);
6480 rbd_obj_request_cache = NULL;
6482 rbd_assert(rbd_img_request_cache);
6483 kmem_cache_destroy(rbd_img_request_cache);
6484 rbd_img_request_cache = NULL;
6487 static int __init rbd_init(void)
6491 if (!libceph_compatible(NULL)) {
6492 rbd_warn(NULL, "libceph incompatibility (quitting)");
6496 rc = rbd_slab_init();
6501 * The number of active work items is limited by the number of
6502 * rbd devices * queue depth, so leave @max_active at default.
6504 rbd_wq = alloc_workqueue(RBD_DRV_NAME, WQ_MEM_RECLAIM, 0);
6511 rbd_major = register_blkdev(0, RBD_DRV_NAME);
6512 if (rbd_major < 0) {
6518 rc = rbd_sysfs_init();
6520 goto err_out_blkdev;
6523 pr_info("loaded (major %d)\n", rbd_major);
6525 pr_info("loaded\n");
6531 unregister_blkdev(rbd_major, RBD_DRV_NAME);
6533 destroy_workqueue(rbd_wq);
6539 static void __exit rbd_exit(void)
6541 ida_destroy(&rbd_dev_id_ida);
6542 rbd_sysfs_cleanup();
6544 unregister_blkdev(rbd_major, RBD_DRV_NAME);
6545 destroy_workqueue(rbd_wq);
6549 module_init(rbd_init);
6550 module_exit(rbd_exit);
6552 MODULE_AUTHOR("Alex Elder <elder@inktank.com>");
6553 MODULE_AUTHOR("Sage Weil <sage@newdream.net>");
6554 MODULE_AUTHOR("Yehuda Sadeh <yehuda@hq.newdream.net>");
6555 /* following authorship retained from original osdblk.c */
6556 MODULE_AUTHOR("Jeff Garzik <jeff@garzik.org>");
6558 MODULE_DESCRIPTION("RADOS Block Device (RBD) driver");
6559 MODULE_LICENSE("GPL");